Dps Certificate - Generate Verification Code

Referentie

Service:: IoT Hub Device Provisioning Service

API-versie:: 2022-12-12

Verificatiecode genereren voor bewijs van bezit.

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
certificateName	path	True	string	De verplichte logische naam van het certificaat, die de inrichtingsservice gebruikt om toegang te krijgen.
provisioningServiceName	path	True	string	Naam van de inrichtingsservice.
resourceGroupName	path	True	string	naam van resourcegroep.
subscriptionId	path	True	string	De abonnements-id.
api-version	query	True	string	De versie van de API.
certificate.created	query		string date-time	De aanmaaktijd van het certificaat.
certificate.hasPrivateKey	query		boolean	Geeft aan of het certificaat een persoonlijke sleutel bevat.
certificate.isVerified	query		boolean	Geeft aan of het certificaat is geverifieerd door de eigenaar van de persoonlijke sleutel.
certificate.lastUpdated	query		string date-time	Tijdstip waarop het certificaat voor het laatst is bijgewerkt.
certificate.name	query		string	Algemene naam voor het certificaat.
certificate.nonce	query		string	Willekeurig getal dat wordt gegenereerd om het bewijs van bezit aan te geven.
certificate.purpose	query		CertificatePurpose	Beschrijving met vermelding van het doel van het certificaat.
certificate.rawBytes	query		string byte	Onbewerkte gegevens van het certificaat.

Aanvraagkoptekst

Name	Vereist	Type	Description
If-Match	True	string	ETag van het certificaat. Dit is vereist om een bestaand certificaat bij te werken en wordt genegeerd tijdens het maken van een gloednieuw certificaat.

Antwoorden

Name	Type	Description
200 OK	VerificationCodeResponse	Gegenereerde verificatiecode voor dat certificaat wordt geretourneerd.
Other Status Codes	ErrorDetails	Standaardfoutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

DPSGenerateVerificationCode

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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"
  }
}

Definities

Name	Description
CertificatePurpose	Beschrijving met vermelding van het doel van het certificaat.
ErrorDetails	Foutdetails.
Properties
VerificationCodeResponse	Beschrijving van het antwoord van de verificatiecode.

CertificatePurpose

Beschrijving met vermelding van het doel van het certificaat.

Name	Type	Description
clientAuthentication	string
serverAuthentication	string

ErrorDetails

Foutdetails.

Name	Type	Description
code	integer	De foutcode.
details	string	De foutdetails.
httpStatusCode	string	De HTTP-statuscode.
message	string	Het foutbericht.

Properties

Name	Type	Description
certificate	string	base-64-weergave van X509-certificaat .cer bestand of alleen .pem-bestandsinhoud.
created	string	Tijdstip waarop het certificaat is gemaakt.
expiry	string	Verlopen van code.
isVerified	boolean	Geef aan of het certificaat is geverifieerd door de eigenaar van de persoonlijke sleutel.
subject	string	Certificaatonderwerp.
thumbprint	string	Vingerafdruk van certificaat.
updated	string	Tijdstip waarop het certificaat is bijgewerkt.
verificationCode	string	Verificatiecode.

VerificationCodeResponse

Beschrijving van het antwoord van de verificatiecode.

Name	Type	Description
etag	string	ETag aanvragen.
id	string	De resource-id.
name	string	Naam van certificaat.
properties	Properties
type	string	Het resourcetype.

Delen via