你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Dps Certificate - Create Or Update

将证书上传到预配服务。
添加新证书或更新现有证书。

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 (正常) 。

Other Status Codes

ErrorDetails

默认错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

DPSCreateOrUpdateCertificate

示例请求

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

示例响应

{
  "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

创建资源的标识类型。

ErrorDetails

错误详细信息。

systemData

与资源的创建和上次修改相关的元数据。

CertificateProperties

X509 CA 证书的说明。

名称 类型 说明
certificate

string

x509 证书.cer文件或仅 .pem 文件内容的 base-64 表示形式。

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

创建资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDetails

错误详细信息。

名称 类型 说明
code

integer

错误代码。

details

string

错误详细信息。

httpStatusCode

string

HTTP 状态代码。

message

string

错误消息。

systemData

与资源的创建和上次修改相关的元数据。

名称 类型 说明
createdAt

string

资源创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源上次修改的时间戳 (UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识类型。