TwinsClient.GetAsync Método
Definição
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.
Sobrecargas
GetAsync(String, CancellationToken) |
Obtém o gêmeo de um dispositivo do Hub IoT. |
GetAsync(String, String, CancellationToken) |
Obtém o gêmeo de um módulo do Hub IoT. |
GetAsync(String, CancellationToken)
Obtém o gêmeo de um dispositivo do Hub IoT.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin> GetAsync (string deviceId, System.Threading.CancellationToken cancellationToken = default);
abstract member GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
override this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
Public Overridable Function GetAsync (deviceId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ClientTwin)
Parâmetros
- deviceId
- String
A ID do dispositivo.
- cancellationToken
- CancellationToken
Token de cancelamento de tarefa.
Retornos
O dispositivo gêmeo.
Exceções
Quando o fornecido deviceId
for nulo.
Se o deviceId
estiver vazio ou espaço em branco.
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.
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.
Se o fornecido cancellationToken
tiver solicitado o cancelamento.
Aplica-se a
GetAsync(String, String, CancellationToken)
Obtém o gêmeo de um módulo do Hub IoT.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin> GetAsync (string deviceId, string moduleId, System.Threading.CancellationToken cancellationToken = default);
abstract member GetAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
override this.GetAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
Public Overridable Function GetAsync (deviceId As String, moduleId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ClientTwin)
Parâmetros
- deviceId
- String
A ID do dispositivo.
- moduleId
- String
A ID do módulo.
- cancellationToken
- CancellationToken
Token de cancelamento de tarefa.
Retornos
O módulo gêmeo.
Exceções
Quando o fornecido deviceId
ou moduleId
for nulo.
Se o deviceId
ou moduleId
estiver vazio ou espaço em branco.
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.
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.
Se o fornecido cancellationToken
tiver solicitado o cancelamento.
Aplica-se a
Azure SDK for .NET