Share via


EnrollmentGroup Classe

Définition

Représentation d’un seul groupe d’inscription du service Device Provisioning avec un sérialiseur et un désérialiseur JSON.

public class EnrollmentGroup : Microsoft.Azure.Devices.Shared.IETagHolder
public class EnrollmentGroup
type EnrollmentGroup = class
    interface IETagHolder
type EnrollmentGroup = class
Public Class EnrollmentGroup
Implements IETagHolder
Public Class EnrollmentGroup
Héritage
EnrollmentGroup
Implémente

Exemples

Une fois sérialisé, un enrollmentGroup ressemble à l’exemple suivant :

{
   "enrollmentGroupId":"validEnrollmentGroupId",
   "attestation":{
       "type":"x509",
       "signingCertificates":{
           "primary":{
               "certificate":"[valid certificate]"
           }
       }
   },
   "iotHubHostName":"ContosoIoTHub.azure-devices.net",
   "provisioningStatus":"enabled"
}

Le code JSON suivant est un exemple de réponse EnrollmentGroup, reçu du service d’approvisionnement.

{
   "enrollmentGroupId":"validEnrollmentGroupId",
   "attestation":{
       "type":"x509",
       "signingCertificates":{
           "primary":{
               "certificate":"[valid certificate]",
               "info": {
                   "subjectName": "CN=ROOT_00000000-0000-0000-0000-000000000000, OU=Azure IoT, O=MSFT, C=US",
                   "sha1Thumbprint": "0000000000000000000000000000000000",
                   "sha256Thumbprint": "validEnrollmentGroupId",
                   "issuerName": "CN=ROOT_00000000-0000-0000-0000-000000000000, OU=Azure IoT, O=MSFT, C=US",
                   "notBeforeUtc": "2017-11-14T12:34:18Z",
                   "notAfterUtc": "2017-11-20T12:34:18Z",
                   "serialNumber": "000000000000000000",
                   "version": 3
               }
           }
       }
   },
   "iotHubHostName":"ContosoIoTHub.azure-devices.net",
   "provisioningStatus":"enabled",
   "createdDateTimeUtc": "2017-09-28T16:29:42.3447817Z",
   "lastUpdatedDateTimeUtc": "2017-09-28T16:29:42.3447817Z",
   "etag": "\"00000000-0000-0000-0000-00000000000\""
}

Remarques

Cet objet est utilisé pour envoyer des informations EnrollmentGroup au service d’approvisionnement ou recevoir des informations EnrollmentGroup à partir du service d’approvisionnement.

Pour créer ou mettre à jour un EnrollmentGroup sur le service d’approvisionnement, vous devez remplir cet objet et appeler l’API publique {@link ProvisioningServiceClient#createOrUpdateEnrollmentGroup(EnrollmentGroup)}. Les informations minimales requises par le service d’approvisionnement sont les {@link #enrollmentGroupId} et {@link #attestation}.

Pour approvisionner un appareil à l’aide d’EnrollmentGroup, il doit contenir une puce X509 avec un signingCertificate pour le mécanisme {@link X509Attestation}.

Le contenu de cette classe est sérialisé au format JSON et envoyé en tant que corps de l’API restante au service d’approvisionnement.

Le contenu de cette classe peut être rempli par un JSON, reçu du service d’approvisionnement, à la suite d’une opération EnrollmentGroup comme créer, mettre à jour ou interroger EnrollmentGroup.

Constructeurs

EnrollmentGroup(String, Attestation)

Crée une instance d’EnrollmentGroup.

Propriétés

AllocationPolicy

Stratégie d’allocation de cette ressource. Remplace la stratégie d’allocation au niveau du locataire.

Attestation

Getter et setter pour Attestation.

Capabilities

Fonctionnalités de l’appareil.

CreatedDateTimeUtc

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

CreatedOnUtc

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

CustomAllocationDefinition

Définition d’allocation personnalisée.

EnrollmentGroupId

ID de groupe d’inscription.

ETag

ETag de l’inscription.

InitialTwinState

État du jumeau initial.

IotHubHostName

Hub IoT souhaité à affecter l’appareil.

IotHubs

Liste des noms des hubs IoT vers 2000 qui peuvent être alloués aux appareils de cette ressource. Doit être un sous-ensemble de la liste de hubs IoT au niveau du locataire

LastUpdatedDateTimeUtc

DateTime cette ressource a été mise à jour pour la dernière fois.

LastUpdatedOnUtc

DateTime cette ressource a été mise à jour pour la dernière fois.

ProvisioningStatus

Status d’approvisionnement.

RegistrationState

État actuel de l’inscription.

ReprovisionPolicy

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

Méthodes

ToString()

Convertissez cet objet dans un joli format d’impression.

S’applique à