Individual Enrollment - Get Attestation Mechanism

Serviço:

IoT Hub Device Provisioning Service

Versão da API:

2021-10-01

Obtenha o mecanismo de atestado no registro de registro do dispositivo.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
id	path	True	string	Esse id é usado para identificar exclusivamente um registro de dispositivo de uma inscrição. Uma cadeia de caracteres que não diferencia maiúsculas de minúsculas (até 128 caracteres) de caracteres alfanuméricos mais certos caracteres especiais : . _ -. Não são permitidos caracteres especiais no início ou no fim.
api-version	query	True	string	A versão da API a ser usada para a solicitação. As versões suportadas incluem: 2021-10-01

Respostas

Name	Tipo	Description
200 OK	AttestationMechanism	Sucesso
Other Status Codes	ProvisioningServiceErrorDetails	Resposta de erro Cabeçalhos x-ms-error-code: string

Definições

Name	Description
AttestationMechanism	Mecanismo de atestado para inscrição individual, bem como inscrição em grupo.
ProvisioningServiceErrorDetails	Contém as propriedades de um erro retornado pelo Serviço de Provisionamento do Hub IoT do Azure.
SymmetricKeyAttestation	Atestado via SymmetricKey.
TpmAttestation	Atestado via TPM.
X509Attestation	Atestado via X509.
X509CAReferences	Referências de AC primárias e secundárias.
X509CertificateInfo	Informações do certificado X509.
X509Certificates	Certificados primários e secundários
X509CertificateWithInfo	Informações do certificado e do certificado

AttestationMechanism

Object

Mecanismo de atestado para inscrição individual, bem como inscrição em grupo.

Name	Tipo	Description
symmetricKey	SymmetricKeyAttestation	Atestado via SymmetricKey.
tpm	TpmAttestation	Atestado via TPM.
type	enum: none symmetricKey tpm x509	Tipo de atestado.
x509	X509Attestation	Atestado via X509.

ProvisioningServiceErrorDetails

Object

Contém as propriedades de um erro retornado pelo Serviço de Provisionamento do Hub IoT do Azure.

Name	Tipo	Description
errorCode	integer (int32)
info	object
message	string
timestampUtc	string (date-time)
trackingId	string

SymmetricKeyAttestation

Object

Atestado via SymmetricKey.

Name	Tipo	Description
primaryKey	string	Chave simétrica primária.
secondaryKey	string	Chave simétrica secundária.

TpmAttestation

Object

Atestado via TPM.

Name	Tipo	Description
endorsementKey	string
storageRootKey	string

X509Attestation

Object

Atestado via X509.

Name	Tipo	Description
caReferences	X509CAReferences	Referências de AC primárias e secundárias.
clientCertificates	X509Certificates	Certificados primários e secundários
signingCertificates	X509Certificates	Certificados primários e secundários

X509CAReferences

Object

Referências de AC primárias e secundárias.

Name	Tipo	Description
primary	string
secondary	string

X509CertificateInfo

Object

Informações do certificado X509.

Name	Tipo	Description
issuerName	string
notAfterUtc	string (date-time)
notBeforeUtc	string (date-time)
serialNumber	string
sha1Thumbprint	string
sha256Thumbprint	string
subjectName	string
version	integer (int32)

X509Certificates

Object

Certificados primários e secundários

Name	Tipo	Description
primary	X509CertificateWithInfo	Informações do certificado e do certificado
secondary	X509CertificateWithInfo	Informações do certificado e do certificado

X509CertificateWithInfo

Object

Informações do certificado e do certificado

Name	Tipo	Description
certificate	string
info	X509CertificateInfo	Informações do certificado X509.