Dps Certificate - Generate Verification Code

Referencia

Szolgáltatás:: IoT Hub Device Provisioning Service

API-verzió:: 2022-12-12

Ellenőrzési kód létrehozása a birtoklás igazolásához.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/generateVerificationCode?api-version=2022-12-12

Opcionális paraméterekkel:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/generateVerificationCode?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&api-version=2022-12-12

URI-paraméterek

Name	In	Kötelező	Típus	Description
certificateName	path	True	string	A tanúsítvány kötelező logikai neve, amelyet a kiépítési szolgáltatás a hozzáféréshez használ.
provisioningServiceName	path	True	string	A kiépítési szolgáltatás neve.
resourceGroupName	path	True	string	erőforráscsoport neve.
subscriptionId	path	True	string	Az előfizetés azonosítója.
api-version	query	True	string	Az API verziója.
certificate.created	query		string date-time	Tanúsítványlétrehozás ideje.
certificate.hasPrivateKey	query		boolean	Azt jelzi, hogy a tanúsítvány tartalmaz-e titkos kulcsot.
certificate.isVerified	query		boolean	Azt jelzi, hogy a tanúsítványt a titkos kulcs tulajdonosa ellenőrizte-e.
certificate.lastUpdated	query		string date-time	A tanúsítvány utolsó frissítésének időpontja.
certificate.name	query		string	A tanúsítvány köznapi neve.
certificate.nonce	query		string	Véletlenszerűen generált szám, amely a birtoklás igazolására szolgál.
certificate.purpose	query		CertificatePurpose	A tanúsítvány célját megemlítő leírás.
certificate.rawBytes	query		string byte	A tanúsítvány nyers adatai.

Kérelem fejléce

Name	Kötelező	Típus	Description
If-Match	True	string	A tanúsítvány ETagje. Ez szükséges egy meglévő tanúsítvány frissítéséhez, és figyelmen kívül hagyva egy teljesen új tanúsítvány létrehozásakor.

Válaszok

Name	Típus	Description
200 OK	VerificationCodeResponse	A rendszer visszaadja a tanúsítványhoz létrehozott ellenőrző kódot.
Other Status Codes	ErrorDetails	Alapértelmezett hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

DPSGenerateVerificationCode

Mintakérelem

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert/generateVerificationCode?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&api-version=2022-12-12

Mintaválasz

Állapotkód:: 200

{
  "name": "cert",
  "properties": {
    "verificationCode": "##################################",
    "subject": "CN=andbucdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "thumbprint": "##############################",
    "certificate": "MA==",
    "isVerified": false,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:26:56 GMT"
  }
}

Definíciók

Name	Description
CertificatePurpose	A tanúsítvány célját megemlítő leírás.
ErrorDetails	Hiba részletei.
Properties
VerificationCodeResponse	Az ellenőrző kód válaszának leírása.

CertificatePurpose

A tanúsítvány célját megemlítő leírás.

Name	Típus	Description
clientAuthentication	string
serverAuthentication	string

ErrorDetails

Hiba részletei.

Name	Típus	Description
code	integer	A hibakód.
details	string	A hiba részletei.
httpStatusCode	string	A HTTP-állapotkód.
message	string	A hibaüzenet.

Properties

Name	Típus	Description
certificate	string	Az X509-tanúsítvány base-64-es reprezentációja .cer fájl vagy csak .pem fájltartalom.
created	string	Tanúsítvány létrehozási ideje.
expiry	string	A kód lejárata.
isVerified	boolean	Jelezze, hogy a tanúsítványt a titkos kulcs tulajdonosa ellenőrizte-e.
subject	string	Tanúsítvány tárgya.
thumbprint	string	Tanúsítvány ujjlenyomata.
updated	string	Tanúsítvány frissítési ideje.
verificationCode	string	Ellenőrző kód.

VerificationCodeResponse

Az ellenőrző kód válaszának leírása.

Name	Típus	Description
etag	string	Etag kérése.
id	string	Az erőforrás azonosítója.
name	string	A tanúsítvány neve.
properties	Properties
type	string	Az erőforrás típusa.

Megosztás a következőn keresztül: