You need to enable JavaScript to run this app.
文档中心
证书中心

证书中心

复制全文
下载 pdf
证书实例
CertificateBatchDeleteInstance - 批量删除证书实例
复制全文
下载 pdf
CertificateBatchDeleteInstance - 批量删除证书实例

调用本接口批量删除一个或多个 SSL 证书实例。

使用说明

  • 请求频率:同一个租户每秒最多允许请求20次。
  • 数量限制:单次请求支持删除的证书实例数量为 1~50 个。
  • 只有满足特定条件的证书实例允许删除。更多信息,请参见删除条件

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数
类型
是否必填
示例值
描述
Action
String

CertificateBatchDeleteInstance

要执行的操作,取值:CertificateBatchDeleteInstance。

Version
String

2024-10-01

API的版本,取值:2024-10-01。

Body

参数
类型
是否必填
示例值
描述
InstanceIds
Array of String

["cert-e3d88d0ffxxxxxxxxxxebeb2a6108cb3","cert-d1a57dcaxxxxxxxxxxxf4553a46d1ce4"]

需要删除的证书实例 ID 列表。

说明

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
InstanceIds
Array of String

["cert-e3d88d0ffxxxxxxxxxxebeb2a6108cb3"]

未成功删除的证书实例 ID 列表。
若证书实例存在云资源绑定、仍在有效期内或处于共享状态,则不会被删除,并会在该列表中返回对应的证书实例 ID。

请求示例

POST /?Action=CertificateBatchDeleteInstance&Version=2024-10-01 HTTP/1.1
Host: certificate-service.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260311T035843Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260311/cn-beijing/certificate_service/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "InstanceIds": [
    "cert-e3d88d0ffxxxxxxxxxxebeb2a6108cb3",
    "cert-d1a57dcaxxxxxxxxxxxf4553a46d1ce4"
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2026031111595014704817215304545B",
    "Action": "CertificateBatchDeleteInstance",
    "Version": "2024-10-01",
    "Service": "certificate_service",
    "Region": "cn-beijing"
  },
  "Result": {
    "InstanceIds": [
      "cert-e3d88d0ffxxxxxxxxxxebeb2a6108cb3"
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
200
Delete.Certificate

Cannot perform this operation. The certificate is referenced by other resources or still valid.

证书被其他资源引用(如负载均衡、CDN等),或者证书仍在有效期内,不符合删除策略。您需要先解绑资源或确认证书状态后再试。

400
InvalidParameter

The specified parameter %s is invalid.

指定的参数值无效。

400
MalformedRequest

The request is malformed

请求参数格式不合法。

500
InternalError

The request has failed due to an unknown error.

未知错误。

最近更新时间:2026.05.11 11:17:46
这个页面对您有帮助吗?
有用
有用
无用
无用