Dps Certificate - Create Or Update
証明書をプロビジョニング サービスにアップロードします。
新しい証明書を追加するか、既存の証明書を更新します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?api-version=2018-01-22
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
certificate
|
path | True |
string |
証明書の作成または更新の名前。 |
provisioning
|
path | True |
string |
プロビジョニング サービスの名前。 |
resource
|
path | True |
string |
リソース グループ識別子。 |
subscription
|
path | True |
string |
サブスクリプションの識別子です。 |
api-version
|
query | True |
string |
API のバージョン。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
If-Match |
string |
証明書の ETag。 これは既存の証明書を更新するために必要であり、まったく新しい証明書の作成時には無視されます。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
certificate |
string |
X509 リーフ証明書の Base-64 表記.cerファイル、または .pem ファイルの内容のみ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
証明書が既に存在し、更新が成功した場合、操作は HTTP 状態コード 201 (OK) を返します。 |
|
Other Status Codes |
既定のエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
DPSCreateOrUpdateCertificate
Sample Request
PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert?api-version=2018-01-22
{
"certificate": "############################################"
}
Sample Response
{
"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"
},
"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="
}
定義
名前 | 説明 |
---|---|
Certificate |
JSON でシリアル化された X509 証明書。 |
Certificate |
X509 CA 証明書の説明。 |
Certificate |
X509 証明書。 |
Error |
エラーの詳細。 |
CertificateBodyDescription
JSON でシリアル化された X509 証明書。
名前 | 型 | 説明 |
---|---|---|
certificate |
string |
X509 リーフ証明書の Base-64 表記.cerファイル、または .pem ファイルの内容のみ。 |
CertificateProperties
X509 CA 証明書の説明。
名前 | 型 | 説明 |
---|---|---|
created |
string |
証明書の作成日時。 |
expiry |
string |
証明書の有効期限の日付と時刻。 |
isVerified |
boolean |
証明書が検証済みかどうかを判断します。 |
subject |
string |
証明書のサブジェクト名。 |
thumbprint |
string |
証明書のサムプリント。 |
updated |
string |
証明書の最終更新日時。 |
CertificateResponse
X509 証明書。
名前 | 型 | 説明 |
---|---|---|
etag |
string |
エンティティ タグ。 |
id |
string |
リソース識別子。 |
name |
string |
証明書の名前。 |
properties |
証明書のプロパティ |
|
type |
string |
リソースの種類。 |
ErrorDetails
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラー コード。 |
details |
string |
エラーの詳細です。 |
httpStatusCode |
string |
HTTP 状態コード。 |
message |
string |
エラー メッセージ。 |