Compartir a través de

Device Registration State - Get

  • Referencia
Servicio:
IoT Hub Device Provisioning Service
Versión de la API:
2021-10-01

Obtiene el estado de registro del dispositivo.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
id
 path True

string

Id. de registro.
api-version
 query True

string

La versión de API que se usará para la solicitud. Las versiones admitidas incluyen: 2021-10-01

Respuestas

Nombre Tipo Description
200 OK

DeviceRegistrationState

Correcto
Other Status Codes

ProvisioningServiceErrorDetails

Respuesta de error

Encabezados

x-ms-error-code: string

Definiciones

Nombre Description
DeviceRegistrationState

Estado de registro del dispositivo.
ProvisioningServiceErrorDetails

Contiene las propiedades de un error devuelto por el servicio de aprovisionamiento de Azure IoT Hub.

DeviceRegistrationState

Estado de registro del dispositivo.

Nombre Tipo Description
assignedHub

string

Azure IoT Hub asignados.
createdDateTimeUtc

string

Fecha y hora de creación del registro (en UTC).
deviceId

string

Id. de dispositivo.
errorCode

integer

Código de error.
errorMessage

string

Mensaje de error.
etag

string

Etiqueta de entidad asociada al recurso.
lastUpdatedDateTimeUtc

string

Hora de fecha y hora de la última actualización (en UTC).
payload

object

registrationId

string

Este identificador se usa para identificar de forma única un registro de dispositivo de una inscripción. Cadena sin distinción entre mayúsculas y minúsculas (hasta 128 caracteres de longitud) de caracteres alfanuméricos más determinados caracteres especiales: . _ -. No se permiten caracteres especiales al principio o al final.
status enum:
  • assigned
  • assigning
  • disabled
  • failed
  • unassigned

Estado de inscripción.
substatus enum:
  • deviceDataMigrated
  • deviceDataReset
  • initialAssignment
  • reprovisionedToInitialAssignment

Subestado para dispositivos "Asignados". Entre los valores posibles se incluyen : "initialAssignment": el dispositivo se ha asignado a un centro de IoT por primera vez, "deviceDataMigrated": el dispositivo se ha asignado a un centro de IoT diferente y sus datos de dispositivo se migraron desde el centro de IoT asignado anteriormente. Los datos del dispositivo se quitaron del centro de IoT asignado anteriormente, "deviceDataReset": el dispositivo se ha asignado a un centro de IoT diferente y sus datos de dispositivo se rellenaron a partir del estado inicial almacenado en la inscripción. Los datos del dispositivo se quitaron del centro de IoT asignado anteriormente, "reprovisionedToInitialAssignment": el dispositivo se ha vuelto a aprovisionar en un centro de IoT asignado previamente.

ProvisioningServiceErrorDetails

Contiene las propiedades de un error devuelto por el servicio de aprovisionamiento de Azure IoT Hub.

Nombre Tipo Description
errorCode

integer

info

object

message

string

timestampUtc

string

trackingId

string