全部文档
当前文档
最近更新时间：2021-08-24 09:56:13
本接口用于添加加速域名，一次只能提交一个加速域名。本接口支持添加形如：*.a.com的泛域名。
注意：
说明：
本接口请求需要包含指定目录 /2016-09-01/domain/AddCdnDomain、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。
| 参数名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| DomainName | 是 | String | 需要接入CDN的域名 |
| CdnType | 是 | String | 加速域名的产品类型，只允许输入一种类型，取值为file：大文件下载，video：音视频点播，page：图片小文件，live：流媒体直播，暂不支持直播域名添加 |
| ProjectId | 否 | String | 加速域名所属的项目，非必填项，默认归属为【默认项目】，若输入项目ID，可指定域名归属为已经创建好的项目ID下面 |
| CdnProtocol | 是 | String | 客户访问服务节点的协议。默认http，流媒体直播必须填写：http＋flv，hls，rtmp。当产品类型为大文件下载、音视频点播、图片小文件时，访问协议为http；当产品类型为流媒体直播时，访问协议为http＋flv，hls，rtmp |
| 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=www.test.com&CdnType=live&CdnSubType=live&CdnProtocol=RTMP&Regions=CN&OriginType=domain&OriginProtocol=rtmp&Origin=www.test1.com 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/x-www-form-urlencoded
DomainName=www.test.com&CdnType=live&CdnSubType=live&CdnProtocol=RTMP&Regions=CN&OriginType=domain&OriginProtocol=rtmp&Origin=www.test1.com
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/x-www-form-urlencoded
DomainName=www.*.test.com&CdnType=download&CdnSubType=download&CdnProtocol=http&Regions=CN&OriginType=domain&OriginProtocol=http&Origin=www.a.test.com&SearchUrl=http://a.test.com/1.html
返回示例
{
"DomainId": "2D09XC0",
"DomainStatus":"configuring"
}
纯净模式