DevicesClient.CreateAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Devices

Ensamblado:

Microsoft.Azure.Devices.dll

Paquete:

Microsoft.Azure.Devices v2.0.0-preview002

Sobrecargas

CreateAsync(Device, CancellationToken)	Cree una identidad de dispositivo en el registro de IoT Hub.
CreateAsync(IEnumerable<Device>, CancellationToken)	Cree hasta 100 identidades de dispositivo nuevas en el registro de IoT Hub de forma masiva.

CreateAsync(Device, CancellationToken)

Cree una identidad de dispositivo en el registro de IoT Hub.

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)

Parámetros

device

Device

Identidad del dispositivo que se va a registrar.

cancellationToken

CancellationToken

Token que permite cancelar la operación.

Devoluciones

Task<Device>

Dispositivo registrado con las claves generadas y ETags.

Excepciones

ArgumentNullException

Cuando el dispositivo proporcionado es null.

IotHubServiceException

Si IoT Hub respondió a la solicitud con un código de estado no correcto. Por ejemplo, si se ha limitado la solicitud proporcionada, IotHubServiceException se produce con ThrottlingException . Para obtener una lista completa de posibles casos de error, vea IotHubServiceErrorCode.

HttpRequestException

Si se produce un error en la solicitud HTTP debido a un problema subyacente, como la conectividad de red, el error dns o la validación del certificado de servidor.

OperationCanceledException

Si el token de cancelación proporcionado ha solicitado la cancelación.

CreateAsync(IEnumerable<Device>, CancellationToken)

Cree hasta 100 identidades de dispositivo nuevas en el registro de IoT Hub de forma masiva.

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)

Parámetros

devices

IEnumerable<Device>

Identidades de dispositivo que se van a crear en el registro de IoT Hub. Es posible que no supere los 100 dispositivos.

cancellationToken

CancellationToken

Token que permite cancelar la operación.

Devoluciones

Task<BulkRegistryOperationResult>

Resultado de la operación masiva.

Excepciones

ArgumentNullException

Cuando la colección de dispositivos proporcionada es null.

ArgumentException

Cuando la colección de dispositivos proporcionada está vacía.

IotHubServiceException

Si IoT Hub respondió a la solicitud con un código de estado no correcto. Por ejemplo, si se ha limitado la solicitud proporcionada, IotHubServiceException se produce con ThrottlingException . Para obtener una lista completa de posibles casos de error, vea IotHubServiceErrorCode.

HttpRequestException

Si se produce un error en la solicitud HTTP debido a un problema subyacente, como la conectividad de red, el error dns o la validación del certificado de servidor.

OperationCanceledException

Si el token de cancelación proporcionado ha solicitado la cancelación.

Comentarios

Para operaciones de mayor escala, considere la posibilidad de usar ImportAsync(ImportJobProperties, CancellationToken) , lo que le permite importar dispositivos desde un contenedor de Azure Storage.