共用方式為


Certificates - Verify

確認憑證的私鑰擁有權。
提供驗證預先上傳憑證所簽發的分葉憑證,以驗證憑證的私鑰擁有權。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates/{certificateName}/verify?api-version=2023-06-30

URI 參數

名稱 位於 必要 類型 Description
certificateName
path True

string

憑證的名稱

Regex 模式: ^[A-Za-z0-9-._]{1,64}$

resourceGroupName
path True

string

包含IoT中樞的資源群組名稱。

resourceName
path True

string

IoT 中樞的名稱。

subscriptionId
path True

string

訂用帳戶識別碼。

api-version
query True

string

API 的版本。

要求標頭

名稱 必要 類型 Description
If-Match True

string

憑證的 ETag。

要求本文

名稱 類型 Description
certificate

string

x509 憑證的base-64表示法.cer檔案或 .pem 檔案內容。

回應

名稱 類型 Description
200 OK

CertificateDescription

本文包含憑證。

Other Status Codes

ErrorDetails

DefaultErrorResponse

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Certificates_Verify

範例要求

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/myFirstProvisioningService/certificates/cert/verify?api-version=2023-06-30


{
  "certificate": "#####################################"
}

範例回覆

{
  "properties": {
    "subject": "CN=andbucdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": true,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:26:56 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/IotHubs/Certificates",
  "etag": "AAAAAAExpTQ="
}

定義

名稱 Description
CertificateDescription

X509 憑證。

CertificateProperties

X509 CA 憑證的描述。

CertificateVerificationDescription

JSON 串行化的分葉憑證

ErrorDetails

錯誤詳細數據。

CertificateDescription

X509 憑證。

名稱 類型 Description
etag

string

實體標記。

id

string

資源標識碼。

name

string

憑證的名稱。

properties

CertificateProperties

X509 CA 憑證的描述。

type

string

資源類型。

CertificateProperties

X509 CA 憑證的描述。

名稱 類型 Description
certificate

string

憑證內容

created

string

憑證的建立日期和時間。

expiry

string

憑證的到期日期和時間。

isVerified

boolean

判斷是否已驗證憑證。

subject

string

憑證的主體名稱。

thumbprint

string

憑證的指紋。

updated

string

憑證的上次更新日期和時間。

CertificateVerificationDescription

JSON 串行化的分葉憑證

名稱 類型 Description
certificate

string

x509 憑證的base-64表示法.cer檔案或 .pem 檔案內容。

ErrorDetails

錯誤詳細數據。

名稱 類型 Description
code

string

錯誤碼。

details

string

錯誤詳細資料。

httpStatusCode

string

HTTP 狀態碼。

message

string

錯誤訊息。