Delen via

Device Registration State - Get

  • Referentie
Service:
IoT Hub Device Provisioning Service
API-versie:
2021-10-01

Hiermee haalt u de status van de apparaatregistratie op.

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

URI-parameters

Name In Vereist Type Description
id
 path True

string

Registratie-id.
api-version
 query True

string

De API-versie die moet worden gebruikt voor de aanvraag. Ondersteunde versies zijn onder andere: 2021-10-01

Antwoorden

Name Type Description
200 OK

DeviceRegistrationState

Geslaagd
Other Status Codes

ProvisioningServiceErrorDetails

Foutreactie

Kopteksten

x-ms-error-code: string

Definities

Name Description
DeviceRegistrationState

Apparaatregistratiestatus.
ProvisioningServiceErrorDetails

Bevat de eigenschappen van een fout die wordt geretourneerd door de Azure IoT Hub Provisioning Service.

DeviceRegistrationState

Apparaatregistratiestatus.

Name Type Description
assignedHub

string

Toegewezen Azure IoT Hub.
createdDateTimeUtc

string

De datum voor het maken van de registratie (in UTC).
deviceId

string

Apparaat-id.
errorCode

integer

Foutcode.
errorMessage

string

Foutbericht.
etag

string

De entiteitstag die is gekoppeld aan de resource.
lastUpdatedDateTimeUtc

string

Datum/tijd laatst bijgewerkt (in UTC).
payload

object

registrationId

string

Deze id wordt gebruikt om een apparaatregistratie van een inschrijving uniek te identificeren. Een hoofdlettergevoelige tekenreeks (maximaal 128 tekens lang) met alfanumerieke tekens plus bepaalde speciale tekens: . _ -. Er zijn geen speciale tekens toegestaan aan het begin of einde.
status enum:
  • assigned
  • assigning
  • disabled
  • failed
  • unassigned

Inschrijvingsstatus.
substatus enum:
  • deviceDataMigrated
  • deviceDataReset
  • initialAssignment
  • reprovisionedToInitialAssignment

Substatus voor toegewezen apparaten. Mogelijke waarden zijn ' initialAssignment': het apparaat is voor het eerst toegewezen aan een IoT-hub, 'deviceDataMigrated': het apparaat is toegewezen aan een andere IoT-hub en de apparaatgegevens zijn gemigreerd vanuit de eerder toegewezen IoT-hub. Apparaatgegevens zijn verwijderd uit de eerder toegewezen IoT-hub deviceDataReset: het apparaat is toegewezen aan een andere IoT-hub en de apparaatgegevens zijn ingevuld vanaf de initiële status die is opgeslagen in de inschrijving. Apparaatgegevens zijn verwijderd uit de eerder toegewezen IoT-hub, 'reprovisionedToInitialAssignment': het apparaat is opnieuw ingericht voor een eerder toegewezen IoT-hub.

ProvisioningServiceErrorDetails

Bevat de eigenschappen van een fout die wordt geretourneerd door de Azure IoT Hub Provisioning Service.

Name Type Description
errorCode

integer

info

object

message

string

timestampUtc

string

trackingId

string