TwinsClient.GetAsync Methode
Definition
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.
Ü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:
Azure SDK for .NET