TwinsClient.GetAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
GetAsync(String, CancellationToken) |
Obtient le jumeau d’un appareil à partir d’IoT Hub. |
GetAsync(String, String, CancellationToken) |
Obtient le jumeau d’un module à partir d’IoT Hub. |
GetAsync(String, CancellationToken)
Obtient le jumeau d’un appareil à partir d’IoT Hub.
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)
Paramètres
- deviceId
- String
ID de l’appareil.
- cancellationToken
- CancellationToken
Jeton d’annulation de tâche.
Retours
Jumeau d’appareil.
Exceptions
Lorsque le fourni deviceId
a la valeur Null.
Si est deviceId
vide ou espace blanc.
Si IoT Hub a répondu à la demande avec un code de status non réussi. Par exemple, si la requête fournie a été limitée, IotHubServiceException avec ThrottlingException est levée. Pour obtenir la liste complète des cas d’erreur possibles, consultez IotHubServiceErrorCode.
Si la requête HTTP échoue en raison d’un problème sous-jacent tel que la connectivité réseau, l’échec DNS ou la validation du certificat de serveur.
Si le fourni cancellationToken
a demandé l’annulation.
S’applique à
GetAsync(String, String, CancellationToken)
Obtient le jumeau d’un module à partir d’IoT Hub.
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)
Paramètres
- deviceId
- String
ID de l’appareil.
- moduleId
- String
ID de module.
- cancellationToken
- CancellationToken
Jeton d’annulation de tâche.
Retours
Jumeau de module.
Exceptions
Lorsque le fourni deviceId
ou moduleId
est null.
Si ou deviceId
moduleId
est vide ou espace blanc.
Si IoT Hub a répondu à la demande avec un code de status non réussi. Par exemple, si la requête fournie a été limitée, IotHubServiceException avec ThrottlingException est levée. Pour obtenir la liste complète des cas d’erreur possibles, consultez IotHubServiceErrorCode.
Si la requête HTTP échoue en raison d’un problème sous-jacent tel que la connectivité réseau, l’échec DNS ou la validation du certificat de serveur.
Si le fourni cancellationToken
a demandé l’annulation.
S’applique à
Azure SDK for .NET