Partager via

Enrollment Group - Query

  • Référence
Service:
IoT Hub Device Provisioning Service
Version d'API:
2021-10-01

Interrogez les groupes d’inscription d’appareils.

POST https://your-dps.azure-devices-provisioning.net/enrollmentGroups/query?api-version=2021-10-01

Paramètres URI

Nom Dans Obligatoire Type Description
api-version
 query True

string

Version de l’API à utiliser pour la requête. Les versions prises en charge sont les suivantes : 2021-10-01

En-tête de la demande

Nom Obligatoire Type Description
x-ms-max-item-count

integer (int32)

Taille de page
x-ms-continuation

string

Jeton de continuation

Corps de la demande

Nom Obligatoire Type Description
query True

string

Réponses

Nom Type Description
200 OK

EnrollmentGroup[]

Succès

En-têtes

  • x-ms-continuation: string
  • x-ms-max-item-count: integer
  • x-ms-item-type: string
Other Status Codes

ProvisioningServiceErrorDetails

Réponse d’erreur

En-têtes

x-ms-error-code: string

Définitions

Nom Description
AttestationMechanism

Mécanisme d’attestation pour individualEnrollment et enrollmentGroup.
CustomAllocationDefinition

Cela indique à DPS quel webhook appeler lors de l’utilisation de l’allocation personnalisée.
DeviceCapabilities

Fonctionnalités de l’appareil.
EnrollmentGroup

Enregistrement de groupe d’inscription.
InitialTwin

Jumeau d’appareil initial. Contient un sous-ensemble des propriétés du jumeau.
InitialTwinProperties

Représente les propriétés initiales qui seront définies sur le jumeau d’appareil.
Metadata

Métadonnées pour TwinCollection
ProvisioningServiceErrorDetails

Contient les propriétés d’une erreur retournée par le service Azure IoT Hub Provisioning.
QuerySpecification
ReprovisionPolicy

Comportement du service lorsqu’un appareil est reprovisionné sur un hub IoT.
SymmetricKeyAttestation

Attestation via SymmetricKey.
TpmAttestation

Attestation via TPM.
TwinCollection

Représente une collection de propriétés dans un jumeau
X509Attestation

Attestation via X509.
X509CAReferences

Références d’autorité de certification primaire et secondaire.
X509CertificateInfo

Informations sur le certificat X509.
X509Certificates

Certificats principaux et secondaires
X509CertificateWithInfo

Informations sur le certificat et le certificat

AttestationMechanism

Object

Mécanisme d’attestation pour individualEnrollment et enrollmentGroup.

Nom Type Description
symmetricKey

SymmetricKeyAttestation

Attestation via SymmetricKey.
tpm

TpmAttestation

Attestation via TPM.
type enum:
  • none
  • symmetricKey
  • tpm
  • x509

Type d’attestation.
x509

X509Attestation

Attestation via X509.

CustomAllocationDefinition

Object

Cela indique à DPS quel webhook appeler lors de l’utilisation de l’allocation personnalisée.

Nom Type Description
apiVersion

string

minLength: 1

Version d’API des types de service d’approvisionnement (par exemple IndividualEnrollment) envoyés dans la demande d’allocation personnalisée. Version minimale prise en charge : « 2018-09-01-preview ».
webhookUrl

string

minLength: 1

URL du webhook utilisée pour les demandes d’allocation.

DeviceCapabilities

Object

Fonctionnalités de l’appareil.

Nom Type Valeur par défaut Description
iotEdge

boolean

False

Si la valeur est true, cet appareil est un appareil IoTEdge.

EnrollmentGroup

Object

Enregistrement de groupe d’inscription.

Nom Type Valeur par défaut Description
allocationPolicy enum:
  • custom
  • geoLatency
  • hashed
  • static

Stratégie d’allocation de cette ressource. Cette stratégie remplace la stratégie d’allocation au niveau du locataire pour ce groupe d’inscription ou d’inscription individuel. Les valeurs possibles incluent « hachage » : les hubs IoT liés sont également susceptibles d’avoir des appareils approvisionnés, « geoLatency » : les appareils sont approvisionnés sur un hub IoT avec la latence la plus faible pour l’appareil. Si plusieurs hubs IoT liés fournissent la même latence la plus faible, le service d’approvisionnement hachage les appareils sur ces hubs, « statique » : la spécification du hub IoT souhaité dans la liste d’inscriptions est prioritaire sur la stratégie d’allocation au niveau du service , « personnalisé » : les appareils sont approvisionnés sur un hub IoT basé sur votre propre logique personnalisée. Le service d’approvisionnement transmet des informations sur l’appareil à la logique, et la logique retourne le hub IoT souhaité ainsi que la configuration initiale souhaitée. Nous vous recommandons d’utiliser Azure Functions pour héberger votre logique.
attestation

AttestationMechanism

Mécanisme d’attestation pour individualEnrollment et enrollmentGroup.
capabilities

DeviceCapabilities

