Runtime Registration - Device Registration Status Lookup
Obtiene el estado de registro del dispositivo.
POST https://global.azure-devices-provisioning.net/{idScope}/registrations/{registrationId}?api-version=2026-11-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
id
|
path | True |
string |
El alcance de la instancia DPS. |
|
registration
|
path | True |
string |
Id. de registro. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| csr |
string |
Una solicitud de firma de certificados DER (CSR) codificada en Base64 en formato PKCS #10, excluyendo cabeceras y pies de página PEM. El Nombre Común (CN) debe coincidir con el IDregistro del dispositivo. Incluir este campo en la operación RuntimeRegistration_DeviceRegistrationStatusLookup resultará en una mala solicitud. |
| payload |
Cualquier objeto |
|
| registrationId |
string |
El ID de registro es una cadena insensible a mayúsculas minúsculas (de hasta 128 caracteres) de caracteres alfanuméricos más ciertos caracteres especiales : . _ -. No se permiten personajes especiales ni al principio ni al final. |
| tpm |
Atestación mediante TPM. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La solicitud se ha realizado correctamente. |
|
| Other Status Codes |
Una respuesta de error inesperada. Encabezados x-ms-error-code: string |
Ejemplos
|
Runtime |
|
Runtime |
RuntimeRegistration_DeviceRegistrationStatusLookup_MaximumSet_Gen
Solicitud de ejemplo
POST https://global.azure-devices-provisioning.net/a/registrations/urnfaaodcvbbllnmxj?api-version=2026-11-01
{
"payload": {},
"registrationId": "qypnuerjeunzogqdezhjgisfr",
"tpm": {
"endorsementKey": "sbvvzftylrpsetexcmnijtdezppq",
"storageRootKey": "juohyrayid"
}
}
Respuesta de muestra
{
"assignedHub": "ljexps",
"createdDateTimeUtc": "2025-10-01T17:41:56.535Z",
"deviceId": "hjvdlwpugzlk",
"errorCode": 13,
"errorMessage": "zpctqazbkbiqjkwosis",
"etag": "hjtelksspyfzhmet",
"issuedCertificateChain": [
"MIIBkTCB+wIBADAZMRcwFQYDVQQDDA5leGFtcGxlLWRldmljZTCBnzANBgkqhkiG9w0BAQEFAAOBjQAw"
],
"lastUpdatedDateTimeUtc": "2025-10-01T17:41:56.535Z",
"payload": {},
"registrationId": "urejrffpkqneou",
"status": "unassigned",
"substatus": "initialAssignment",
"symmetricKey": {
"enrollmentGroupId": "w"
},
"tpm": {
"authenticationKey": "sofbxakhjrxpiyysjjxkx"
},
"x509": {
"certificateInfo": {
"issuerName": "pvpbipnhcahytrcq",
"notAfterUtc": "2025-10-01T17:41:56.534Z",
"notBeforeUtc": "2025-10-01T17:41:56.534Z",
"serialNumber": "jjvdijgwgpagrjdi",
"sha1Thumbprint": "guqltcfgusf",
"sha256Thumbprint": "ysryarleygpkejrjlwuxacvcwbxqw",
"subjectName": "jtsfqnbcmmott",
"version": 20
},
"enrollmentGroupId": "qbw",
"signingCertificateInfo": {
"issuerName": "pvpbipnhcahytrcq",
"notAfterUtc": "2025-10-01T17:41:56.534Z",
"notBeforeUtc": "2025-10-01T17:41:56.534Z",
"serialNumber": "jjvdijgwgpagrjdi",
"sha1Thumbprint": "guqltcfgusf",
"sha256Thumbprint": "ysryarleygpkejrjlwuxacvcwbxqw",
"subjectName": "jtsfqnbcmmott",
"version": 20
}
}
}
RuntimeRegistration_DeviceRegistrationStatusLookup_MinimumSet_Gen
Solicitud de ejemplo
POST https://global.azure-devices-provisioning.net/mucolayhjusj/registrations/okxnmx?api-version=2026-11-01
{}
Respuesta de muestra
{}
Definiciones
| Nombre | Description |
|---|---|
|
Assigned |
Subestado para dispositivos 'Asignados'. Los valores posibles incluyen: 'initialAssignment': El dispositivo ha sido asignado por primera vez a un hub IoT, 'deviceDataMigrated': El dispositivo ha sido asignado a otro hub IoT y los datos de su dispositivo se han migrado desde el hub IoT previamente asignado. Los datos de los dispositivos fueron eliminados del hub IoT previamente asignado, 'deviceDataReset': El dispositivo ha sido asignado a otro hub IoT y sus datos de dispositivos se llenaron desde el estado inicial almacenado en la inscripción. Los datos del dispositivo fueron eliminados del hub IoT previamente asignado, 'reprovisionadoToInitialAssignment': El dispositivo ha sido reaprovisionado en un hub IoT previamente asignado. |
|
Device |
Registro de dispositivos. |
|
Device |
Resultado del registro del dispositivo. |
|
Enrollment |
Estado de matrícula. |
|
Provisioning |
Contiene las propiedades de un error devuelto por el Azure IoT Hub Provisioning Service. |
|
Symmetric |
Resultado de registro devuelto al usar la atestación SymmetricKey. |
|
Tpm |
Atestación mediante TPM. |
|
Tpm |
Resultado del registro de TPM. |
|
X509Certificate |
Información del certificado X509. |
|
X509Registration |
Resultado del registro X509. |
AssignedDeviceSubstatus
Subestado para dispositivos 'Asignados'. Los valores posibles incluyen: 'initialAssignment': El dispositivo ha sido asignado por primera vez a un hub IoT, 'deviceDataMigrated': El dispositivo ha sido asignado a otro hub IoT y los datos de su dispositivo se han migrado desde el hub IoT previamente asignado. Los datos de los dispositivos fueron eliminados del hub IoT previamente asignado, 'deviceDataReset': El dispositivo ha sido asignado a otro hub IoT y sus datos de dispositivos se llenaron desde el estado inicial almacenado en la inscripción. Los datos del dispositivo fueron eliminados del hub IoT previamente asignado, 'reprovisionadoToInitialAssignment': El dispositivo ha sido reaprovisionado en un hub IoT previamente asignado.
| Valor | Description |
|---|---|
| initialAssignment |
inicialAsignación |
| deviceDataMigrated |
deviceDataMigrado |
| deviceDataReset |
deviceDataReset |
| reprovisionedToInitialAssignment |
reprovisionadoToInicialAsignación |
DeviceRegistration
Registro de dispositivos.
| Nombre | Tipo | Description |
|---|---|---|
| csr |
string |
Una solicitud de firma de certificados DER (CSR) codificada en Base64 en formato PKCS #10, excluyendo cabeceras y pies de página PEM. El Nombre Común (CN) debe coincidir con el IDregistro del dispositivo. Incluir este campo en la operación RuntimeRegistration_DeviceRegistrationStatusLookup resultará en una mala solicitud. |
| payload |
Cualquier objeto |
|
| registrationId |
string |
El ID de registro es una cadena insensible a mayúsculas minúsculas (de hasta 128 caracteres) de caracteres alfanuméricos más ciertos caracteres especiales : . _ -. No se permiten personajes especiales ni al principio ni al final. |
| tpm |
Atestación mediante TPM. |
DeviceRegistrationResult
Resultado del registro del dispositivo.
| Nombre | Tipo | Description |
|---|---|---|
| assignedHub |
string |
Asignado Azure IoT Hub. |
| createdDateTimeUtc |
string (date-time) |
Registro crea fecha y hora (en UTC). |
| deviceId |
string |
Id. de dispositivo. |
| errorCode |
integer (int32) |
Código de error. |
| errorMessage |
string |
Mensaje de error. |
| etag |
string |
La etiqueta de entidad asociada al recurso. |
| issuedCertificateChain |
string[] (byte) |
Un array que contiene la cadena completa de certificados del certificado emitido. El primer elemento es el certificado de hoja emitido, seguido por cualquier autoridad de certificación intermedia (ICA), y terminando con la autoridad de certificación raíz (CA). Cada certificado en el array es el emisor del certificado anterior. Esta propiedad no se incluye en las respuestas para la operación RuntimeRegistration_DeviceRegistrationStatusLookup. |
| lastUpdatedDateTimeUtc |
string (date-time) |
Última fecha de actualización y hora (en UTC). |
| payload |
Cualquier objeto |
|
| registrationId |
string |
Este id se utiliza para identificar de forma única el registro de un dispositivo en una inscripción. Una cadena insensible a mayúsculas minúsculas (de hasta 128 caracteres) de caracteres alfanuméricos más ciertos caracteres especiales : . _ -. No se permiten personajes especiales ni al principio ni al final. |
| status |
Estado de matrícula. |
|
| substatus |
Subestado para dispositivos 'Asignados'. Los valores posibles incluyen: 'initialAssignment': El dispositivo ha sido asignado por primera vez a un hub IoT, 'deviceDataMigrated': El dispositivo ha sido asignado a otro hub IoT y los datos de su dispositivo se han migrado desde el hub IoT previamente asignado. Los datos de los dispositivos fueron eliminados del hub IoT previamente asignado, 'deviceDataReset': El dispositivo ha sido asignado a otro hub IoT y sus datos de dispositivos se llenaron desde el estado inicial almacenado en la inscripción. Los datos del dispositivo fueron eliminados del hub IoT previamente asignado, 'reprovisionadoToInitialAssignment': El dispositivo ha sido reaprovisionado en un hub IoT previamente asignado. |
|
| symmetricKey |
Resultado de registro devuelto al usar la atestación SymmetricKey. |
|
| tpm |
Resultado del registro de TPM. |
|
| x509 |
Resultado del registro X509. |
EnrollmentStatus
Estado de matrícula.
| Valor | Description |
|---|---|
| unassigned |
unassigned |
| assigning |
Asignación |
| assigned |
asignado |
| failed |
fallido |
| disabled |
disabled |
ProvisioningServiceErrorDetails
Contiene las propiedades de un error devuelto por el Azure IoT Hub Provisioning Service.
| Nombre | Tipo | Description |
|---|---|---|
| errorCode |
integer (int32) |
Código numérico de error. |
| info |
object |
Diccionario de <cadenas> |
| message |
string |
Mensaje de error. |
| timestampUtc |
string (date-time) |
Marca de tiempo de error (UTC). |
| trackingId |
string |
ID de seguimiento de errores. |
SymmetricKeyRegistrationResult
Resultado de registro devuelto al usar la atestación SymmetricKey.
| Nombre | Tipo | Description |
|---|---|---|
| enrollmentGroupId |
string |
Identificador del grupo de inscripción. |
TpmAttestation
Atestación mediante TPM.
| Nombre | Tipo | Description |
|---|---|---|
| endorsementKey |
string |
Clave de respaldo de TPM. |
| storageRootKey |
string |
Clave raíz de almacenamiento TPM. |
TpmRegistrationResult
Resultado del registro de TPM.
| Nombre | Tipo | Description |
|---|---|---|
| authenticationKey |
string |
Clave de autenticación cifrada. |
X509CertificateInfo
Información del certificado X509.
| Nombre | Tipo | Description |
|---|---|---|
| issuerName |
string |
Nombre del emisor del certificado. |
| notAfterUtc |
string (date-time) |
Fecha de caducidad del certificado (UTC). |
| notBeforeUtc |
string (date-time) |
Fecha de inicio de la validez del certificado (UTC). |
| serialNumber |
string |
Número de serie del certificado. |
| sha1Thumbprint |
string |
Huella digital SHA-1 del certificado. |
| sha256Thumbprint |
string |
Huella digital SHA-256 del certificado. |
| subjectName |
string |
Nombre del sujeto del certificado. |
| version |
integer (int32) |
Versión del certificado. |
X509RegistrationResult
Resultado del registro X509.
| Nombre | Tipo | Description |
|---|---|---|
| certificateInfo |
Información del certificado X509. |
|
| enrollmentGroupId |
string |
Identificador del grupo de inscripción. |
| signingCertificateInfo |
Información del certificado X509. |