Dps Certificate - Create Or Update

參考

服務:: IoT Hub Device Provisioning Service

API 版本:: 2022-12-12

將憑證上傳至布建服務。
新增憑證或更新現有的憑證。

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

URI 參數

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

要求標頭

名稱	必要	類型	Description
If-Match		string	憑證的 ETag。這是更新現有憑證的必要專案，並在建立全新的憑證時予以忽略。

要求本文

名稱	類型	Description
properties	CertificateProperties	憑證的屬性

回應

名稱	類型	Description
200 OK	CertificateResponse	如果憑證已經存在且更新成功，作業會傳回 HTTP 狀態代碼 201 (OK) 。
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	模擬您的用戶帳戶

範例

DPSCreateOrUpdateCertificate

範例要求

HTTP

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

{
  "properties": {
    "certificate": "MA=="
  }
}

範例回覆

狀態碼:: 200

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

定義

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

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	上次修改資源的身分識別類型。

共用方式為