Dps Certificate - Generate Verification Code

Referensi

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Hasilkan kode verifikasi untuk Bukti Kepemilikan.

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

With optional 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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
certificateName	path	True	string	Nama logis wajib sertifikat, yang digunakan layanan provisi untuk mengakses.
provisioningServiceName	path	True	string	Nama layanan provisi.
resourceGroupName	path	True	string	nama grup sumber daya.
subscriptionId	path	True	string	Pengidentifikasi langganan.
api-version	query	True	string	Versi API.
certificate.created	query		string date-time	Waktu pembuatan sertifikat.
certificate.hasPrivateKey	query		boolean	Menunjukkan apakah sertifikat berisi kunci privat.
certificate.isVerified	query		boolean	Menunjukkan apakah sertifikat telah diverifikasi oleh pemilik kunci privat.
certificate.lastUpdated	query		string date-time	Waktu terakhir diperbarui sertifikat.
certificate.name	query		string	Nama Umum untuk sertifikat.
certificate.nonce	query		string	Angka acak yang dihasilkan untuk menunjukkan Bukti Kepemilikan.
certificate.purpose	query		CertificatePurpose	Deskripsi yang menyebutkan tujuan sertifikat.
certificate.rawBytes	query		string byte	Data mentah sertifikat.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
If-Match	True	string	ETag sertifikat. Ini diperlukan untuk memperbarui sertifikat yang ada, dan diabaikan saat membuat sertifikat baru.

Respons

Nama	Jenis	Deskripsi
200 OK	VerificationCodeResponse	Kode verifikasi yang dihasilkan untuk sertifikat tersebut dikembalikan.
Other Status Codes	ErrorDetails	Respons kesalahan default.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

DPSGenerateVerificationCode

Sample Request

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

Sample Response

Status code:: 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"
  }
}

Definisi

Nama	Deskripsi
CertificatePurpose	Deskripsi yang menyebutkan tujuan sertifikat.
ErrorDetails	Detail kesalahan.
Properties
VerificationCodeResponse	Deskripsi respons kode verifikasi.

CertificatePurpose

Deskripsi yang menyebutkan tujuan sertifikat.

Nama	Jenis	Deskripsi
clientAuthentication	string
serverAuthentication	string

ErrorDetails

Detail kesalahan.

Nama	Jenis	Deskripsi
code	integer	Kode kesalahan.
details	string	Detail kesalahan.
httpStatusCode	string	Kode status HTTP.
message	string	Pesan kesalahan.

Properties

Nama	Jenis	Deskripsi
certificate	string	representasi base-64 dari sertifikat X509 .cer file atau hanya konten file .pem.
created	string	Waktu pembuatan sertifikat.
expiry	string	Kode kedaluwarsa.
isVerified	boolean	Tunjukkan apakah sertifikat diverifikasi oleh pemilik kunci privat.
subject	string	Subjek sertifikat.
thumbprint	string	Thumbprint sertifikat.
updated	string	Waktu pembaruan sertifikat.
verificationCode	string	Kode verifikasi.

VerificationCodeResponse

Deskripsi respons kode verifikasi.

Nama	Jenis	Deskripsi
etag	string	Permintaan etag.
id	string	Pengidentifikasi sumber daya.
name	string	Nama sertifikat.
properties	Properties
type	string	Jenis sumber daya.

Share via