Fonctionnalités de l’appareil.
createdDateTimeUtc

string (date-time)

DateTime que cette ressource a été créée.
customAllocationDefinition

CustomAllocationDefinition

Cela indique à DPS quel webhook appeler lors de l’utilisation de l’allocation personnalisée.
enrollmentGroupId

string

minLength: 1

ID de groupe d’inscription.
etag

string

Balise d’entité associée à la ressource.
initialTwin

InitialTwin

Jumeau d’appareil initial. Contient un sous-ensemble des propriétés du jumeau.
iotHubHostName

string

Nom d’hôte iot Hub.
iotHubs

string[]

La liste des noms d’hôte IoT Hub pour utilisant les appareils de cette ressource peut être allouée. Doit être un sous-ensemble de la liste des hubs IoT au niveau du locataire.
lastUpdatedDateTimeUtc

string (date-time)

DateTime cette ressource a été mise à jour pour la dernière fois.
provisioningStatus enum:
  • disabled
  • enabled
enabled

État d’approvisionnement.
reprovisionPolicy

ReprovisionPolicy

Comportement du service lorsqu’un appareil est reprovisionné sur un hub IoT.

InitialTwin

Object

Jumeau d’appareil initial. Contient un sous-ensemble des propriétés du jumeau.

Nom Type Description
properties

InitialTwinProperties

Représente les propriétés initiales qui seront définies sur le jumeau d’appareil.
tags

TwinCollection

Représente une collection de propriétés dans un jumeau

InitialTwinProperties

Object

Représente les propriétés initiales qui seront définies sur le jumeau d’appareil.

Nom Type Description
desired

TwinCollection

Représente une collection de propriétés dans un jumeau

Metadata

Object

Métadonnées pour TwinCollection

Nom Type Description
lastUpdated

string (date-time)

Dernière mise à jour de TwinCollection
lastUpdatedVersion

integer (int64)

Il s’agit de null pour les métadonnées de propriétés signalées et n’est pas null pour les métadonnées de propriétés souhaitées.

ProvisioningServiceErrorDetails

Object

Contient les propriétés d’une erreur retournée par le service Azure IoT Hub Provisioning.

Nom Type Description
errorCode

integer (int32)

info

object

message

string

timestampUtc

string (date-time)

trackingId

string

QuerySpecification

Object
Nom Type Description
query

string

ReprovisionPolicy

Object

Comportement du service lorsqu’un appareil est reprovisionné sur un hub IoT.

Nom Type Valeur par défaut Description
migrateDeviceData

boolean

True

Quand la valeur est true (valeur par défaut), le service Device Provisioning migre les données de l’appareil (jumeau, fonctionnalités d’appareil et ID d’appareil) d’un hub IoT vers un autre pendant une mise à jour d’affectation du hub IoT. Si la valeur est false, le service Device Provisioning réinitialise les données de l’appareil à la configuration initiale souhaitée stockée dans la liste d’inscription correspondante.
updateHubAssignment

boolean

True

Lorsque la valeur est true (valeur par défaut), le service Device Provisioning évalue l’affectation IoT Hub de l’appareil et la met à jour si nécessaire pour toutes les demandes d’approvisionnement au-delà du premier appareil donné. Si la valeur est false, l’appareil reste affecté à son hub IoT actuel.

SymmetricKeyAttestation

Object

Attestation via SymmetricKey.

Nom Type Description
primaryKey

string

Clé symétrique primaire.
secondaryKey

string

Clé symétrique secondaire.

TpmAttestation

Object

Attestation via TPM.

Nom Type Description
endorsementKey

string

storageRootKey

string

TwinCollection

Object

Représente une collection de propriétés dans un jumeau

Nom Type Description
count

integer

Nombre de propriétés dans TwinCollection
metadata

Metadata

Métadonnées pour TwinCollection
version

integer (int64)

Version de TwinCollection

X509Attestation

Object

Attestation via X509.

Nom Type Description
caReferences

X509CAReferences

Références d’autorité de certification primaire et secondaire.
clientCertificates

X509Certificates

Certificats principaux et secondaires
signingCertificates

X509Certificates

Certificats principaux et secondaires

X509CAReferences

Object

Références d’autorité de certification primaire et secondaire.

Nom Type Description
primary

string

secondary

string

X509CertificateInfo

Object

Informations sur le certificat X509.

Nom Type Description
issuerName

string

notAfterUtc

string (date-time)

notBeforeUtc

string (date-time)

serialNumber

string

sha1Thumbprint

string

sha256Thumbprint

string

subjectName

string

version

integer (int32)

X509Certificates

Object

Certificats principaux et secondaires

Nom Type Description
primary

X509CertificateWithInfo

Informations sur le certificat et le certificat
secondary

X509CertificateWithInfo

Informations sur le certificat et le certificat

X509CertificateWithInfo

Object

Informations sur le certificat et le certificat

Nom Type Description
certificate

string

info

X509CertificateInfo

Informations sur le certificat X509.