你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Individual Enrollment - Get Attestation Mechanism

服务:

IoT Hub Device Provisioning Service

API 版本:

2021-10-01

获取设备注册记录中的证明机制。

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

URI 参数

名称	在	必需	类型	说明
id	path	True	string	此 ID 用于唯一标识注册的设备注册。 不区分大小写的字符串（最多 128 个字符长）的字母数字字符加上某些特殊字符： _ -. 开头或结尾不允许使用特殊字符。
api-version	query	True	string	要用于请求的 API 版本。 支持的版本包括：2021-10-01

响应

名称	类型	说明
200 OK	AttestationMechanism	成功
Other Status Codes	ProvisioningServiceErrorDetails	错误响应 标头 x-ms-error-code: string

定义

名称	说明
AttestationMechanism	单个Enrollment 和 enrollmentGroup 的证明机制。
ProvisioningServiceErrorDetails	包含 Azure IoT 中心预配服务返回的错误的属性。
SymmetricKeyAttestation	通过 SymmetricKey 证明。
TpmAttestation	通过 TPM 证明。
X509Attestation	通过 X509 证明。
X509CAReferences	主要和辅助 CA 引用。
X509CertificateInfo	X509 证书信息。
X509Certificates	主证书和辅助证书
X509CertificateWithInfo	证书和证书信息

AttestationMechanism

Object

单个Enrollment 和 enrollmentGroup 的证明机制。

名称	类型	说明
symmetricKey	SymmetricKeyAttestation	通过 SymmetricKey 证明。
tpm	TpmAttestation	通过 TPM 证明。
type	enum: none symmetricKey tpm x509	证明类型。
x509	X509Attestation	通过 X509 证明。

ProvisioningServiceErrorDetails

Object

包含 Azure IoT 中心预配服务返回的错误的属性。

名称	类型	说明
errorCode	integer (int32)
info	object
message	string
timestampUtc	string (date-time)
trackingId	string

SymmetricKeyAttestation

Object

通过 SymmetricKey 证明。

名称	类型	说明
primaryKey	string	主对称密钥。
secondaryKey	string	辅助对称密钥。

TpmAttestation

Object

通过 TPM 证明。

名称	类型	说明
endorsementKey	string
storageRootKey	string

X509Attestation

Object

通过 X509 证明。

名称	类型	说明
caReferences	X509CAReferences	主要和辅助 CA 引用。
clientCertificates	X509Certificates	主证书和辅助证书
signingCertificates	X509Certificates	主证书和辅助证书

X509CAReferences

Object

主要和辅助 CA 引用。

名称	类型	说明
primary	string
secondary	string

X509CertificateInfo

Object

X509 证书信息。

名称	类型	说明
issuerName	string
notAfterUtc	string (date-time)
notBeforeUtc	string (date-time)
serialNumber	string
sha1Thumbprint	string
sha256Thumbprint	string
subjectName	string
version	integer (int32)

X509Certificates

Object

主证书和辅助证书

名称	类型	说明
primary	X509CertificateWithInfo	证书和证书信息
secondary	X509CertificateWithInfo	证书和证书信息

X509CertificateWithInfo

Object

证书和证书信息

名称	类型	说明
certificate	string
info	X509CertificateInfo	X509 证书信息。