IndividualEnrollment Klasse
Definition
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-Registrierung und ihrer Accessoren mit einem JSON-Serialisierer und -Deserialisierer.
public class IndividualEnrollment : Microsoft.Azure.Devices.Shared.IETagHolder
public class IndividualEnrollment
type IndividualEnrollment = class
interface IETagHolder
type IndividualEnrollment = class
Public Class IndividualEnrollment
Implements IETagHolder
Public Class IndividualEnrollment
- Vererbung
-
IndividualEnrollment
- Implementiert
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. |
CreatedOnUtc |
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. |
LastUpdatedOnUtc |
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. |
Gilt für:
Azure SDK for .NET