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

名前 / 必須 説明
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。 これは既存の証明書を更新するために必要であり、まったく新しい証明書の作成時には無視されます。

要求本文

名前 説明
certificate

string

X509 リーフ証明書の Base-64 表記.cerファイル、または .pem ファイルの内容のみ。

応答

名前 説明
200 OK

CertificateResponse

証明書が既に存在し、更新が成功した場合、操作は HTTP 状態コード 201 (OK) を返します。

Other Status Codes

ErrorDetails

既定のエラー応答。

セキュリティ

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="
}

定義

名前 説明
CertificateBodyDescription

JSON でシリアル化された X509 証明書。

CertificateProperties

X509 CA 証明書の説明。

CertificateResponse

X509 証明書。

ErrorDetails

エラーの詳細。

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

CertificateProperties

証明書のプロパティ

type

string

リソースの種類。

ErrorDetails

エラーの詳細。

名前 説明
code

string

エラー コード。

details

string

エラーの詳細です。

httpStatusCode

string

HTTP 状態コード。

message

string

エラー メッセージ。