You need to enable JavaScript to run this app.
导航

关联证书与加速域名

最近更新时间2024.01.25 20:28:21

首次发布时间2022.07.18 15:12:00

将一个证书与内容分发网络中当前账号下的多个加速域名相关联。

使用限制

节流限制:您每秒最多可发送 20 个请求。

请求说明

  • 请求方式:POST
  • 请求地址:https://cdn.volcengineapi.com/?Action=BatchDeployCert&Version=2021-03-01

请求参数

Query

参数名称
数据类型
是否必选
参数说明
Action
String
接口名称。当前 API 的名称为 BatchDeployCert
Version
String
接口版本。当前 API 的版本为 2021-03-01

Body

参数名称
数据类型
是否必选
参数说明
示例
Domain
String
指定一个或者多个内容分发网络中当前账号下的加速域名,将该证书与这些域名关联。如果指定的域名不是该证书的 SAN 字段中所包含的域名,关联会失败。最多可以指定 50 个域名。多个域名之间使用英文逗号(,)分隔。
www.example.com,img.example.com
CertId
String
指定一个证书 ID。
cert-c195f679cecb4f34tj23dd8c54e6c0a2

响应正文

参数名称
数据类型
参数说明
示例
DeployResult
Object[]
表示请求中指定的域名是否成功关联了证书。

请求示例

POST https://cdn.volcengineapi.com/?Action=BatchDeployCert&Version=2021-03-01
{
  "CertId": "cert-c195f679cecb4fc5yjt3dd8c54e6c0a2",
  "Domain": "www.example.com,img.example.com"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202207131500530102120352272280EC8F",
    "Action": "BatchDeployCert",
    "Version": "2021-03-01",
    "Service": "CDN",
    "Region": "cn-north-1"
  },
  "Result": {
    "DeployResult": [
      {
        "Domain": "www.example.com",
        "Status": "success"
      },
      {
        "Domain": "img.example.com",
        "ErrorMsg": "域名与证书不匹配",
        "Status": "fail"
      }
    ]
  }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段,则表示 API 请求失败。更多关于错误码的信息,参见错误码