Dps Certificate - List

參考

服務:: IoT Hub Device Provisioning Service

API 版本:: 2022-12-12

取得系結至布建服務的所有憑證。

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

URI 參數

名稱	位於	必要	類型	Description
provisioningServiceName	path	True	string	要擷取憑證的布建服務名稱。
resourceGroupName	path	True	string	資源群組的名稱。
subscriptionId	path	True	string	訂用帳戶識別碼。
api-version	query	True	string	API 的版本。

回應

名稱	類型	Description
200 OK	CertificateListDescription	JSON 串行化陣列中的憑證描述清單。
Other Status Codes	ErrorDetails	默認錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

範圍

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

範例

DPSGetCertificates

範例要求

HTTP

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates?api-version=2022-12-12

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "properties": {
        "subject": "CN=testdevice1",
        "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
        "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
        "isVerified": false,
        "created": "Thu, 12 Oct 2017 19:23:50 GMT",
        "updated": "Thu, 12 Oct 2017 19:23:50 GMT",
        "certificate": "MA=="
      },
      "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/andbuc-hub/certificates/cert",
      "name": "cert",
      "type": "Microsoft.Devices/ProvisioningServices/Certificates",
      "etag": "AAAAAAExpNs="
    }
  ]
}

定義

名稱	Description
CertificateListDescription	Certificate 物件的 JSON 串行化陣列。
CertificateProperties	X509 CA 憑證的描述。
CertificateResponse	X509 憑證。
createdByType	建立資源的身分識別類型。
ErrorDetails	錯誤詳細數據。
systemData	與建立和上次修改資源相關的元數據。

CertificateListDescription

Certificate 物件的 JSON 串行化陣列。

名稱	類型	Description
value	CertificateResponse[]	Certificate 對象的陣列。

CertificateProperties

X509 CA 憑證的描述。

名稱	類型	Description
certificate	string	X509 憑證的base-64表示法.cer檔案或僅 .pem 檔案內容。
created	string	憑證的建立日期和時間。
expiry	string	憑證的到期日期和時間。
isVerified	boolean	判斷是否已驗證憑證。
subject	string	憑證的主體名稱。
thumbprint	string	憑證的指紋。
updated	string	憑證的上次更新日期和時間。

CertificateResponse

X509 憑證。

名稱	類型	Description
etag	string	實體標記。
id	string	資源標識碼。
name	string	憑證的名稱。
properties	CertificateProperties	憑證的屬性
systemData	systemData	與建立和上次修改資源相關的元數據。
type	string	資源類型。

createdByType

建立資源的身分識別類型。

名稱	類型	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

錯誤詳細數據。

名稱	類型	Description
code	integer	錯誤碼。
details	string	錯誤詳細資料。
httpStatusCode	string	HTTP 狀態碼。
message	string	錯誤訊息。

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳 (UTC) 。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳 (UTC)
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為