你当前正在访问 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 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
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。 这是更新现有证书所必需的,在创建全新证书时会被忽略。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
properties |
证书的属性 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
如果证书已存在且更新成功,则操作将返回 HTTP 状态代码 201 (正常) 。 |
|
Other Status Codes |
默认错误响应。 |
安全性
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="
}
定义
名称 | 说明 |
---|---|
Certificate |
X509 CA 证书的说明。 |
Certificate |
X509 证书。 |
created |
创建资源的标识类型。 |
Error |
错误详细信息。 |
system |
与资源的创建和上次修改相关的元数据。 |
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 |
证书的属性 |
|
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 |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |