调用DeleteDeviceCertificate删除已在云消息队列 MQTT 版服务端注册的设备证书。删除设备证书表示将指定的设备证书的注册信息从服务端的存储记录中删除，并非将证书内容直接删掉。

背景信息

设备证书是由CA根证书签发给客户端设备使用的数字证书，用于客户端和服务端连接时，服务端对客户端进行安全认证。认证通过后服务端和客户端可基于证书内的加密密钥进行安全通信，若认证不通过则服务端拒绝客户端接入。更多信息，请参见客户端证书认证。

使用限制

  • 仅铂金版实例支持使用DeleteDeviceCertificate接口。
  • 单用户请求频率限制为500次/秒。如有特殊需求，请联系云消息队列 MQTT 版技术支持，钉钉群号：35228338。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DeleteDeviceCertificate

系统规定参数。取值：DeleteDeviceCertificate。
MqttInstanceId String 是 post-cn-7mz2d******

设备证书所绑定的实例ID，即云消息队列 MQTT 版的实例ID。
DeviceSn String 是 356217374433****

待删除设备证书的SN序列号，用于唯一标识一个设备证书。

取值范围：不超过128 Byte。
CaSn String 是 007269004887******

设备证书所属的CA证书的序列号，用于唯一标识一个CA证书。CA证书用于验证设备证书的正确性。

取值范围：不超过128 Byte。

返回数据

名称 类型 示例值 描述
RequestId String 020F6A43-19E6-4B6E-B846-44EB31DF****

公共参数，每个请求的ID都是唯一的，可用于排查和定位问题。
DeviceSn String 356217374433******

已删除设备证书的SN序列号，用于唯一标识一个设备证书。

示例

请求示例

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/?Action=DeleteDeviceCertificate
&MqttInstanceId=post-cn-7mz2d******
&DeviceSn=356217374433******
&CaSn=007269004887******
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteDeviceCertificateResponse>
    <RequestId>020F6A43-19E6-4B6E-B846-44EB31DF****</RequestId>
    <DeviceSn>356217374433******</DeviceSn>
</DeleteDeviceCertificateResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "020F6A43-19E6-4B6E-B846-44EB31DF****",
  "DeviceSn" : "356217374433******"
}

错误码

HttpCode 错误码 错误信息 描述
400 ParameterFieldCheckFailed Failed to validate the parameters. The parameters may be missing or invalid. 参数校验失败，可能缺失或者传入值非法。
500 FindDeviceBySnError Failed to find the device certificate by the SN. Please check sn is valid 获取设备证书失败
500 MqttInstanceNotFound Specified instance is not found 实例不存在
500 MqttOwnerCheckError Failed to validate the instance permission 实例权限校验失败

访问错误中心查看更多错误码。

控制台操作

除了调用DeleteDeviceCertificate接口，您还可以通过微消息队列MQTT版控制台删除设备证书。具体操作，请参见设备证书管理。