Individual Enrollment - Get

Servizio:

IoT Hub Device Provisioning Service

Versione API:

2021-10-01

Ottenere un record di registrazione del dispositivo.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
id	path	True	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 lunghi) di caratteri alfanumerici e determinati caratteri speciali: . _ -. Nessun carattere speciale consentito all'inizio o alla fine.
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	IndividualEnrollment	Operazione riuscita
Other Status Codes	ProvisioningServiceErrorDetails	Risposta di errore Intestazioni x-ms-error-code: string

Definizioni

Nome	Descrizione
AttestationMechanism	Meccanismo di attestazione per individualEnrollment e enrollmentGroup.
CustomAllocationDefinition	Questo indica a DPS quale webhook chiamare quando si usa l'allocazione personalizzata.
DeviceCapabilities	Funzionalità del dispositivo.
DeviceRegistrationState	Stato di registrazione del dispositivo.
IndividualEnrollment	Record di registrazione del dispositivo.
InitialTwin	Dispositivo gemello iniziale. Contiene un subset delle proprietà di Twin.
InitialTwinProperties	Rappresenta le proprietà iniziali che verranno impostate sul dispositivo gemello.
Metadata	Metadati per TwinCollection
ProvisioningServiceErrorDetails	Contiene le proprietà di un errore restituito dal servizio di provisioning hub IoT di Azure.
ReprovisionPolicy	Comportamento del servizio quando un dispositivo viene nuovamente eseguito il provisioning in un hub IoT.
SymmetricKeyAttestation	Attestazione tramite SymmetricKey.
TpmAttestation	Attestazione tramite TPM.
TwinCollection	Rappresenta una raccolta di proprietà all'interno di un gemello
X509Attestation	Attestazione tramite X509.
X509CAReferences	Riferimenti alla CA primaria e secondaria.
X509CertificateInfo	Informazioni sul certificato X509.
X509Certificates	Certificati primari e secondari
X509CertificateWithInfo	Informazioni sul certificato e sul certificato

AttestationMechanism

Meccanismo di attestazione per individualEnrollment e enrollmentGroup.

Nome	Tipo	Descrizione
symmetricKey	SymmetricKeyAttestation	Attestazione tramite SymmetricKey.
tpm	TpmAttestation	Attestazione tramite TPM.
type	enum: none symmetricKey tpm x509	Tipo di attestazione.
x509	X509Attestation	Attestazione tramite X509.

CustomAllocationDefinition

Questo indica a DPS quale webhook chiamare quando si usa l'allocazione personalizzata.

Nome	Tipo	Descrizione
apiVersion	string	Versione API dei tipi di servizio di provisioning (ad esempio IndividualEnrollment) inviati nella richiesta di allocazione personalizzata. Versione minima supportata: "2018-09-01-preview".
webhookUrl	string	URL webhook usato per le richieste di allocazione.

DeviceCapabilities

Funzionalità del dispositivo.

Nome	Tipo	Valore predefinito	Descrizione
iotEdge	boolean	False	Se impostato su true, questo dispositivo è un dispositivo IoTEdge.

DeviceRegistrationState

Stato di registrazione del dispositivo.

Nome	Tipo	Descrizione
assignedHub	string	Assegnato hub IoT di Azure.
createdDateTimeUtc	string	Data di creazione della registrazione (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	Ultima ora di data aggiornata (in 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 lunghi) di caratteri alfanumerici e determinati caratteri speciali: . _ -. Nessun carattere speciale consentito all'inizio o alla fine.
status	enum: assigned assigning disabled failed unassigned	Stato registrazione.
substatus	enum: deviceDataMigrated deviceDataReset initialAssignment reprovisionedToInitialAssignment	Sottostatus 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': il dispositivo è stato nuovamente effettuato il provisioning in un hub IoT assegnato in precedenza.

IndividualEnrollment

Record di registrazione del dispositivo.

Nome	Tipo	Valore predefinito	Descrizione
allocationPolicy	enum: custom geoLatency hashed static		Criteri di allocazione di questa risorsa. Questo criterio esegue l'override dei criteri di allocazione a livello di tenant per questa singola registrazione o gruppo di registrazione. I valori possibili includono "hashed": gli hub IoT collegati sono altrettanto probabile che i dispositivi abbiano effettuato il provisioning, "geoLatenza" : i dispositivi vengono effettuato il provisioning in un hub IoT con la latenza più bassa del dispositivo. Se più hub IoT collegati forniscono la stessa latenza più bassa, il servizio di provisioning esegue l'hash dei dispositivi in tali hub, "statico" : specifica dell'hub IoT desiderato nell'elenco di registrazioni accetta la priorità sui criteri di allocazione a livello di servizio, 'custom': i dispositivi vengono distribuiti in un hub IoT basato sulla propria logica personalizzata. Il servizio di provisioning passa informazioni sul dispositivo alla logica e la logica restituisce l'hub IoT desiderato e la configurazione iniziale desiderata. È consigliabile usare Funzioni di Azure per ospitare la logica.
attestation	AttestationMechanism		Meccanismo di attestazione per individualEnrollment e enrollmentGroup.
capabilities	DeviceCapabilities		Funzionalità del dispositivo.
createdDateTimeUtc	string		La risorsa DateTime è stata creata.
customAllocationDefinition	CustomAllocationDefinition		Questo indica a DPS quale webhook chiamare quando si usa l'allocazione personalizzata.
deviceId	string		ID dispositivo desiderato hub IoT (facoltativo).
etag	string		Tag di entità associato alla risorsa.
initialTwin	InitialTwin		Dispositivo gemello iniziale. Contiene un subset delle proprietà di Twin.
iotHubHostName	string		Nome host dell'hub Iot.
iotHubs	string[]		L'elenco di hub IoT nomi host a cui è possibile allocare i dispositivi in questa risorsa. Deve essere un subset di elenco a livello di tenant degli hub IoT.
lastUpdatedDateTimeUtc	string		DataTime questa risorsa è stata aggiornata.
optionalDeviceInformation	TwinCollection		Rappresenta una raccolta di proprietà all'interno di un gemello
provisioningStatus	enum: disabled enabled	enabled	Stato del provisioning.
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 lunghi) di caratteri alfanumerici e determinati caratteri speciali: . _ -. Nessun carattere speciale consentito all'inizio o alla fine.
registrationState	DeviceRegistrationState		Stato di registrazione del dispositivo.
reprovisionPolicy	ReprovisionPolicy		Comportamento del servizio quando un dispositivo viene nuovamente eseguito il provisioning in un hub IoT.

