Partager via

DevicesClient.CreateAsync Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Azure.Devices
Assembly:
Microsoft.Azure.Devices.dll
Paquet:
Microsoft.Azure.Devices v2.0.0-preview002

Surcharges

CreateAsync(Device, CancellationToken)

Créez une identité d’appareil dans le registre de votre hub IoT.
CreateAsync(IEnumerable<Device>, CancellationToken)

Créez jusqu’à 100 nouvelles identités d’appareil dans le registre de votre hub IoT en bloc.

CreateAsync(Device, CancellationToken)

Créez une identité d’appareil dans le registre de votre hub IoT.

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

Paramètres

device
Device

Identité de l’appareil à inscrire.

cancellationToken
CancellationToken

Jeton qui permet l’annulation de l’opération.

Retours

Task<Device>

L’appareil inscrit avec les clés et les ETags générés.

Exceptions

ArgumentNullException

Lorsque l’appareil fourni est null.

IotHubServiceException

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.

HttpRequestException

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.

OperationCanceledException

Si le jeton d’annulation fourni a demandé l’annulation.

S’applique à

CreateAsync(IEnumerable<Device>, CancellationToken)

Créez jusqu’à 100 nouvelles identités d’appareil dans le registre de votre hub IoT en bloc.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult> CreateAsync (System.Collections.Generic.IEnumerable<Microsoft.Azure.Devices.Device> devices, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateAsync : seq<Microsoft.Azure.Devices.Device> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
override this.CreateAsync : seq<Microsoft.Azure.Devices.Device> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
Public Overridable Function CreateAsync (devices As IEnumerable(Of Device), Optional cancellationToken As CancellationToken = Nothing) As Task(Of BulkRegistryOperationResult)

Paramètres

devices
IEnumerable<Device>

Identités d’appareil à créer dans le registre de votre hub IoT. Ne peut pas dépasser 100 appareils.

cancellationToken
CancellationToken

Jeton qui permet l’annulation de l’opération.

Retours

Task<BulkRegistryOperationResult>

Résultat de l’opération en bloc.

Exceptions

ArgumentNullException

Lorsque la collection d’appareils fournie est null.

ArgumentException

Lorsque la collection d’appareils fournie est vide.

IotHubServiceException

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.

HttpRequestException

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.

OperationCanceledException

Si le jeton d’annulation fourni a demandé l’annulation.

Remarques

Pour les opérations à plus grande échelle, envisagez d’utiliser ImportAsync(ImportJobProperties, CancellationToken) ce qui vous permet d’importer des appareils à partir d’un conteneur stockage Azure.

S’applique à