AddCdnDomain

描述

本接口用于添加加速域名，一次只能提交一个加速域名。本接口支持添加形如：*.a.com的泛域名。

注意：

• 加速域名必须已备案完成。

说明：

• 客户输入加速域名及源站等基本信息
• 检测唯一性，如唯一则通过进入下一步，不唯一则接口直接返回“加速域名已存在”
• 回源类型为IP回源时，IP不能是内网IP或者是特殊IP，如8.8.8.8等，系统会报错

请求语法

本接口请求需要包含指定目录 /2016-09-01/domain/AddCdnDomain、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数

参数名	必选	类型及范围	说明
DomainName	是	String	需要接入WCDN的域名
CdnType	是	String	加速域名的产品类型，只允许输入一种类型，取值为wcdn：全站加速
ProjectId	否	String	加速域名所属的项目，非必填项，默认归属为【默认项目】，若输入项目ID，可指定域名归属为已经创建好的项目ID下面
CdnProtocol	是	String	客户访问服务节点的协议。当产品类型为全站加速时，访问协议为http
Regions	否	String	加速区域，支持CN：【中国大陆】；OverSea：【全球（除中国大陆）】；Global：【全球】，缺省为 CN
OriginType	是	String	源站类型 取值：ipaddr、 domain、KS3、ksvideo分别表示：IP源站、域名源站、KS3为源站、金山云视频云源站。当产品类型为下载时，源站类型为ipaddr、 domain、KS3；当产品类型为直播时，源站类型为ipaddr、 domain、ksvideo；当源站类型为KS3时，需添加以ksyun.com结尾的域名
OriginProtocol	是	String	回源协议，取值：http，https，follow，rtmp，hls，当产品类型为大文件下载、音视频点播时，回源协议为http，https，follow（协议跟随）；当产品类型为流媒体直播时，回源协议为rtmp，hls（注：访问协议为hls时，回源协议必须为hls；访问协议为http+flv和rtmp时，回源协议必须为rtmp）
Origin	是	String	回源地址，可以是IP或域名；IP支持最多20个，以逗号区分，域名只能输入一个。IP与域名不能同时输入。当源站类型选择ipaddr时，仅可输入IP地址，当源站类型选择 domain、KS3、ksvideo时，仅可输入域名

有关泛域名的说明

1）允许添加3级及3级以上域名
2）此规则仅适用于下载类型的域名，直播类型的域名校验规则保持不变

返回参数

参数名	类型及范围	说明
DomainId	String	该域名的域名ID
DomainStatus	String	域名状态

示例

请求示例

GET方式：

GET /2016-09-01/domain/AddCdnDomain?DomainName=wcdn-20220304-1.ksc-test.com&CdnType=wcdn&CdnProtocol=http&OriginType=ipaddr&OriginProtocol=https&Origin=13.2.2.2 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: AddCdnDomain
x-version: 2016-09-01

POST方式(精确域名）：

POST  /2016-09-01/domain/AddCdnDomain 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: AddCdnDomain
x-version: 2016-09-01
Content-Type: application/json

{
    "DomainName": "wcdn-20220304-1.ksc-test.com",
    "CdnType": "wcdn",
    "CdnProtocol": "http",
    "OriginType": "ipaddr",
    "OriginProtocol": "https",
    "Origin": "13.2.2.2"
}

POST方式(泛域名）：

POST  /2016-09-01/domain/AddCdnDomain 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: AddCdnDomain
x-version: 2016-09-01
Content-Type: application/json

{
    "DomainName": "*.wcdn.ksc-test.com",
    "CdnType": "wcdn",
    "CdnProtocol": "http",
    "OriginType": "ipaddr",
    "OriginProtocol": "https",
    "Origin": "13.2.2.2"
}

返回示例

{
 "DomainId": "2D09XC0",
 "DomainStatus":"configuring"
}

错误码

为了帮您快速定位问题，WCDN将错误码集中归类，请到【使用须知】查看详情。