Freigeben über

Runtime Registration - Device Registration Status Lookup

  • Referenz
Dienst:
IoT Hub Device Provisioning Service
API-Version:
2021-10-01

Ruft die Geräteregistrierung status ab.

POST https://global.azure-devices-provisioning.net/{idScope}/registrations/{registrationId}?api-version=2021-10-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
idScope
 path True

string

registrationId
 path True

string

Registrierungs-ID.
api-version
 query True

string

API-Version, die für die Anforderung verwendet werden soll. Unterstützte Versionen sind: 2021-10-01

Anforderungstext

Name Typ Beschreibung
payload

object

registrationId

string

Bei der Registrierungs-ID handelt es sich um eine Zeichenfolge mit alphanumerischen Zeichen und bestimmten Sonderzeichen (bis zu 128 Zeichen lang) ohne Beachtung der Groß-/Kleinschreibung: . _ -. Am Anfang oder Ende sind keine Sonderzeichen zulässig.
tpm

TpmAttestation

Nachweis über TPM.

Antworten

Name Typ Beschreibung
200 OK

DeviceRegistrationResult

Erfolg
Other Status Codes

ProvisioningServiceErrorDetails

Fehlerantwort

Header

x-ms-error-code: string

Definitionen

Name Beschreibung
DeviceRegistration

Geräteregistrierung.
DeviceRegistrationResult

Ergebnis der Geräteregistrierung.
ProvisioningServiceErrorDetails

Enthält die Eigenschaften eines Fehlers, der vom Azure IoT Hub Provisioning Service zurückgegeben wird.
SymmetricKeyRegistrationResult

Das Registrierungsergebnis wird zurückgegeben, wenn der SymmetricKey-Nachweis verwendet wird.
TpmAttestation

Nachweis über TPM.
TpmRegistrationResult

TPM-Registrierungsergebnis.
X509CertificateInfo

X509-Zertifikatinformationen.
X509RegistrationResult

X509-Registrierungsergebnis.

DeviceRegistration

Geräteregistrierung.

Name Typ Beschreibung
payload

object

registrationId

string

Bei der Registrierungs-ID handelt es sich um eine Zeichenfolge mit alphanumerischen Zeichen und bestimmten Sonderzeichen (bis zu 128 Zeichen lang) ohne Beachtung der Groß-/Kleinschreibung: . _ -. Am Anfang oder Ende sind keine Sonderzeichen zulässig.
tpm

TpmAttestation

Nachweis über TPM.

DeviceRegistrationResult

Ergebnis der Geräteregistrierung.

Name Typ Beschreibung
assignedHub

string

Zugewiesene Azure IoT Hub.
createdDateTimeUtc

string

Anmeldedatum erstellen (in UTC).
deviceId

string

Geräte-ID.
errorCode

integer

Fehlercode
errorMessage

string

Fehlermeldung.
etag

string

Das Entitätstag, das der Ressource zugeordnet ist.
lastUpdatedDateTimeUtc

string

Datum der letzten Aktualisierung (in UTC).
payload

object

registrationId

string

Diese ID wird verwendet, um eine Geräteregistrierung einer Registrierung eindeutig zu identifizieren. Eine Zeichenfolge ohne Beachtung der Groß-/Kleinschreibung (bis zu 128 Zeichen lang) mit alphanumerischen Zeichen und bestimmten Sonderzeichen: . _ -. Am Anfang oder Ende sind keine Sonderzeichen zulässig.
status enum:
  • assigned
  • assigning
  • disabled
  • failed
  • unassigned

Registrierung status.
substatus enum:
  • deviceDataMigrated
  • deviceDataReset
  • initialAssignment
  • reprovisionedToInitialAssignment

Unterstatus für "zugewiesene" Geräte. Mögliche Werte sind " initialAssignment": Das Gerät wurde zum ersten Mal einem IoT-Hub zugewiesen, "deviceDataMigrated": Das Gerät wurde einem anderen IoT Hub zugewiesen, und seine Gerätedaten wurden aus dem zuvor zugewiesenen IoT Hub migriert. Gerätedaten wurden aus dem zuvor zugewiesenen IoT Hub "deviceDataReset" entfernt: Das Gerät wurde einem anderen IoT Hub zugewiesen, und die Gerätedaten wurden aus dem ursprünglichen Zustand aufgefüllt, der in der Registrierung gespeichert wurde. Gerätedaten wurden aus dem zuvor zugewiesenen IoT Hub "reprovisionedToInitialAssignment" entfernt: Das Gerät wurde für einen zuvor zugewiesenen IoT Hub erneut bereitgestellt.
symmetricKey

SymmetricKeyRegistrationResult

Das Registrierungsergebnis wird zurückgegeben, wenn der SymmetricKey-Nachweis verwendet wird.
tpm

TpmRegistrationResult

TPM-Registrierungsergebnis.
x509

X509RegistrationResult

X509-Registrierungsergebnis.

ProvisioningServiceErrorDetails

Enthält die Eigenschaften eines Fehlers, der vom Azure IoT Hub Provisioning Service zurückgegeben wird.

Name Typ Beschreibung
errorCode

integer

info

object

message

string

timestampUtc

string

trackingId

string

SymmetricKeyRegistrationResult

Das Registrierungsergebnis wird zurückgegeben, wenn der SymmetricKey-Nachweis verwendet wird.

Name Typ Beschreibung
enrollmentGroupId

string

TpmAttestation

Nachweis über TPM.

Name Typ Beschreibung
endorsementKey

string

storageRootKey

string

TpmRegistrationResult

TPM-Registrierungsergebnis.

Name Typ Beschreibung
authenticationKey

string

Verschlüsselter Authentifizierungsschlüssel.

X509CertificateInfo

X509-Zertifikatinformationen.

Name Typ Beschreibung
issuerName

string

notAfterUtc

string

notBeforeUtc

string

serialNumber

string

sha1Thumbprint

string

sha256Thumbprint

string

subjectName

string

version

integer

X509RegistrationResult

X509-Registrierungsergebnis.

Name Typ Beschreibung
certificateInfo

X509CertificateInfo

X509-Zertifikatinformationen.
enrollmentGroupId

string

signingCertificateInfo

X509CertificateInfo

X509-Zertifikatinformationen.