Individual Enrollment - Get Attestation Mechanism

Usługa:

IoT Hub Device Provisioning Service

Wersja interfejsu API:

2021-10-01

Pobierz mechanizm zaświadczania w rekordzie rejestracji urządzenia.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
id	path	True	string	Ten identyfikator służy do unikatowego identyfikowania rejestracji urządzenia w ramach rejestracji. Ciąg bez uwzględniania wielkości liter (maksymalnie 128 znaków) znaków alfanumerycznych oraz niektóre znaki specjalne: . _ -. Brak znaków specjalnych dozwolonych na początku lub na końcu.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania. Obsługiwane wersje to: 2021-10-01

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AttestationMechanism	Powodzenie
Other Status Codes	ProvisioningServiceErrorDetails	Odpowiedź na błąd Nagłówki x-ms-error-code: string

Definicje

Nazwa	Opis
AttestationMechanism	Mechanizm zaświadczania dla poszczególnych Rejestracji, a także enrollmentGroup.
ProvisioningServiceErrorDetails	Zawiera właściwości błędu zwróconego przez usługę Azure IoT Hub Provisioning Service.
SymmetricKeyAttestation	Zaświadczenie za pomocą klucza symetrycznego.
TpmAttestation	Zaświadczenie za pośrednictwem modułu TPM.
X509Attestation	Zaświadczenie za pośrednictwem X509.
X509CAReferences	Odwołania do podstawowego i pomocniczego urzędu certyfikacji.
X509CertificateInfo	Informacje o certyfikacie X509.
X509Certificates	Certyfikaty podstawowe i pomocnicze
X509CertificateWithInfo	Informacje o certyfikacie i certyfikacie

AttestationMechanism

Mechanizm zaświadczania dla poszczególnych Rejestracji, a także enrollmentGroup.

Nazwa	Typ	Opis
symmetricKey	SymmetricKeyAttestation	Zaświadczenie za pomocą klucza symetrycznego.
tpm	TpmAttestation	Zaświadczenie za pośrednictwem modułu TPM.
type	enum: none symmetricKey tpm x509	Typ zaświadczania.
x509	X509Attestation	Zaświadczenie za pośrednictwem X509.

ProvisioningServiceErrorDetails

Zawiera właściwości błędu zwróconego przez usługę Azure IoT Hub Provisioning Service.

Nazwa	Typ	Opis
errorCode	integer
info	object
message	string
timestampUtc	string
trackingId	string

SymmetricKeyAttestation

Zaświadczenie za pomocą klucza symetrycznego.

Nazwa	Typ	Opis
primaryKey	string	Podstawowy klucz symetryczny.
secondaryKey	string	Pomocniczy klucz symetryczny.

TpmAttestation

Zaświadczenie za pośrednictwem modułu TPM.

Nazwa	Typ	Opis
endorsementKey	string
storageRootKey	string

X509Attestation

Zaświadczenie za pośrednictwem X509.

Nazwa	Typ	Opis
caReferences	X509CAReferences	Odwołania do podstawowego i pomocniczego urzędu certyfikacji.
clientCertificates	X509Certificates	Certyfikaty podstawowe i pomocnicze
signingCertificates	X509Certificates	Certyfikaty podstawowe i pomocnicze

X509CAReferences

Odwołania do podstawowego i pomocniczego urzędu certyfikacji.

Nazwa	Typ	Opis
primary	string
secondary	string

X509CertificateInfo

Informacje o certyfikacie X509.

Nazwa	Typ	Opis
issuerName	string
notAfterUtc	string
notBeforeUtc	string
serialNumber	string
sha1Thumbprint	string
sha256Thumbprint	string
subjectName	string
version	integer

X509Certificates

Certyfikaty podstawowe i pomocnicze

Nazwa	Typ	Opis
primary	X509CertificateWithInfo	Informacje o certyfikacie i certyfikacie
secondary	X509CertificateWithInfo	Informacje o certyfikacie i certyfikacie

X509CertificateWithInfo

Informacje o certyfikacie i certyfikacie

Nazwa	Typ	Opis
certificate	string
info	X509CertificateInfo	Informacje o certyfikacie X509.