SetClientCertificateHostnames - 设置客户端证书域名绑定

给指定的客户端CA证书绑定域名,不指定证书时,域名绑定到ESA CA证书。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
SiteIdlong

站点 ID。

123456789****
Hostnamesarray

绑定的域名列表。

string

域名。

www.example.com
Idstring

客户端 CA 证书 ID。

babab9db65ee5efcca9f3d41d4b50d**

返回参数

名称类型描述示例值
object

Schema of Response

SiteIdlong

站点 ID。

123456789****
SiteNamestring

站点名称。

example.com
Idstring

客户端 CA 证书 ID。

babab9db65ee5efcca9f3d41d4b50d**
Hostnamesarray

绑定的域名列表。

Hostnamesstring

域名。

www.example.com
RequestIdstring

请求 ID。

ET5BF670-09D5-4D0B-BEBY-D96A2A528000

示例

正常返回示例

JSON格式

{
  "SiteId": 0,
  "SiteName": "example.com ",
  "Id": "babab9db65ee5efcca9f3d41d4b50d**",
  "Hostnames": [
    "www.example.com"
  ],
  "RequestId": "ET5BF670-09D5-4D0B-BEBY-D96A2A528000"
}

错误码

HTTP status code错误码错误信息描述
400MissingSiteIdRequired parameter SiteId missing. Specify SiteId and try again.缺少必填参数SiteId,请指定SiteId参数后重试。
400InternalExceptionFailed to call the service. Try again later or contact technical support.调用服务失败,请稍后重试或联系客服咨询详情。
400InvalidParameterThe specified parameter is invalid.输入参数规范校验失败。
400QuotaCheckFailed.FunctionThe feature is unavailable in your plan. Upgrade the plan or contact your account manager to request the feature.您的套餐不含该功能,请升级套餐或联系商务添加。
403Unauthorized.InvalidTimeThe specified authentication time is invalid.您输入的鉴权时间参数无效,请检查参数值后重试。
403Unauthorized.InvalidTokenToken authentication failed.您输入的token无效,请检查并输入正确的token后进行重试。
404Certificate.NotFoundThe specified certificate does not exist.指定的证书不存在。

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

变更历史

变更时间变更内容概要操作
2025-03-13OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情