通过

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

Dps Certificate - Delete

  • 参考
服务:
IoT Hub Device Provisioning Service
API 版本:
2022-12-12

删除预配服务证书。
删除与预配服务关联的指定证书

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?api-version=2022-12-12
具有可选参数: 
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&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 的版本。
certificate.created
 query

string

date-time

创建证书的时间。
certificate.hasPrivateKey
 query

boolean

指示证书是否包含私钥。
certificate.isVerified
 query

boolean

指示证书是否已由私钥的所有者验证。
certificate.lastUpdated
 query

string

date-time

上次更新证书的时间。
certificate.name
 query

string

这是可选的，它是证书的公用名。
certificate.nonce
 query

string

为指示所有权证明而生成的随机数。
certificate.purpose
 query

CertificatePurpose

提及证书用途的说明。
certificate.rawBytes
 query

string

byte

证书中的原始数据。

请求头

名称 必需 类型 说明
If-Match True

string

证书的 ETag

响应

名称 类型 说明
200 OK

没问题。
204 No Content

无内容。
Other Status Codes

ErrorDetails

默认错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

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

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

DPSDeleteCertificate

示例请求

DELETE https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&api-version=2022-12-12

示例响应

状态代码:
200
状态代码:
204

定义

名称 说明
CertificatePurpose

提及证书用途的说明。
ErrorDetails

错误详细信息。

CertificatePurpose

提及证书用途的说明。

名称 类型 说明
clientAuthentication

string

serverAuthentication

string

ErrorDetails

错误详细信息。

名称 类型 说明
code

integer

错误代码。
details

string

错误详细信息。
httpStatusCode

string

HTTP 状态代码。
message

string

错误消息。