ConfigurationsClient.SetAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Devices

Assembly:: Microsoft.Azure.Devices.dll

Paket:: Microsoft.Azure.Devices v2.0.0-preview002

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

ersetzen Sie die veränderlichen Felder der Konfigurationsregistrierung.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration> SetAsync (Microsoft.Azure.Devices.Configuration configuration, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

abstract member SetAsync : Microsoft.Azure.Devices.Configuration * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration>
override this.SetAsync : Microsoft.Azure.Devices.Configuration * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration>

Public Overridable Function SetAsync (configuration As Configuration, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Configuration)

Parameter

configuration: Configuration

Das Konfigurationsobjekt mit ersetzten Feldern.

onlyIfUnchanged: Boolean

Wenn false, wird dieser Vorgang ausgeführt, auch wenn die bereitgestellte Geräteidentität ein veraltetes ETag aufweist. Wenn true, löst der Vorgang ein mit PreconditionFailed ausIotHubServiceException, wenn die bereitgestellte Konfiguration über ein veraltetes ETag verfügt. Ein aktuelles ETag kann mit GetAsync(String, CancellationToken)abgerufen werden.

cancellationToken: CancellationToken

Das Token, mit dem der Vorgang abgebrochen werden kann.

Gibt zurück

Task<Configuration>

Das Konfigurationsobjekt mit ersetzten ETags.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn die angegebene configuration null ist.

IotHubServiceException

Wird ausgelöst, wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status-Code reagiert hat. Wenn beispielsweise die bereitgestellte Anforderung gedrosselt wurde, IotHubServiceException wird mit ThrottlingException ausgelöst. Eine vollständige Liste möglicher Fehlerfälle finden Sie unter IotHubServiceErrorCode.

HttpRequestException

Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung fehlschlägt.

OperationCanceledException

Wenn das bereitgestellte Abbruchtoken den Abbruch angefordert hat.

Gilt für:

Freigeben über