Runtime Registration - Operation Status Lookup

Tjänst:

IoT Hub Device Provisioning Service

API-version:

2021-10-01

Hämtar status för registreringsåtgärden.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
idScope	path	True	string
operationId	path	True	string	Åtgärds-ID.
registrationId	path	True	string	Registrerings-ID.
api-version	query	True	string	DEN API-version som ska användas för begäran. Versioner som stöds är: 2021-10-01

Svar

Name	Typ	Description
200 OK	RegistrationOperationStatus	Klart
202 Accepted	RegistrationOperationStatus	Har godkänts Sidhuvuden retry-after: integer Location: string
Other Status Codes	ProvisioningServiceErrorDetails	Felsvar Sidhuvuden x-ms-error-code: string

Definitioner

Name	Description
DeviceRegistrationResult	Resultat av enhetsregistrering.
ProvisioningServiceErrorDetails	Innehåller egenskaperna för ett fel som returneras av Azure IoT Hub Provisioning Service.
RegistrationOperationStatus	Status för registreringsåtgärd.
SymmetricKeyRegistrationResult	Registreringsresultatet returnerades när SymmetricKey-attestering används.
TpmRegistrationResult	TPM-registreringsresultat.
X509CertificateInfo	X509-certifikatinformation.
X509RegistrationResult	X509-registreringsresultat.

DeviceRegistrationResult

Resultat av enhetsregistrering.

Name	Typ	Description
assignedHub	string	Tilldelad Azure IoT Hub.
createdDateTimeUtc	string	Registrering skapa datumtid (i UTC).
deviceId	string	Enhets-ID.
errorCode	integer	Felkod.
errorMessage	string	Felmeddelande.
etag	string	Entitetstaggen som är associerad med resursen.
lastUpdatedDateTimeUtc	string	Senast uppdaterad datumtid (i UTC).
payload	object
registrationId	string	Det här ID:t används för att unikt identifiera en enhetsregistrering av en registrering. En skiftlägesokänslig sträng (upp till 128 tecken lång) med alfanumeriska tecken plus vissa specialtecken : . _ -. Inga specialtecken tillåts i början eller slutet.
status	enum: assigned assigning disabled failed unassigned	Registreringsstatus.
substatus	enum: deviceDataMigrated deviceDataReset initialAssignment reprovisionedToInitialAssignment	Understatus för tilldelade enheter. Möjliga värden är – "initialAssignment": Enheten har tilldelats till en IoT-hubb för första gången, "deviceDataMigrated": Enheten har tilldelats till en annan IoT-hubb och dess enhetsdata har migrerats från den tidigare tilldelade IoT-hubben. Enhetsdata togs bort från den tidigare tilldelade IoT-hubben deviceDataReset: Enheten har tilldelats till en annan IoT-hubb och dess enhetsdata fylldes i från det ursprungliga tillståndet som lagrades i registreringen. Enhetsdata togs bort från den tidigare tilldelade IoT-hubben , "reprovisionedToInitialAssignment": Enheten har återetablerats till en tidigare tilldelad IoT-hubb.
symmetricKey	SymmetricKeyRegistrationResult	Registreringsresultatet returnerades när SymmetricKey-attestering används.
tpm	TpmRegistrationResult	TPM-registreringsresultat.
x509	X509RegistrationResult	X509-registreringsresultat.

ProvisioningServiceErrorDetails

Innehåller egenskaperna för ett fel som returneras av Azure IoT Hub Provisioning Service.

Name	Typ	Description
errorCode	integer
info	object
message	string
timestampUtc	string
trackingId	string

RegistrationOperationStatus

Status för registreringsåtgärd.

Name	Typ	Description
operationId	string	Åtgärds-ID.
registrationState	DeviceRegistrationResult	Resultat av enhetsregistrering.
status	enum: assigned assigning disabled failed unassigned	Status för enhetsregistrering.

SymmetricKeyRegistrationResult

Registreringsresultatet returnerades när SymmetricKey-attestering används.

Name	Typ	Description
enrollmentGroupId	string

TpmRegistrationResult

TPM-registreringsresultat.

Name	Typ	Description
authenticationKey	string	Krypterad autentiseringsnyckel.

X509CertificateInfo

X509-certifikatinformation.

Name	Typ	Description
issuerName	string
notAfterUtc	string
notBeforeUtc	string
serialNumber	string
sha1Thumbprint	string
sha256Thumbprint	string
subjectName	string
version	integer

X509RegistrationResult

X509-registreringsresultat.

Name	Typ	Description
certificateInfo	X509CertificateInfo	X509-certifikatinformation.
enrollmentGroupId	string
signingCertificateInfo	X509CertificateInfo	X509-certifikatinformation.