You need to enable JavaScript to run this app.
导航
添加域名
最近更新时间:2024.01.25 21:38:05首次发布时间:2022.02.15 21:27:24

在内容分发网络中添加您的域名。在添加域名时,您可以设置域名的配置。

使用限制

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

您添加的域名必须满足以下要求:

  • 如果您指定的加速区域包含中国内地,该域名必须已在工信部备案。您可以在 域名信息备案管理系统 页面查询您的域名是否已备案。

  • 如果该域名已在其他火山引擎账号下,您无法添加该域名。

  • 如果该域名已在您的账号下,您无法再次添加该域名。

  • 该域名不能是二级域名。例如,您添加的域名不能是 example.com

说明

如果您要添加的域名是一个泛域名,请 提交工单

请求说明

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

请求参数

Query

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

Body

参数名称
数据类型
是否必选
参数说明
示例
Domain
String

表示您需要添加的一个域名。主账号下最多能添加 200 个加速域名。如果您需要添加的域名数量超过 200 个,请 提交工单

您可以添加中文域名。在指定中文名时,您必须将域名中的汉字转化为 punycode 码后再输入。 您添加的域名必须满足以下额外要求:

  • 域名长度不超过 100 个字符。

  • 域名不能包含大写字母。

  • 域名不包含这些后缀:zjgslb.comyangyi19.comvolcgslb.comveew-alb-cn1.combplgslb.combplslb.comttgslb.com

www.example.com
ServiceType
String

表示该域名的业务类型。该参数有以下取值:

  • download:表示文件下载。

  • web:表示网页。

  • video:表示音视频点播。

web
ServiceRegion
String

表示加速区域。该参数有以下取值:

  • chinese_mainland:表示中国内地。

  • global:表示全球。

  • outside_chinese_mainland:表示全球(不含中国内地)。

globaloutside_chinese_mainland 是白名单功能。如果您需要指定这两个参数值,请 提交工单。 该参数的默认值是 chinese_mainland
outside_chinese_mainland
Project
String

表示该域名所归属的项目。您可以在 项目管理 页面查看已有的项目以及项目下的资源。

该参数的默认值是 default,表示名称是 default 的项目。
default
ResourceTags
Object[]
表示您对该域名设置的标签。您最多可以设置 10 个标签。
SharedCname
Object
表示共享 CNAME 的配置。如果您需要使用此功能,请 提交工单

说明

在您调用该 API 时,您必须指定 Origin 模块。OriginProtocol 参数、OriginHost 参数、以及其他域名配置模块是可选的。这些参数和模块在 UpdateCdnConfig 文档中说明。

响应正文

无。

请求示例

POST https://cdn.volcengineapi.com/?Action=AddCdnDomain&Version=2021-03-01

{
  "Domain": "www.example.com",
  "ServiceType": "web",
  "OriginProtocol": "http",
  "Origin": [
    {
      "Condition": null,
      "OriginAction": {
        "OriginLines": [
          {
            "Address": "1.1.1.1",
            "HttpPort": "80",
            "HttpsPort": "443",
            "InstanceType": "ip",
            "OriginType": "primary",
            "PrivateBucketAccess": false,
            "Weight": "1"
          }
        ]
      }
    }
  ],
  "ResourceTags": [
    {
      "key": "hello",
      "value": "world"
    }
  ],
  "SharedCname": {
    "Switch": true,
    "Cname": "test.cname.gslb.com"
  }
  //关于其他配置的示例,参见 UpdateCdnConfig 文档中相应配置的请求示例。
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2021121621104801021219403908010CBC",
    "Action": "AddCdnDomain",
    "Version": "2021-03-01",
    "Service": "CDN",
    "Region": "cn-north-1"
  }
}

错误码

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