Dps Certificate - Generate Verification Code

Referensi

Layanan:: IoT Hub Device Provisioning Service

Versi API:: 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

Dengan parameter opsional:

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.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

DPSGenerateVerificationCode

Permintaan sampel

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

Respon sampel

Kode status:: 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.

Bagikan melalui