IndividualEnrollment Classe

Définition

Espace de noms:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Paquet:

Microsoft.Azure.Devices.Provisioning.Service v1.18.1

Représentation d’une inscription unique au service Device Provisioning et de ses accesseurs avec un sérialiseur JSON et un désérialiseur.

public class IndividualEnrollment : Microsoft.Azure.Devices.Shared.IETagHolder

type IndividualEnrollment = class
    interface IETagHolder

Public Class IndividualEnrollment
Implements IETagHolder

Héritage

Object

IndividualEnrollment

Implémente

IETagHolder

Exemples

En cas de sérialisation, un individualEnrollment ressemble à l’exemple suivant :

{
    "registrationId":"validRegistrationId",
    "deviceId":"ContosoDevice-123",
    "attestation":{
        "type":"tpm",
        "tpm":{
               "endorsementKey":"validEndorsementKey"
        }
    },
    "iotHubHostName":"ContosoIoTHub.azure-devices.net",
    "provisioningStatus":"enabled"
}

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

{
    "registrationId":"validRegistrationId",
    "deviceId":"ContosoDevice-123",
    "attestation":{
        "type":"tpm",
        "tpm":{
            "endorsementKey":"validEndorsementKey"
        }
    },
    "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 et recevoir des informations individualEnrollment vers et à partir du service d’approvisionnement.

Pour créer ou mettre à jour une inscription sur le service d’approvisionnement, vous devez remplir cet objet et appeler l’API CreateOrUpdateAsync(IndividualEnrollment, CancellationToken)publique .

Les informations minimales requises par le service d’approvisionnement sont l’Id d’inscription et l’attestation.

Un nouvel appareil peut être provisionné par trois mécanismes d’attestation , X509 (X509Attestation), clé symétrique (voir SymmetricKeyAttestationet TPM (TpmAttestation). Définition de chacun d’eux que vous devez utiliser en fonction du matériel d’authentification physique que contient l’appareil.

Le contenu de cette classe sera sérialisé au format JSON et envoyé comme corps de l’API restante au service d’approvisionnement. Ou le contenu de cette classe peut être rempli par un JSON, reçu du service d’approvisionnement, à la suite d’une opération individualEnrollment comme créer, mettre à jour ou interroger.

Constructeurs

IndividualEnrollment(String, Attestation)

Crée un instance d’IndividualEnrollment.

Propriétés

AllocationPolicy	Stratégie d’allocation de cette ressource. Remplace la stratégie d’allocation au niveau du locataire.
Attestation	Attestation.
Capabilities	Fonctionnalités de l’appareil.
CreatedDateTimeUtc	DateTime cette ressource a été créée.
CustomAllocationDefinition	Définition d’allocation personnalisée.
DeviceId	ID d’appareil IoT Hub souhaité (facultatif).
ETag	ETag de l’inscription.
InitialTwinState	État initial du jumeau.
IotHubHostName	Hub IoT souhaité à affecter l’appareil.
IotHubs	Liste des noms des hubs IoT à laquelle l’appareil de cette ressource peut être alloué. Doit être un sous-ensemble de la liste au niveau du locataire des hubs IoT.
LastUpdatedDateTimeUtc	DateTime cette ressource a été mise à jour pour la dernière fois.
ProvisioningStatus	Status d’approvisionnement.
RegistrationId	ID d’inscription.
RegistrationState	État actuel de l’inscription.
ReprovisionPolicy	Comportement lorsqu’un appareil est réapprovisionnement sur un hub IoT.

Méthodes

ToString()

Convertissez cet objet dans un joli format d’impression.