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 |
Erfolg |
|
Other Status Codes |
Fehlerantwort |
Definitionen
Name | Beschreibung |
---|---|
Device |
Geräteregistrierungsstatus. |
Provisioning |
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:
|
Registrierungs-status. |
substatus |
enum:
|
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 |