DevicesClient.CreateWithTwinAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Devices

Ensamblado:

Microsoft.Azure.Devices.dll

Paquete:

Microsoft.Azure.Devices v2.0.0-preview002

Cree una identidad de dispositivo en el registro de IoT Hub con un estado de gemelo inicial.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult> CreateWithTwinAsync (Microsoft.Azure.Devices.Device device, Microsoft.Azure.Devices.ClientTwin twin, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateWithTwinAsync : Microsoft.Azure.Devices.Device * Microsoft.Azure.Devices.ClientTwin * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
override this.CreateWithTwinAsync : Microsoft.Azure.Devices.Device * Microsoft.Azure.Devices.ClientTwin * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>

Public Overridable Function CreateWithTwinAsync (device As Device, twin As ClientTwin, Optional cancellationToken As CancellationToken = Nothing) As Task(Of BulkRegistryOperationResult)

Parámetros

device

Device

Identidad del dispositivo que se va a registrar.

twin

ClientTwin

Estado inicial del gemelo para el dispositivo.

cancellationToken

CancellationToken

Token que permite cancelar la operación.

Devoluciones

Task<BulkRegistryOperationResult>

Resultado de la operación masiva.

Excepciones

ArgumentNullException

Cuando el dispositivo o gemelo proporcionados 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.

Comentarios

Esta API usa la misma API de servicio subyacente que las API bulk create/set/delete definidas en este cliente, como CreateAsync(IEnumerable<Device>, CancellationToken).