Device Registration State - Query
Obtém o estado de registro dos dispositivos neste grupo de registro.
POST https://your-dps.azure-devices-provisioning.net/registrations/{id}/query?api-version=2021-10-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
id
|
path | True |
string |
ID do grupo de inscrição. |
api-version
|
query | True |
string |
A versão da API a ser usada para a solicitação. As versões suportadas incluem: 2021-10-01 |
Cabeçalho do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
x-ms-max-item-count |
integer (int32) |
tamanho da página |
|
x-ms-continuation |
string |
token de continuação |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Sucesso Cabeçalhos
|
|
Other Status Codes |
Resposta de erro Cabeçalhos x-ms-error-code: string |
Definições
Name | Description |
---|---|
Device |
Estado de registo do dispositivo. |
Provisioning |
Contém as propriedades de um erro retornado pelo Serviço de Provisionamento do Hub IoT do Azure. |
DeviceRegistrationState
Estado de registo do dispositivo.
Name | Tipo | Description |
---|---|---|
assignedHub |
string |
Atribuído o Hub IoT do Azure. |
createdDateTimeUtc |
string (date-time) |
O registo cria data e hora (em UTC). |
deviceId |
string |
ID do dispositivo. |
errorCode |
integer (int32) |
Código de erro. |
errorMessage |
string |
Mensagem de erro. |
etag |
string |
A marca de entidade associada ao recurso. |
lastUpdatedDateTimeUtc |
string (date-time) |
Data da última atualização, hora (em UTC). |
payload |
object |
|
registrationId |
string |
Esse id é usado para identificar exclusivamente um registro de dispositivo de uma inscrição. Uma cadeia de caracteres que não diferencia maiúsculas de minúsculas (até 128 caracteres) de caracteres alfanuméricos mais certos caracteres especiais : . _ -. Não são permitidos caracteres especiais no início ou no fim. |
status |
enum:
|
Status da inscrição. |
substatus |
enum:
|
Substatus para dispositivos 'atribuídos'. Os valores possíveis incluem - 'initialAssignment': o dispositivo foi atribuído a um hub IoT pela primeira vez, 'deviceDataMigrated': o dispositivo foi atribuído a um hub IoT diferente e seus dados de dispositivo foram migrados do hub IoT atribuído anteriormente. Os dados do dispositivo foram removidos do hub IoT atribuído anteriormente, 'deviceDataReset': o dispositivo foi atribuído a um hub IoT diferente e seus dados de dispositivo foram preenchidos a partir do estado inicial armazenado no registro. Os dados do dispositivo foram removidos do hub IoT atribuído anteriormente, 'reprovisionedToInitialAssignment': o dispositivo foi reprovisionado para um hub IoT atribuído anteriormente. |
ProvisioningServiceErrorDetails
Contém as propriedades de um erro retornado pelo Serviço de Provisionamento do Hub IoT do Azure.
Name | Tipo | Description |
---|---|---|
errorCode |
integer (int32) |
|
info |
object |
|
message |
string |
|
timestampUtc |
string (date-time) |
|
trackingId |
string |