次の方法で共有


Individual Enrollment - Get

デバイス登録レコードを取得します。

GET https://your-dps.azure-devices-provisioning.net/enrollments/{id}?api-version=2021-10-01

URI パラメーター

名前 / 必須 説明
id
path True

string

この ID は、登録のデバイス登録を一意に識別するために使用されます。 英数字と特定の特殊文字の大文字と小文字を区別しない文字列 (最大 128 文字)。 _ -. 先頭または末尾に特殊文字を使用できません。

api-version
query True

string

要求に使用する API バージョン。 サポートされているバージョンは次のとおりです: 2021-10-01

応答

名前 説明
200 OK

IndividualEnrollment

成功

Other Status Codes

ProvisioningServiceErrorDetails

エラー応答

ヘッダー

x-ms-error-code: string

定義

名前 説明
AttestationMechanism

individualEnrollment と enrollmentGroup の構成証明メカニズム。

CustomAllocationDefinition

これにより、カスタム割り当てを使用するときに呼び出す Webhook が DPS に指示されます。

DeviceCapabilities

デバイスの機能。

DeviceRegistrationState

デバイスの登録状態。

IndividualEnrollment

デバイス登録レコード。

InitialTwin

初期デバイス ツイン。 Twin のプロパティのサブセットが含まれています。

InitialTwinProperties

デバイス ツインで設定される初期プロパティを表します。

Metadata

TwinCollection のメタデータ

ProvisioningServiceErrorDetails

Azure IoT Hub プロビジョニング サービスによって返されるエラーのプロパティが含まれています。

ReprovisionPolicy

デバイスが IoT ハブに再プロビジョニングされたときのサービスの動作。

SymmetricKeyAttestation

SymmetricKey を使用した構成証明。

TpmAttestation

TPM を使用した構成証明。

TwinCollection

Twin 内のプロパティのコレクションを表します。

X509Attestation

X509 による構成証明。

X509CAReferences

プライマリ CA 参照とセカンダリ CA 参照。

X509CertificateInfo

X509 証明書情報。

X509Certificates

プライマリ証明書とセカンダリ証明書

X509CertificateWithInfo

証明書と証明書の情報

AttestationMechanism

individualEnrollment と enrollmentGroup の構成証明メカニズム。

名前 説明
symmetricKey

SymmetricKeyAttestation

SymmetricKey を使用した構成証明。

tpm

TpmAttestation

TPM を使用した構成証明。

type enum:
  • none
  • symmetricKey
  • tpm
  • x509

構成証明の種類。

x509

X509Attestation

X509 による構成証明。

CustomAllocationDefinition

これにより、カスタム割り当てを使用するときに呼び出す Webhook が DPS に指示されます。

名前 説明
apiVersion

string

minLength: 1

カスタム割り当て要求で送信されるプロビジョニング サービスの種類 (IndividualEnrollment など) の API バージョン。 サポートされている最小バージョン: "2018-09-01-preview"。

webhookUrl

string

minLength: 1

割り当て要求に使用される Webhook URL。

DeviceCapabilities

デバイスの機能。

名前 規定値 説明
iotEdge

boolean

False

true に設定すると、このデバイスは IoTEdge デバイスになります。

DeviceRegistrationState

デバイスの登録状態。

名前 説明
assignedHub

string

割り当てられた Azure IoT Hub。

createdDateTimeUtc

string (date-time)

登録の作成日時 (UTC)。

deviceId

string

デバイス ID。

errorCode

integer (int32)

エラー コード。

errorMessage

string

エラーメッセージ。

etag

string

リソースに関連付けられているエンティティ タグ。

lastUpdatedDateTimeUtc

string (date-time)

最終更新日時 (UTC)。

payload

object

registrationId

string

この ID は、登録のデバイス登録を一意に識別するために使用されます。 英数字と特定の特殊文字の大文字と小文字を区別しない文字列 (最大 128 文字)。 _ -. 先頭または末尾に特殊文字を使用できません。

status enum:
  • assigned
  • assigning
  • disabled
  • failed
  • unassigned

登録の状態。

substatus enum:
  • deviceDataMigrated
  • deviceDataReset
  • initialAssignment
  • reprovisionedToInitialAssignment

"割り当て済み" デバイスのサブステータス。 使用可能な値には、"initialAssignment" があります。デバイスは初めて IoT ハブに割り当てられます。"deviceDataMigrated" :デバイスは別の IoT ハブに割り当てられ、そのデバイス データは以前に割り当てられた IoT ハブから移行されました。 以前に割り当てられた IoT ハブ 'deviceDataReset' からデバイス データが削除されました。デバイスは別の IoT ハブに割り当てられ、そのデバイス データは登録に格納されている初期状態から設定されました。 以前に割り当てられた IoT ハブ "reprovisionedToInitialAssignment" からデバイス データが削除されました:デバイスは、以前に割り当てられた IoT ハブに再プロビジョニングされました。

IndividualEnrollment

デバイス登録レコード。

名前 規定値 説明
allocationPolicy enum:
  • custom
  • geoLatency
  • hashed
  • static

このリソースの割り当てポリシー。 このポリシーは、この個々の登録または登録グループのテナント レベルの割り当てポリシーをオーバーライドします。 可能な値には、"ハッシュ" が含まれます。リンクされた IoT ハブには、デバイスがプロビジョニングされている可能性が高い場合があります。"geoLatency": デバイスは、デバイスへの待機時間が最も短い IoT ハブにプロビジョニングされます。複数のリンクされた IoT ハブで同じ最短の待機時間が提供される場合、プロビジョニング サービスはそれらのハブ間でデバイスをハッシュします。"静的" : 登録リスト内の目的の IoT ハブの指定は、サービス レベルの割り当てポリシーである "カスタム" よりも優先されます。デバイスは、独自のカスタム ロジックに基づいて IoT ハブにプロビジョニングされます。 プロビジョニング サービスはデバイスに関する情報をロジックに渡し、ロジックは目的の IoT ハブと目的の初期構成を返します。 Azure Functions を使用してロジックをホストすることをお勧めします。

