Device Registration State - Get

Ruft den Geräteregistrierungsstatus ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
id
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-06-01

Antworten

Name Typ Beschreibung
200 OK

DeviceRegistrationState

Erfolg

Other Status Codes

ProvisioningServiceErrorDetails

Fehlerantwort

Definitionen

Name Beschreibung
DeviceRegistrationState

Geräteregistrierungsstatus.

ProvisioningServiceErrorDetails

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

DeviceRegistrationState

Geräteregistrierungsstatus.

Name Typ Beschreibung
assignedHub

string

Zugewiesene Azure IoT Hub.

createdDateTimeUtc

string

Erstellungsdatum der Registrierung (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

Benutzerdefinierte Zuordnungsnutzlast, die vom Webhook an das Gerät zurückgegeben wird.

registrationId

string

Die Registrierungs-ID ist alphanumerisch und besteht aus Kleinbuchstaben und ggf. Bindestrichen.

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

Registrierungs-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 vom 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.

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