DevicesClient.SetAsync 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
SetAsync(Device, Boolean, CancellationToken) |
Remplacez l’état d’une identité d’appareil par l’état de l’identité d’appareil fournie. |
SetAsync(IEnumerable<Device>, Boolean, CancellationToken) |
Mettez à jour jusqu’à 100 identités d’appareil dans le registre de votre hub IoT en bloc. |
SetAsync(Device, Boolean, CancellationToken)
Remplacez l’état d’une identité d’appareil par l’état de l’identité d’appareil fournie.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device> SetAsync (Microsoft.Azure.Devices.Device device, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);
abstract member SetAsync : Microsoft.Azure.Devices.Device * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>
override this.SetAsync : Microsoft.Azure.Devices.Device * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>
Public Overridable Function SetAsync (device As Device, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Device)
Paramètres
- device
- Device
Nouvel état de l’identité de l’appareil.
- onlyIfUnchanged
- Boolean
Si la valeur est false, cette opération de mise à jour est effectuée même si l’identité de l’appareil fournie a un ETag obsolète. Si la valeur est true, l’opération lève un IotHubServiceException avec PreconditionFailed si l’identité de l’appareil fournie a un ETag obsolète. Un ETag à jour peut être récupéré à l’aide GetAsync(String, CancellationToken)de .
- cancellationToken
- CancellationToken
Jeton qui permet l’annulation de l’opération.
Retours
Identité de l’appareil récemment mise à jour, y compris son nouvel ETag.
Exceptions
Lorsque l’appareil fourni est null.
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 jeton d’annulation fourni a demandé l’annulation.
S’applique à
SetAsync(IEnumerable<Device>, Boolean, CancellationToken)
Mettez à jour jusqu’à 100 identités d’appareil dans le registre de votre hub IoT en bloc.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult> SetAsync (System.Collections.Generic.IEnumerable<Microsoft.Azure.Devices.Device> devices, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);
abstract member SetAsync : seq<Microsoft.Azure.Devices.Device> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
override this.SetAsync : seq<Microsoft.Azure.Devices.Device> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
Public Overridable Function SetAsync (devices As IEnumerable(Of Device), Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of BulkRegistryOperationResult)
Paramètres
- devices
- IEnumerable<Device>
Identités d’appareil à mettre à jour vers le registre de votre hub IoT. Ne peut pas dépasser 100 appareils.
- onlyIfUnchanged
- Boolean
Si la valeur est false, cette opération de mise à jour est effectuée même si l’identité de l’appareil fournie a un ETag obsolète. Si la valeur est true, l’opération lève un IotHubServiceException avec PreconditionFailed si l’identité de l’appareil fournie a un ETag obsolète. Un ETag à jour peut être récupéré à l’aide GetAsync(String, CancellationToken)de .
- cancellationToken
- CancellationToken
Jeton qui permet l’annulation de l’opération.
Retours
Résultat de l’opération en bloc.
Exceptions
Lorsque la collection d’appareils fournie est null.
Lorsque la collection d’appareils fournie est vide.
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 jeton d’annulation fourni a demandé l’annulation.
S’applique à
Azure SDK for .NET