Runtime Registration - Operation Status Lookup

Service:

IoT Hub Device Provisioning Service

API Version:

2021-06-01

Gets the registration operation status.

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

URI Parameters

Name	In	Required	Type	Description
idScope	path	True	string
operationId	path	True	string	Operation ID.
registrationId	path	True	string	Registration ID.
api-version	query	True	string	The API version to use for the request. Supported versions include: 2021-06-01

Responses

Name	Type	Description
200 OK	RegistrationOperationStatus	Success
202 Accepted	RegistrationOperationStatus	Success Headers retry-after: integer Location: string
Other Status Codes	ProvisioningServiceErrorDetails	Error response

Definitions

DeviceRegistrationResult	Device registration result.
ProvisioningServiceErrorDetails	Contains the properties of an error returned by the Azure IoT Hub Provisioning Service.
RegistrationOperationStatus	Registration operation status.
SymmetricKeyRegistrationResult	Registration result returned when using SymmetricKey attestation.
TpmRegistrationResult	TPM registration result.
X509CertificateInfo	X509 certificate info.
X509RegistrationResult	X509 registration result.

DeviceRegistrationResult

Device registration result.

Name	Type	Description
assignedHub	string	Assigned Azure IoT Hub.
createdDateTimeUtc	string	Registration create date time (in UTC).
deviceId	string	Device ID.
errorCode	integer	Error code.
errorMessage	string	Error message.
etag	string	The entity tag associated with the resource.
lastUpdatedDateTimeUtc	string	Last updated date time (in UTC).
payload	object	Custom allocation payload returned from the webhook to the device.
registrationId	string	The registration ID is alphanumeric, lowercase, and may contain hyphens.
status	enum: assigned assigning disabled failed unassigned	Enrollment status.
substatus	enum: deviceDataMigrated deviceDataReset initialAssignment reprovisionedToInitialAssignment	Substatus for 'Assigned' devices. Possible values include - 'initialAssignment': Device has been assigned to an IoT hub for the first time, 'deviceDataMigrated': Device has been assigned to a different IoT hub and its device data was migrated from the previously assigned IoT hub. Device data was removed from the previously assigned IoT hub, 'deviceDataReset': Device has been assigned to a different IoT hub and its device data was populated from the initial state stored in the enrollment. Device data was removed from the previously assigned IoT hub, 'reprovisionedToInitialAssignment': Device has been re-provisioned to a previously assigned IoT hub.
symmetricKey	SymmetricKeyRegistrationResult	Registration result returned when using SymmetricKey attestation.
tpm	TpmRegistrationResult	Registration result returned when using TPM attestation.
x509	X509RegistrationResult	Registration result returned when using X509 attestation.

ProvisioningServiceErrorDetails

Contains the properties of an error returned by the Azure IoT Hub Provisioning Service.

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

RegistrationOperationStatus

Registration operation status.

Name	Type	Description
operationId	string	Operation ID.
registrationState	DeviceRegistrationResult	Device registration status.
status	enum: assigned assigning disabled failed unassigned	Device enrollment status.

SymmetricKeyRegistrationResult

Registration result returned when using SymmetricKey attestation.

Name	Type	Description
enrollmentGroupId	string

TpmRegistrationResult

TPM registration result.

Name	Type	Description
authenticationKey	string	Encrypted authentication key.

X509CertificateInfo

X509 certificate info.

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

X509RegistrationResult

X509 registration result.

Name	Type	Description
certificateInfo	X509CertificateInfo	X509 certificate info.
enrollmentGroupId	string
signingCertificateInfo	X509CertificateInfo	X509 certificate info.