EnrollmentGroup 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-Registrierungsgruppe mit einem JSON-Serialisierer und -Deserialisierer.

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

type EnrollmentGroup = class
    interface IETagHolder

Public Class EnrollmentGroup
Implements IETagHolder

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.
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.
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.