Freigeben über


EnrollmentGroup Klasse

Definition

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
EnrollmentGroup
Implementiert

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: