Dps Certificate - Generate Verification Code

Başvuru

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Sahiplik Kanıtı için doğrulama kodu oluşturun.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
certificateName	path	True	string	Sağlama hizmetinin erişmek için kullandığı sertifikanın zorunlu mantıksal adı.
provisioningServiceName	path	True	string	Sağlama hizmetinin adı.
resourceGroupName	path	True	string	kaynak grubunun adı.
subscriptionId	path	True	string	Abonelik tanımlayıcısı.
api-version	query	True	string	API'nin sürümü.
certificate.created	query		string date-time	Sertifika oluşturma zamanı.
certificate.hasPrivateKey	query		boolean	Sertifikanın özel anahtar içerip içermediğini gösterir.
certificate.isVerified	query		boolean	Sertifikanın özel anahtarın sahibi tarafından doğrulanmış olup olmadığını gösterir.
certificate.lastUpdated	query		string date-time	Sertifika son güncelleştirme zamanı.
certificate.name	query		string	Sertifikanın Ortak Adı.
certificate.nonce	query		string	Sahiplik Kanıtını göstermek için rastgele sayı oluşturuldu.
certificate.purpose	query		CertificatePurpose	Sertifikanın amacından bahseden açıklama.
certificate.rawBytes	query		string byte	Sertifikanın ham verileri.

İstek Başlığı

Name	Gerekli	Tür	Description
If-Match	True	string	Sertifikanın ETag'i. Bu, mevcut bir sertifikayı güncelleştirmek için gereklidir ve yepyeni bir sertifika oluşturulurken yoksayılır.

Yanıtlar

Name	Tür	Description
200 OK	VerificationCodeResponse	Bu sertifika için oluşturulan doğrulama kodu döndürülür.
Other Status Codes	ErrorDetails	Varsayılan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

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

Tanımlar

Name	Description
CertificatePurpose	Sertifikanın amacından bahseden açıklama.
ErrorDetails	Hata ayrıntıları.
Properties
VerificationCodeResponse	Doğrulama kodunun yanıtının açıklaması.

CertificatePurpose

Sertifikanın amacından bahseden açıklama.

Name	Tür	Description
clientAuthentication	string
serverAuthentication	string

ErrorDetails

Hata ayrıntıları.

Name	Tür	Description
code	integer	Hata kodu.
details	string	Hata ayrıntıları.
httpStatusCode	string	HTTP durum kodu.
message	string	Hata iletisi.

Properties

Name	Tür	Description
certificate	string	X509 sertifikası .cer dosyasının temel 64 gösterimi veya yalnızca .pem dosyası içeriği.
created	string	Sertifika oluşturma zamanı.
expiry	string	Kod süre sonu.
isVerified	boolean	Sertifikanın özel anahtarın sahibi tarafından doğrulanmış olup olmadığını belirtin.
subject	string	Sertifika konusu.
thumbprint	string	Sertifika parmak izi.
updated	string	Sertifika güncelleştirme zamanı.
verificationCode	string	Doğrulama kodu.

VerificationCodeResponse

Doğrulama kodunun yanıtının açıklaması.

Name	Tür	Description
etag	string	Etag isteyin.
id	string	Kaynak tanımlayıcısı.
name	string	Sertifikanın adı.
properties	Properties
type	string	Kaynak türü.