Condividi tramite


Enrollment Group - Get

Ottenere un gruppo di registrazione dei dispositivi.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
id
path True

string

ID gruppo di 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

EnrollmentGroup

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.

EnrollmentGroup

Record del gruppo di registrazione.

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.

EnrollmentGroup

Record del gruppo di registrazione.

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.

enrollmentGroupId

string

ID gruppo di registrazione.

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.

provisioningStatus enum:
  • disabled
  • enabled
enabled

Stato del provisioning.

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.