Partilhar via


Device Registration State - Get

Obtém o estado de registo do dispositivo.

GET https://your-dps.azure-devices-provisioning.net/registrations/{id}?api-version=2021-10-01

Parâmetros do URI

Name Em Necessário Tipo Description
id
path True

string

ID de registo.

api-version
query True

string

A versão da API a utilizar para o pedido. As versões suportadas incluem: 2021-10-01

Respostas

Name Tipo Description
200 OK

DeviceRegistrationState

Com êxito

Other Status Codes

ProvisioningServiceErrorDetails

Resposta a erros

Cabeçalhos

x-ms-error-code: string

Definições

Name Description
DeviceRegistrationState

Estado de registo do dispositivo.

ProvisioningServiceErrorDetails

Contém as propriedades de um erro devolvido pelo Serviço de Aprovisionamento de Hub IoT do Azure.

DeviceRegistrationState

Estado de registo do dispositivo.

Name Tipo Description
assignedHub

string

Hub IoT do Azure atribuído.

createdDateTimeUtc

string

Data de criação de registo (em UTC).

deviceId

string

ID do dispositivo.

errorCode

integer

Código de erro.

errorMessage

string

Mensagem de erro.

etag

string

A etiqueta de entidade associada ao recurso.

lastUpdatedDateTimeUtc

string

Hora da data da última atualização (em UTC).

payload

object

registrationId

string

Este ID é utilizado para identificar exclusivamente um registo de um dispositivo de uma inscrição. Uma cadeia não sensível a maiúsculas e minúsculas (até 128 carateres) de carateres alfanuméricos e determinados carateres especiais: . _ -. Não são permitidos carateres especiais no início ou no fim.

status enum:
  • assigned
  • assigning
  • disabled
  • failed
  • unassigned

Estado da inscrição.

substatus enum:
  • deviceDataMigrated
  • deviceDataReset
  • initialAssignment
  • reprovisionedToInitialAssignment

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 os dados do dispositivo foram migrados do hub IoT anteriormente atribuído. Os dados do dispositivo foram removidos do hub IoT anteriormente atribuído, "deviceDataReset": o dispositivo foi atribuído a um hub IoT diferente e os respetivos dados do dispositivo foram preenchidos a partir do estado inicial armazenado na inscrição. Os dados do dispositivo foram removidos do hub IoT anteriormente atribuído, "reprovisionedToInitialAssignment": O dispositivo foi aprovisionado novamente num hub IoT atribuído anteriormente.

ProvisioningServiceErrorDetails

Contém as propriedades de um erro devolvido pelo Serviço de Aprovisionamento de Hub IoT do Azure.

Name Tipo Description
errorCode

integer

info

object

message

string

timestampUtc

string

trackingId

string