ConfigurationsClient.ApplyConfigurationContentOnDeviceAsync 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.

Wendet Konfigurationsinhalte auf ein Edge-Gerät an.

public virtual System.Threading.Tasks.Task ApplyConfigurationContentOnDeviceAsync (string deviceId, Microsoft.Azure.Devices.ConfigurationContent content, System.Threading.CancellationToken cancellationToken = default);

abstract member ApplyConfigurationContentOnDeviceAsync : string * Microsoft.Azure.Devices.ConfigurationContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ApplyConfigurationContentOnDeviceAsync : string * Microsoft.Azure.Devices.ConfigurationContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function ApplyConfigurationContentOnDeviceAsync (deviceId As String, content As ConfigurationContent, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

deviceId: String

Die Geräte-ID.

content: ConfigurationContent

Die Konfiguration.

cancellationToken: CancellationToken

Das Token, mit dem der Vorgang abgebrochen werden kann.

Gibt zurück

Task

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn das angegebene deviceId oder content NULL ist.

ArgumentException

Wird ausgelöst, wenn leer deviceId oder leer ist.

IotHubServiceException

Wird ausgelöst, wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status-Code geantwortet 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 fehlschlägt, z. B. Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung.

OperationCanceledException

Wenn der bereitgestellte cancellationToken einen Abbruch angefordert hat.

Hinweise

ModulesContent ist erforderlich. DeviceContent ist optional. ModuleContent ist nicht zutreffend.

Gilt für:

Freigeben über