Freigeben über


TwinsClient.GetAsync Methode

Definition

Überlädt

GetAsync(String, CancellationToken)

Ruft den Zwilling eines Geräts von IoT Hub ab.

GetAsync(String, String, CancellationToken)

Ruft den Zwilling eines Moduls aus IoT Hub ab.

GetAsync(String, CancellationToken)

Ruft den Zwilling eines Geräts von IoT Hub ab.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin> GetAsync (string deviceId, System.Threading.CancellationToken cancellationToken = default);
abstract member GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
override this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
Public Overridable Function GetAsync (deviceId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ClientTwin)

Parameter

deviceId
String

Die Geräte-ID.

cancellationToken
CancellationToken

Vorgangsabbruchtoken.

Gibt zurück

Der Gerätezwille.

Ausnahmen

Wenn das bereitgestellte deviceId null ist.

Wenn leer deviceId oder leer ist.

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.

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

Wenn die bereitgestellte cancellationToken kündigung angefordert hat.

Gilt für:

GetAsync(String, String, CancellationToken)

Ruft den Zwilling eines Moduls aus IoT Hub ab.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin> GetAsync (string deviceId, string moduleId, System.Threading.CancellationToken cancellationToken = default);
abstract member GetAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
override this.GetAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
Public Overridable Function GetAsync (deviceId As String, moduleId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ClientTwin)

Parameter

deviceId
String

Die Geräte-ID.

moduleId
String

Die Modul-ID.

cancellationToken
CancellationToken

Vorgangsabbruchtoken.

Gibt zurück

Der Modulzwille.

Ausnahmen

Wenn das bereitgestellte deviceId oder moduleId null ist.

Wenn der deviceId oder moduleId leer oder ist.

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.

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

Wenn die bereitgestellte cancellationToken kündigung angefordert hat.

Gilt für: