Runtime Registration - Operation Status Lookup

Service:

IoT Hub Device Provisioning Service

API Version:

2021-10-01

Ottiene lo stato dell'operazione di registrazione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
idScope	path	True	string
operationId	path	True	string	ID operazione.
registrationId	path	True	string	ID registrazione.
api-version	query	True	string	Versione dell'API da usare per la richiesta. Le versioni supportate includono: 2021-10-01

Risposte

Nome	Tipo	Descrizione
200 OK	RegistrationOperationStatus	Operazione riuscita
202 Accepted	RegistrationOperationStatus	Accettato Headers retry-after: integer Location: string
Other Status Codes	ProvisioningServiceErrorDetails	Risposta di errore Headers x-ms-error-code: string

Definizioni

Nome	Descrizione
DeviceRegistrationResult	Risultato della registrazione del dispositivo.
ProvisioningServiceErrorDetails	Contiene le proprietà di un errore restituito dal servizio di provisioning hub IoT di Azure.
RegistrationOperationStatus	Stato dell'operazione di registrazione.
SymmetricKeyRegistrationResult	Risultato della registrazione restituito quando si usa l'attestazione SymmetricKey.
TpmRegistrationResult	Risultato della registrazione TPM.
X509CertificateInfo	Informazioni sul certificato X509.
X509RegistrationResult	Risultato della registrazione X509.

DeviceRegistrationResult

Risultato della registrazione del dispositivo.

Nome	Tipo	Descrizione
assignedHub	string	Assegnato hub IoT di Azure.
createdDateTimeUtc	string	La registrazione crea data e ora (in formato UTC).
deviceId	string	ID dispositivo.
errorCode	integer	Codice di errore.
errorMessage	string	Messaggio di errore.
etag	string	Tag di entità associato alla risorsa.
lastUpdatedDateTimeUtc	string	Data dell'ultimo aggiornamento (in formato UTC).
payload	object
registrationId	string	Questo ID viene usato per identificare in modo univoco una registrazione del dispositivo di una registrazione. Stringa senza distinzione tra maiuscole e minuscole (fino a 128 caratteri) di caratteri alfanumerici più determinati caratteri speciali: . _ -. Nessun carattere speciale consentito all'inizio o alla fine.
status	enum: assigned assigning disabled failed unassigned	Stato della registrazione.
substatus	enum: deviceDataMigrated deviceDataReset initialAssignment reprovisionedToInitialAssignment	Stato secondario per i dispositivi 'Assegnati'. I valori possibili includono : 'initialAssignment': il dispositivo è stato assegnato a un hub IoT per la prima volta, 'deviceDataMigrated': il dispositivo è stato assegnato a un hub IoT diverso e i relativi dati del dispositivo sono stati migrati dall'hub IoT assegnato in precedenza. I dati del dispositivo sono stati rimossi dall'hub IoT assegnato in precedenza, 'deviceDataReset': il dispositivo è stato assegnato a un hub IoT diverso e i relativi dati del dispositivo sono stati popolati dallo stato iniziale archiviato nella registrazione. I dati del dispositivo sono stati rimossi dall'hub IoT assegnato in precedenza, 'reprovisionedToInitialAssignment': è stato eseguito di nuovo il provisioning del dispositivo in un hub IoT assegnato in precedenza.
symmetricKey	SymmetricKeyRegistrationResult	Risultato della registrazione restituito quando si usa l'attestazione SymmetricKey.
tpm	TpmRegistrationResult	Risultato della registrazione TPM.
x509	X509RegistrationResult	Risultato della registrazione X509.

ProvisioningServiceErrorDetails

Contiene le proprietà di un errore restituito dal servizio di provisioning hub IoT di Azure.

Nome	Tipo	Descrizione
errorCode	integer
info	object
message	string
timestampUtc	string
trackingId	string

RegistrationOperationStatus

Stato dell'operazione di registrazione.

Nome	Tipo	Descrizione
operationId	string	ID operazione.
registrationState	DeviceRegistrationResult	Risultato della registrazione del dispositivo.
status	enum: assigned assigning disabled failed unassigned	Stato della registrazione del dispositivo.

SymmetricKeyRegistrationResult

Risultato della registrazione restituito quando si usa l'attestazione SymmetricKey.

Nome	Tipo	Descrizione
enrollmentGroupId	string

TpmRegistrationResult

Risultato della registrazione TPM.

Nome	Tipo	Descrizione
authenticationKey	string	Chiave di autenticazione crittografata.

X509CertificateInfo

Informazioni sul certificato X509.

Nome	Tipo	Descrizione
issuerName	string
notAfterUtc	string
notBeforeUtc	string
serialNumber	string
sha1Thumbprint	string
sha256Thumbprint	string
subjectName	string
version	integer

X509RegistrationResult

Risultato della registrazione X509.

Nome	Tipo	Descrizione
certificateInfo	X509CertificateInfo	Informazioni sul certificato X509.
enrollmentGroupId	string
signingCertificateInfo	X509CertificateInfo	Informazioni sul certificato X509.