调用 ReplaceCACertificate 接口，替换 CA 证书。 ## 使用说明每秒最多提交 5 个 API 请求。 ## 调试 ## 请求参数 **Action** String %%require%% `示例值：ReplaceCACertificate` 接口名称。当前 API 的名称为 `ReplaceCACertificate`。 **Version** String %%require%% `示例值：2020-04-01` 接口版本。当前 API 的版本为 `2020-04-01`。 **OldCACertificateId** String %%require%% `示例值：cert-123***765` 需要被替换的CA证书的ID。 **UpdateMode** String %%require%% `示例值：new` 替换证书的模式。取值如下： * new：上传新证书替换。 * stock：使用已有证书替换。 **CACertificateId** String `可选` `示例值：cert-123***765` 新CA证书 ID。选择已有证书替换时，即UpdateMode为stock，本参数必填且生效。 **CACertificateName** String `可选` `示例值：test` 证书的名称。 **Description** String `可选` `示例值：test` 证书的描述。 **CACertificate** String `可选` `示例值：public` 证书内容。当UpdateMode为new时，该字段必填，格式如下： \-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\- 客户端 CA 公钥证书(BASE64编码) \-\-\-\-\-END CERTIFICATE\-\-\-\-\- **ProjectName** String `可选` `示例值：test` 证书所属项目。当UpdateMode为new时，该字段生效。 **Tags.N.Key** String[] `可选` `示例值：Tags.1.Key=k1&Tags.2.Key=k2` 用户标签的标签键。具体规则如下： * 长度限制为1～128个字符。 * 大小写敏感。 * 不能以volc:和sys:的任意大小写组合开头。 * 不能以空格开头或结尾。 * 允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（\-）和@。 * 同一资源的标签键不允许重复。 **Tags.N.Value** String[] `可选` `示例值：Tags.1.Value=v1&Tags.2.Value=v2` 用户标签的标签值。 * 如果传入该参数，则必须先传入Tags.N.Key。 * 具体规则如下： * 长度限制为0～256个字符。 * 大小写敏感。 * 不能以空格开头或结尾。 * 允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（\-）和@。 ## 返回参数 **RequestId** String `示例值：20210816110638****2514606306AF947C` 请求ID。 **CACertificateId** String `示例值：cert-*****` 新CA证书ID。 ## 请求示例 ```JSON GET /?Action=ReplaceCACertificate&OldCACertificateId=cert-2jqh****hsx&CACertificate=***&CACertificateName=test&Version=2020-04-01 HTTP/1.1 Host: alb.cn-beijing.volcengineapi.com X-Date: 20251121T094038Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/alb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20210816110638****2514606306AF947C", "Action": "ReplaceCACertificate", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "202108161106****22514606306AF947C", "CACertificateId": "cert-****" } } ``` ## 错误码如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/113579)。 |**状态码** |**错误码** |**错误信息** |**说明** | |---|---|---|---| |400 |InvalidOldCACertificate.InvalidStatus |The specified Old CA Certificate is not in the correct status for the request. |指定的旧 CA 证书所处状态无法响应该请求。 | |400 |InvalidCertificateType.FunctionMismatch |The specified Certificate's type and Function do not match. |指定的证书的类型与预期功能不匹配。 | |400 |OperationDenied.NoListenerBound |The request on the specified certificate is denied due to no listener bound on the specified old certificate. |因该旧证书未绑定任何监听器，对于该证书的操作请求被拒绝。 | |400 |OperationDenied.ListenersBoundCountExceed |The request on the specified certificate is denied due to the count of listeners bound on the specified old certificate exceeding limit. |因该旧证书绑定的监听器数量超过上限，对于该证书的操作请求被拒绝。 | |400 |InvalidCACertificateName.Malformed |The specified CACertificateName is malformed. |指定的 CACertificateName 参数格式不合法。 | |400 |InvalidDescription.Malformed |The specified Description is malformed. |指定的 Description 参数格式不合法。 | |400 |InvalidCACertificate.Malformed |The specified CACertificate is malformed. The specified ca certificate's content is malformed. |指定的 CACertificate 参数格式不合法。其中 CA 证书内容不合法。 | |400 |OperationFailed.QueryProject |The request on the specified resource failed due to the query on project failed. |因查询项目失败，对于该资源的操作请求失败。 | |400 |InvalidCertificate.Duplicated |The specified Certificate is duplicated. The specified new certificate is not allowed to be similar to the old certificate. |指定的证书重复。新证书不能与旧证书相同。 | |400 |InvalidCACertificate.InvalidStatus |The specified CA Certificate is not in the correct status for the request. |指定的 CA 证书所处状态无法响应该请求。 | |400 |InvalidOldCertificateType.CertificateTypeMismatch |The specified new certificate type and old certificate type do not match. The specified new certificate must be the same type as the old one. |指定的新证书类型和旧证书类型不匹配。指定的新证书必须与旧证书的类型相同。 | |400 |InvalidUpdateMode.Malformed |The specified UpdateMode is malformed. |指定的 UpdateMode 参数格式不合法。 | |400 |QuotaExceed.CACertPerRegion |You've reached the limit on the number of CA certificates the current region you can create in, usage xx/xx. |已达到当前地域可创建的 CA 证书的数量上限。目前已使用xxx，配额为xxx。 | |400 |OperationFailed.AddIntoProjectFailed |The request on the specified resource failed due to adding it into the project failed. |因将资源加入至项目中失败，对于该资源的操作请求失败。 | |400 |InvalidCertificate.InvalidStatus |The specified Certificate is not in the correct status for the request. |指定的证书所处状态无法响应该请求。 | |400 |InvalidLoadBalancer.InvalidStatus |The related LoadBalancer is not in the correct status for the request. |关联的 ALB 实例所处状态无法响应该请求。 | |404 |InvalidOldCACertificate.NotFound |The specified Old CA Certificate does not exist. |指定的旧 CA 证书不存在。 | |404 |InvalidProject.NotFound |The specified Project does not exist. |指定的项目不存在。 | |404 |InvalidCACertificate.NotFound |The specified CA Certificate does not exist. |指定的 CA 证书不存在。 | |400 |InvalidTags.Key.Malformed |The specified Tags.Key is malformed. |指定的 Tags.Key 参数格式不合法。 | |400 |InvalidTags.Value.Malformed |The specified Tags.Value is malformed. |指定的 Tags.Value 参数格式不合法。 | |400 |InvalidTags.Key.Duplicated |The specified Tags.Key is duplicated. |指定的 Tags.Key 重复。 |