Individual Enrollment - Get Attestation Mechanism

Service:

IoT Hub Device Provisioning Service

API Version:

2021-10-01

取得裝置註冊記錄中的證明機制。

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

URI 參數

名稱	位於	必要	類型	Description
id	path	True	string	此標識碼可用來唯一識別註冊的裝置註冊。 不區分大小寫的字串 (最多 128 個字元的英數位元長) 加上特定特殊字元：。 _ -. 開頭或結尾不允許任何特殊字元。
api-version	query	True	string	要用於要求的 API 版本。 支援的版本包括：2021-10-01

回應

名稱	類型	Description
200 OK	AttestationMechanism	Success
Other Status Codes	ProvisioningServiceErrorDetails	錯誤回應 Headers x-ms-error-code: string

定義

名稱	Description
AttestationMechanism	個別註冊和 enrollmentGroup 的證明機制。
ProvisioningServiceErrorDetails	包含 Azure IoT 中樞 布建服務所傳回之錯誤的屬性。
SymmetricKeyAttestation	透過 SymmetricKey 證明。
TpmAttestation	透過 TPM 證明。
X509Attestation	透過 X509 證明。
X509CAReferences	主要和次要 CA 參考。
X509CertificateInfo	X509 憑證資訊。
X509Certificates	主要和次要憑證
X509CertificateWithInfo	憑證和憑證資訊

AttestationMechanism

個別註冊和 enrollmentGroup 的證明機制。

名稱	類型	Description
symmetricKey	SymmetricKeyAttestation	透過 SymmetricKey 證明。
tpm	TpmAttestation	透過 TPM 證明。
type	enum: none symmetricKey tpm x509	證明類型。
x509	X509Attestation	透過 X509 證明。

ProvisioningServiceErrorDetails

包含 Azure IoT 中樞 布建服務所傳回之錯誤的屬性。

名稱	類型	Description
errorCode	integer
info	object
message	string
timestampUtc	string
trackingId	string

SymmetricKeyAttestation

透過 SymmetricKey 證明。

名稱	類型	Description
primaryKey	string	主要對稱金鑰。
secondaryKey	string	次要對稱金鑰。

TpmAttestation

透過 TPM 證明。

名稱	類型	Description
endorsementKey	string
storageRootKey	string

X509Attestation

透過 X509 證明。

名稱	類型	Description
caReferences	X509CAReferences	主要和次要 CA 參考。
clientCertificates	X509Certificates	主要和次要憑證
signingCertificates	X509Certificates	主要和次要憑證

X509CAReferences

主要和次要 CA 參考。

名稱	類型	Description
primary	string
secondary	string

X509CertificateInfo

X509 憑證資訊。

名稱	類型	Description
issuerName	string
notAfterUtc	string
notBeforeUtc	string
serialNumber	string
sha1Thumbprint	string
sha256Thumbprint	string
subjectName	string
version	integer

X509Certificates

主要和次要憑證

名稱	類型	Description
primary	X509CertificateWithInfo	憑證和憑證資訊
secondary	X509CertificateWithInfo	憑證和憑證資訊

X509CertificateWithInfo

憑證和憑證資訊

名稱	類型	Description
certificate	string
info	X509CertificateInfo	X509 憑證資訊。