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 パラメーター

名前	/	必須	型	説明
certificateName	path	True	string	証明書の作成または更新の名前。
provisioningServiceName	path	True	string	プロビジョニングサービスの名前。
resourceGroupName	path	True	string	リソースグループ識別子。
subscriptionId	path	True	string	サブスクリプションの識別子です。
api-version	query	True	string	API のバージョン。

要求ヘッダー

名前	必須	型	説明
If-Match		string	証明書の ETag。これは既存の証明書を更新するために必要であり、まったく新しい証明書の作成時には無視されます。

要求本文

名前	型	説明
properties	CertificateProperties	証明書のプロパティ

応答

名前	型	説明
200 OK	CertificateResponse	証明書が既に存在し、更新が成功した場合、操作は HTTP 状態コード 201 (OK) を返します。
Other Status Codes	ErrorDetails	既定のエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
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="
}

定義

名前	説明
CertificateProperties	X509 CA 証明書の説明。
CertificateResponse	X509 証明書。
createdByType	リソースを作成した ID の種類。
ErrorDetails	エラーの詳細。
systemData	リソースの作成と最後の変更に関連するメタデータ。

CertificateProperties

X509 CA 証明書の説明。

名前	型	説明
certificate	string	X509 証明書の base-64 表現.cerファイル、または .pem ファイルの内容のみ。
created	string	証明書の作成日時。
expiry	string	証明書の有効期限の日付と時刻。
isVerified	boolean	証明書が検証済みかどうかを判断します。
subject	string	証明書のサブジェクト名。
thumbprint	string	証明書のサムプリント。
updated	string	証明書の最終更新日時。

CertificateResponse

X509 証明書。

名前	型	説明
etag	string	エンティティタグ。
id	string	リソース識別子。
name	string	証明書の名前。
properties	CertificateProperties	証明書のプロパティ
systemData	systemData	リソースの作成と最後の変更に関連するメタデータ。
type	string	リソースの種類。

createdByType

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

エラーの詳細。

名前	型	説明
code	integer	エラーコード。
details	string	エラーの詳細です。
httpStatusCode	string	HTTP 状態コード。
message	string	エラーメッセージ。

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有