DevicesClient.GetAsync(String, CancellationToken) Método

Referência

Definição

Namespace:: Microsoft.Azure.Devices

Assembly:: Microsoft.Azure.Devices.dll

Pacote:: Microsoft.Azure.Devices v2.0.0-preview002

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtenha uma identidade do dispositivo por sua ID.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device> GetAsync (string deviceId, System.Threading.CancellationToken cancellationToken = default);

abstract member GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>
override this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>

Public Overridable Function GetAsync (deviceId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Device)

Parâmetros

deviceId: String

O identificador exclusivo da identidade do dispositivo a ser recuperada.

cancellationToken: CancellationToken

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

Retornos

Task<Device>

A identidade do dispositivo recuperada.

Exceções

ArgumentNullException

Quando a ID do dispositivo fornecida é nula.

ArgumentException

Quando a ID do dispositivo fornecida estiver vazia ou espaço em branco.

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 é gerada. 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.

Aplica-se a

Compartilhar via