调用本接口批量删除一个或多个 SSL 证书实例。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | CertificateBatchDeleteInstance | 要执行的操作,取值:CertificateBatchDeleteInstance。 |
Version | String | 是 | 2024-10-01 | API的版本,取值:2024-10-01。 |
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
InstanceIds | Array of String | 是 | ["cert-e3d88d0ffxxxxxxxxxxebeb2a6108cb3","cert-d1a57dcaxxxxxxxxxxxf4553a46d1ce4"] | 需要删除的证书实例 ID 列表。 说明
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
InstanceIds | Array of String | ["cert-e3d88d0ffxxxxxxxxxxebeb2a6108cb3"] | 未成功删除的证书实例 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 | 证书被其他资源引用(如负载均衡、CDN等),或者证书仍在有效期内,不符合删除策略。您需要先解绑资源或确认证书状态后再试。 |
400 | InvalidParameter | 指定的参数值无效。 |
400 | MalformedRequest | 请求参数格式不合法。 |
500 | InternalError | 未知错误。 |