IndividualEnrollment Klasse

Definition

Namespace:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Paket:

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

Darstellung einer einzelnen Device Provisioning Service-Registrierung und ihrer Accessoren mit einem JSON-Serialisierer und -Deserialisierer.

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

type IndividualEnrollment = class
    interface IETagHolder

Public Class IndividualEnrollment
Implements IETagHolder

Vererbung

Object

IndividualEnrollment

Implementiert

IETagHolder

Beispiele

Bei der Serialisierung sieht eine individualEnrollment-Instanz wie im folgenden Beispiel aus:

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

Der folgende JSON-Code ist ein Beispiel für die Antwort individualEnrollment, die vom Bereitstellungsdienst empfangen wird.

{
    "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\""
}

Hinweise

Dieses Objekt wird verwendet, um individuelle Registrierungsinformationen an und vom Bereitstellungsdienst zu senden und zu empfangen.

Um eine Registrierung für den Bereitstellungsdienst zu erstellen oder zu aktualisieren, sollten Sie dieses Objekt ausfüllen und die öffentliche API CreateOrUpdateAsync(IndividualEnrollment, CancellationToken)aufrufen.

Die für den Bereitstellungsdienst erforderlichen Mindestinformationen sind die RegistrationId und der Nachweis.

Ein neues Gerät kann durch drei Nachweismechanismen bereitgestellt werden: X509 (X509Attestation), Symmetrischer Schlüssel (siehe SymmetricKeyAttestation, und TPM (TpmAttestation). Die Definition der einzelnen Geräte, die Sie verwenden sollten, hängt von der physischen Authentifizierungshardware ab, die das Gerät enthält.

Der Inhalt dieser Klasse wird in einem JSON-Format serialisiert und als Text der Rest-API an den Bereitstellungsdienst gesendet. Oder der Inhalt dieser Klasse kann durch einen JSON-Code gefüllt werden, der vom Bereitstellungsdienst als Ergebnis eines individuellen Registrierungsvorgangs wie Erstellen, Aktualisieren oder Abfragen empfangen wird.

Konstruktoren

IndividualEnrollment(String, Attestation)

Erstellt eine neue instance von IndividualEnrollment.

Eigenschaften

AllocationPolicy	Die Zuordnungsrichtlinie dieser Ressource. Überschreibt die Zuordnungsrichtlinie auf Mandantenebene.
Attestation	Bescheinigung.
Capabilities	Funktionen des Geräts.
CreatedDateTimeUtc	Die DateTime, die diese Ressource erstellt wurde.
CustomAllocationDefinition	Benutzerdefinierte Zuordnungsdefinition.
DeviceId	Gewünschte IoT Hub-Geräte-ID (optional).
ETag	ETag der Registrierung.
InitialTwinState	Anfänglicher Zwillingszustand.
IotHubHostName	Gewünschter IoT Hub, dem das Gerät zugewiesen werden soll.
IotHubs	Die Liste der Namen von IoT Hubs, der das Gerät in dieser Ressource zugeordnet werden kann. Muss eine Teilmenge der Liste auf Mandantenebene von IoT Hubs sein.
LastUpdatedDateTimeUtc	DateTime diese Ressource wurde zuletzt aktualisiert.
ProvisioningStatus	Die Bereitstellung status.
RegistrationId	Registrierungs-ID.
RegistrationState	Aktueller Registrierungsstatus.
ReprovisionPolicy	Das Verhalten, wenn ein Gerät in einem IoT Hub erneut bereitgestellt wird.

Methoden

ToString()

Konvertieren Sie dieses Objekt in ein hübsches Druckformat.