attestation

AttestationMechanism

individualEnrollment と enrollmentGroup の構成証明メカニズム。

capabilities

DeviceCapabilities

デバイスの機能。

createdDateTimeUtc

string (date-time)

このリソースが作成された DateTime。

customAllocationDefinition

CustomAllocationDefinition

これにより、カスタム割り当てを使用するときに呼び出す Webhook が DPS に指示されます。

deviceId

string

目的の IoT Hub デバイス ID (省略可能)。

etag

string

リソースに関連付けられているエンティティ タグ。

initialTwin

InitialTwin

初期デバイス ツイン。 Twin のプロパティのサブセットが含まれています。

iotHubHostName

string

IoT Hub ホスト名。

iotHubs

string[]

このリソース内のデバイスが割り当てることができる IoT Hub ホスト名の一覧。 IoT ハブのテナント レベルリストのサブセットである必要があります。

lastUpdatedDateTimeUtc

string (date-time)

このリソースが最後に更新された DateTime。

optionalDeviceInformation

TwinCollection

Twin 内のプロパティのコレクションを表します。

provisioningStatus enum:
  • disabled
  • enabled
enabled

プロビジョニングの状態。

registrationId

string

minLength: 1

この ID は、登録のデバイス登録を一意に識別するために使用されます。 英数字と特定の特殊文字の大文字と小文字を区別しない文字列 (最大 128 文字)。 _ -. 先頭または末尾に特殊文字を使用できません。

registrationState

DeviceRegistrationState

デバイスの登録状態。

reprovisionPolicy

ReprovisionPolicy

デバイスが IoT ハブに再プロビジョニングされたときのサービスの動作。

InitialTwin

初期デバイス ツイン。 Twin のプロパティのサブセットが含まれています。

名前 説明
properties

InitialTwinProperties

デバイス ツインで設定される初期プロパティを表します。

tags

TwinCollection

Twin 内のプロパティのコレクションを表します。

InitialTwinProperties

デバイス ツインで設定される初期プロパティを表します。

名前 説明
desired

TwinCollection

Twin 内のプロパティのコレクションを表します。

Metadata

TwinCollection のメタデータ

名前 説明
lastUpdated

string (date-time)

TwinCollection が最後に更新された時刻

lastUpdatedVersion

integer (int64)

これは、報告されるプロパティ メタデータの場合は null であり、必要なプロパティ メタデータの場合は null ではありません。

ProvisioningServiceErrorDetails

Azure IoT Hub プロビジョニング サービスによって返されるエラーのプロパティが含まれています。

名前 説明
errorCode

integer (int32)

info

object

message

string

timestampUtc

string (date-time)

trackingId

string

ReprovisionPolicy

デバイスが IoT ハブに再プロビジョニングされたときのサービスの動作。

名前 規定値 説明
migrateDeviceData

boolean

True

true (既定値) に設定すると、Device Provisioning Service は、IoT ハブの割り当ての更新中に、デバイスのデータ (ツイン、デバイス機能、デバイス ID) をある IoT ハブから別の IoT ハブに移行します。 false に設定すると、Device Provisioning Service はデバイスのデータを、対応する登録リストに格納されている最初の必要な構成にリセットします。

updateHubAssignment

boolean

True

true (既定値) に設定すると、Device Provisioning Service はデバイスの IoT Hub の割り当てを評価し、特定のデバイスからの最初のプロビジョニング要求に必要に応じて更新します。 false に設定すると、デバイスは現在の IoT ハブに割り当てられたままです。

SymmetricKeyAttestation

SymmetricKey を使用した構成証明。

名前 説明
primaryKey

string

主対称キー。

secondaryKey

string

セカンダリ対称キー。

TpmAttestation

TPM を使用した構成証明。

名前 説明
endorsementKey

string

storageRootKey

string

TwinCollection

Twin 内のプロパティのコレクションを表します。

名前 説明
count

integer

TwinCollection のプロパティの数

metadata

Metadata

TwinCollection のメタデータ

version

integer (int64)

TwinCollection のバージョン

X509Attestation

X509 による構成証明。

名前 説明
caReferences

X509CAReferences

プライマリ CA 参照とセカンダリ CA 参照。

clientCertificates

X509Certificates

プライマリ証明書とセカンダリ証明書

signingCertificates

X509Certificates

プライマリ証明書とセカンダリ証明書

X509CAReferences

プライマリ CA 参照とセカンダリ CA 参照。

名前 説明
primary

string

secondary

string

X509CertificateInfo

X509 証明書情報。

名前 説明
issuerName

string

notAfterUtc

string (date-time)

notBeforeUtc

string (date-time)

serialNumber

string

sha1Thumbprint

string

sha256Thumbprint

string

subjectName

string

version

integer (int32)

X509Certificates

プライマリ証明書とセカンダリ証明書

名前 説明
primary

X509CertificateWithInfo

証明書と証明書の情報

secondary

X509CertificateWithInfo

証明書と証明書の情報

X509CertificateWithInfo

証明書と証明書の情報

名前 説明
certificate

string

info

X509CertificateInfo

X509 証明書情報。