IndividualEnrollment クラス

定義

名前空間:

Microsoft.Azure.Devices.Provisioning.Service

アセンブリ:

Microsoft.Azure.Devices.Provisioning.Service.dll

パッケージ:

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

JSON シリアライザーと逆シリアライザーを使用した単一の Device Provisioning Service 登録とそのアクセサーの表現。

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

type IndividualEnrollment = class
    interface IETagHolder

Public Class IndividualEnrollment
Implements IETagHolder

継承

Object

IndividualEnrollment

実装

IETagHolder

例

シリアル化すると、individualEnrollment は次の例のようになります。

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

次の JSON は、プロビジョニング サービスから受信した individualEnrollment 応答のサンプルです。

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

注釈

このオブジェクトは、プロビジョニング サービスとの間で individualEnrollment 情報を送受信するために使用されます。

プロビジョニング サービスで登録を作成または更新するには、このオブジェクトを入力し、パブリック API CreateOrUpdateAsync(IndividualEnrollment, CancellationToken)を呼び出す必要があります。

プロビジョニング サービスに必要な最小限の情報は、RegistrationId と構成証明です。

新しいデバイスは、X509 ()、対称キー (、および TPMTpmAttestation (X509Attestation) を参照) SymmetricKeyAttestationの 3 つの構成証明メカニズムによってプロビジョニングできます。 デバイスに含まれる物理認証ハードウェアに応じて、使用する必要がある各ハードウェアの定義。

このクラスのコンテンツは JSON 形式でシリアル化され、残りの API の本文としてプロビジョニング サービスに送信されます。 または、作成、更新、クエリなどの個々の登録操作の結果として、プロビジョニング サービスから受信した JSON によってこのクラスのコンテンツを入力できます。

コンストラクター

IndividualEnrollment(String, Attestation)

IndividualEnrollment の新しいインスタンスを作成します。

プロパティ

AllocationPolicy	このリソースの割り当てポリシー。 テナント レベルの割り当てポリシーをオーバーライドします。
Attestation	認証。
Capabilities	デバイスの機能。
CreatedDateTimeUtc	このリソースが作成された DateTime。
CustomAllocationDefinition	カスタム割り当て定義。
DeviceId	目的の IoT Hub デバイス ID (省略可能)。
ETag	登録の ETag。
InitialTwinState	初期ツインの状態。
IotHubHostName	デバイスを割り当てる目的の IoT ハブ。
IotHubs	このリソース内のデバイスが割り当てることができる IoT ハブの名前の一覧。 IoT ハブのテナント レベル リストのサブセットである必要があります。
LastUpdatedDateTimeUtc	このリソースが最後に更新された DateTime。
ProvisioningStatus	プロビジョニングの状態。
RegistrationId	登録 ID。
RegistrationState	現在の登録状態。
ReprovisionPolicy	デバイスが IoT ハブに再プロビジョニングされたときの動作。

メソッド

ToString()

このオブジェクトを美しい印刷形式で変換します。