DirectMethodsClient.InvokeAsync 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
InvokeAsync(String, DirectMethodServiceRequest, CancellationToken) |
Appelle une méthode sur un appareil. |
InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken) |
Appelle une méthode sur un module. |
InvokeAsync(String, DirectMethodServiceRequest, CancellationToken)
Appelle une méthode sur un appareil.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse> InvokeAsync (string deviceId, Microsoft.Azure.Devices.DirectMethodServiceRequest directMethodRequest, System.Threading.CancellationToken cancellationToken = default);
abstract member InvokeAsync : string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
override this.InvokeAsync : string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
Public Overridable Function InvokeAsync (deviceId As String, directMethodRequest As DirectMethodServiceRequest, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DirectMethodClientResponse)
Paramètres
- deviceId
- String
Identificateur de l’appareil cible.
- directMethodRequest
- DirectMethodServiceRequest
Paramètres pour exécuter une méthode directe sur l’appareil.
- cancellationToken
- CancellationToken
Jeton d’annulation pour annuler l’opération.
Retours
Réponse de la méthode directe.
Exceptions
Lorsque le fourni deviceId
ou directMethodRequest
est null.
Levée si est deviceId
vide ou espace blanc.
Levée 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 à
InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken)
Appelle une méthode sur un module.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse> InvokeAsync (string deviceId, string moduleId, Microsoft.Azure.Devices.DirectMethodServiceRequest directMethodRequest, System.Threading.CancellationToken cancellationToken = default);
abstract member InvokeAsync : string * string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
override this.InvokeAsync : string * string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
Public Overridable Function InvokeAsync (deviceId As String, moduleId As String, directMethodRequest As DirectMethodServiceRequest, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DirectMethodClientResponse)
Paramètres
- deviceId
- String
Identificateur de l’appareil cible.
- moduleId
- String
Identificateur du module cible.
- directMethodRequest
- DirectMethodServiceRequest
Paramètres pour exécuter une méthode directe sur le module.
- cancellationToken
- CancellationToken
Jeton d’annulation pour annuler l’opération.
Retours
Réponse de la méthode directe.
Exceptions
Lorsque le fourni deviceId
ou moduleId
ou directMethodRequest
est null.
Levée si ou deviceId
moduleId
est vide ou espace blanc.
Levée 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