Freigeben über


Device Registration State - Get

Ruft den Geräteregistrierungsstatus ab.

GET https://your-dps.azure-devices-provisioning.net/registrations/{id}?api-version=2021-10-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-10-01

Antworten

Name Typ Beschreibung
200 OK

DeviceRegistrationState

Erfolg

Other Status Codes

ProvisioningServiceErrorDetails

Fehlerantwort

Header

x-ms-error-code: string

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

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.

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