EnrollmentGroup Klasse

Referenz

Definition

Namespace:: Microsoft.Azure.Devices.Provisioning.Service

Assembly:: Microsoft.Azure.Devices.Provisioning.Service.dll

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

Paket:: Microsoft.Azure.Devices.Provisioning.Service v2.0.0-preview002

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Darstellung einer einzelnen Device Provisioning Service-Registrierungsgruppe mit einem JSON-Serialisierer und -Deserialisierer.

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

Vererbung: Object
EnrollmentGroup

Implementiert: IETagHolder

Beispiele

Bei der Serialisierung sieht eine EnrollmentGroup wie im folgenden Beispiel aus:

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

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

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

Hinweise

Dieses Objekt wird verwendet, um EnrollmentGroup-Informationen an den Bereitstellungsdienst zu senden oder EnrollmentGroup-Informationen vom Bereitstellungsdienst zu empfangen.

Um eine EnrollmentGroup für den Bereitstellungsdienst zu erstellen oder zu aktualisieren, müssen Sie dieses Objekt ausfüllen und die öffentliche API {@link ProvisioningServiceClient#createOrUpdateEnrollmentGroup(EnrollmentGroup)} aufrufen. Die Mindestinformationen, die vom Bereitstellungsdienst benötigt werden, sind die {@link #enrollmentGroupId} und die {@link #attestation}.

Um ein Gerät mithilfe von EnrollmentGroup bereitzustellen, muss es einen X509-Chip mit einem signingCertificate für den {@link X509Attestation}-Mechanismus enthalten.

Der Inhalt dieser Klasse wird in einem JSON-Format serialisiert und als Text der Rest-API an den Bereitstellungsdienst gesendet.

Der Inhalt dieser Klasse kann durch einen JSON-Code gefüllt werden, der vom Bereitstellungsdienst als Ergebnis eines EnrollmentGroup-Vorgangs wie Erstellen, Aktualisieren oder Abfragen von EnrollmentGroup empfangen wird.

Konstruktoren

EnrollmentGroup(String, Attestation)

Erstellt eine neue instance von EnrollmentGroup.

Eigenschaften

AllocationPolicy	Die Zuordnungsrichtlinie dieser Ressource. Überschreibt die Zuordnungsrichtlinie auf Mandantenebene.
Attestation	Getter und Setter für Attestation.
Capabilities	Funktionen des Geräts.
CreatedDateTimeUtc	Die DateTime, die diese Ressource erstellt wurde.
CreatedOnUtc	Die DateTime, die diese Ressource erstellt wurde.
CustomAllocationDefinition	Benutzerdefinierte Zuordnungsdefinition.
EnrollmentGroupId	Registrierungsgruppen-ID.
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, deren Geräte in dieser Ressource zugeordnet werden können. Muss eine Teilmenge der Liste auf Mandantenebene von IoT Hubs sein
LastUpdatedDateTimeUtc	DateTime diese Ressource wurde zuletzt aktualisiert.
LastUpdatedOnUtc	DateTime diese Ressource wurde zuletzt aktualisiert.
ProvisioningStatus	Die Bereitstellung status.
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.

Gilt für:

Freigeben über