API 名称：DeleteCertificate。
API 域名：open.volcengineapi.com。
API 描述：删除未关联监听器的证书。
节流限制：每秒最多提交 5 个 API 请求。
在使用该部分 API 提交请求时必须包含以下 URI 参数。
除了 URI 参数，该 API 请求还需要包含签名参数。关于更多签名参数的信息，参见公共请求参数。
| 名称 | 类型 | 是否必选 | 格式 | 说明 |
|---|---|---|---|---|
| Action | string | 是 | [a-zA-Z]+ | API 名称，如 DeleteCertificate 。 |
| Version | string | 是 | YYYY-MM-DD | API 版本信息。该参数的取值是 2020-04-01 。 |
| X-Expires | int | 否 | 900 | 表示签名的有效时间，单位是秒，默认值是900。 |
在使用该 API 提交请求时，请求参数中可以包含的参数如下。
| 参数 | 类型 | 是否必选 | 参数说明 | 示例值 |
|---|---|---|---|---|
| CertificateId | String | 是 | 待删除的证书ID。 | cert-***** |
| 参数 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|
| RequestId | String | 请求ID。 | 20210816110638****2514606306AF947C |
GET /?Action=DeleteCertificate&CertificateId=cert-123***765&Version=2020-04-01 HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing ServiceName: alb
{ "ResponseMetadata": { "RequestId": "20210816110638****2514606306AF947C", "Action": "DeleteCertificate", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210816110638****2514606306AF947C" } }
如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见公共错误码。
| HTTP Code | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
400 | InvalidCertificateType.FunctionMismatch | The specified Certificate's type and Function do not match. | 指定的证书的类型与预期功能不匹配。 |
400 | InvalidServerCertificateListener.InUse | The specified Server Certificate is being used by listeners. | 指定的服务器证书正在被监听器使用。 |
400 | InvalidCertificate.InvalidStatus | The specified Certificate is not in the correct status for the request. | 指定的证书所处状态无法响应该请求。 |
400 | OperationFailed.RemoveFromProjectFailed | The request on the specified resource failed due to removing it from the project failed. | 因将资源从项目中移除失败，对于该资源的操作请求失败。 |
404 | InvalidServerCertificate.NotFound | The specified Server Certificate does not exist. | 指定的服务器证书不存在。 |