DevicesClient.CreateAsync Método

Definição

Namespace:

Microsoft.Azure.Devices

Assembly:

Microsoft.Azure.Devices.dll

Pacote:

Microsoft.Azure.Devices v2.0.0-preview002

Sobrecargas

CreateAsync(Device, CancellationToken)	Crie uma identidade de dispositivo no registro do hub IoT.
CreateAsync(IEnumerable<Device>, CancellationToken)	Crie até 100 novas identidades de dispositivo no registro do hub IoT em massa.

CreateAsync(Device, CancellationToken)

Crie uma identidade de dispositivo no registro do 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)

Parâmetros

device

Device

A identidade do dispositivo a ser registrada.

cancellationToken

CancellationToken

O token que permite que a operação seja cancelada.

Retornos

Task<Device>

O dispositivo registrado com as chaves geradas e ETags.

Exceções

ArgumentNullException

Quando o dispositivo fornecido for nulo.

IotHubServiceException

Se o Hub IoT respondeu à solicitação com um código de status não bem-sucedido. Por exemplo, se a solicitação fornecida foi limitada, IotHubServiceException com ThrottlingException é lançada. Para obter uma lista completa de possíveis casos de erro, consulte IotHubServiceErrorCode.

HttpRequestException

Se a solicitação HTTP falhar devido a um problema subjacente, como conectividade de rede, falha de DNS ou validação de certificado do servidor.

OperationCanceledException

Se o token de cancelamento fornecido tiver solicitado o cancelamento.

CreateAsync(IEnumerable<Device>, CancellationToken)

Crie até 100 novas identidades de dispositivo no registro do hub IoT em massa.

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>

As identidades do dispositivo a serem criadas no registro do hub IoT. Pode não exceder 100 dispositivos.

cancellationToken

CancellationToken

O token que permite que a operação seja cancelada.

Retornos

Task<BulkRegistryOperationResult>

O resultado da operação em massa.

Exceções

ArgumentNullException

Quando a coleção de dispositivos fornecida for nula.

ArgumentException

Quando a coleção de dispositivos fornecida estiver vazia.

IotHubServiceException

Se o Hub IoT respondeu à solicitação com um código de status não bem-sucedido. Por exemplo, se a solicitação fornecida foi limitada, IotHubServiceException com ThrottlingException é lançada. Para obter uma lista completa de possíveis casos de erro, consulte IotHubServiceErrorCode.

HttpRequestException

Se a solicitação HTTP falhar devido a um problema subjacente, como conectividade de rede, falha de DNS ou validação de certificado do servidor.

OperationCanceledException

Se o token de cancelamento fornecido tiver solicitado o cancelamento.

Comentários

Para operações de maior escala, considere usar ImportAsync(ImportJobProperties, CancellationToken) o que permite importar dispositivos de um contêiner do Armazenamento do Azure.