InitialTwin

Dispositivo gemello iniziale. Contiene un subset delle proprietà di Twin.

Nome	Tipo	Descrizione
properties	InitialTwinProperties	Rappresenta le proprietà iniziali che verranno impostate sul dispositivo gemello.
tags	TwinCollection	Rappresenta una raccolta di proprietà all'interno di un gemello

InitialTwinProperties

Rappresenta le proprietà iniziali che verranno impostate sul dispositivo gemello.

Nome	Tipo	Descrizione
desired	TwinCollection	Rappresenta una raccolta di proprietà all'interno di un gemello

Metadata

Metadati per TwinCollection

Nome	Tipo	Descrizione
lastUpdated	string	Ultima volta che twinCollection è stato aggiornato
lastUpdatedVersion	integer	Questo valore è Null per i metadati delle proprietà segnalate e non è Null per i metadati delle proprietà desiderati.

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

ReprovisionPolicy

Comportamento del servizio quando un dispositivo viene nuovamente eseguito il provisioning in un hub IoT.

Nome	Tipo	Valore predefinito	Descrizione
migrateDeviceData	boolean	True	Se impostato su true (impostazione predefinita), il servizio Device Provisioning eseguirà la migrazione dei dati del dispositivo (gemello, funzionalità del dispositivo e ID dispositivo) da un hub IoT a un altro durante un aggiornamento dell'assegnazione dell'hub IoT. Se impostato su false, il servizio Device Provisioning reimposta i dati del dispositivo nella configurazione iniziale desiderata archiviata nell'elenco di registrazione corrispondente.
updateHubAssignment	boolean	True	Se impostato su true (impostazione predefinita), il servizio Device Provisioning valuterà l'assegnazione di hub IoT del dispositivo e la aggiornerà se necessario per eventuali richieste di provisioning oltre la prima da un determinato dispositivo. Se impostato su false, il dispositivo rimarrà assegnato all'hub IoT corrente.

SymmetricKeyAttestation

Attestazione tramite SymmetricKey.

Nome	Tipo	Descrizione
primaryKey	string	Chiave simmetrica primaria.
secondaryKey	string	Chiave simmetrica secondaria.

TpmAttestation

Attestazione tramite TPM.

Nome	Tipo	Descrizione
endorsementKey	string
storageRootKey	string

TwinCollection

Rappresenta una raccolta di proprietà all'interno di un gemello

Nome	Tipo	Descrizione
count	integer	Numero di proprietà in TwinCollection
metadata	Metadata	Metadati per TwinCollection
version	integer	Versione di TwinCollection

X509Attestation

Attestazione tramite X509.

Nome	Tipo	Descrizione
caReferences	X509CAReferences	Riferimenti alla CA primaria e secondaria.
clientCertificates	X509Certificates	Certificati primari e secondari
signingCertificates	X509Certificates	Certificati primari e secondari

X509CAReferences

Riferimenti alla CA primaria e secondaria.

Nome	Tipo	Descrizione
primary	string
secondary	string

X509CertificateInfo

Informazioni sul certificato X509.

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

X509Certificates

Certificati primari e secondari

Nome	Tipo	Descrizione
primary	X509CertificateWithInfo	Informazioni sul certificato e sul certificato
secondary	X509CertificateWithInfo	Informazioni sul certificato e sul certificato

X509CertificateWithInfo

Informazioni sul certificato e sul certificato

Nome	Tipo	Descrizione
certificate	string
info	X509CertificateInfo	Informazioni sul certificato X509.