CDN

添加加速域名

最近更新时间:2019-04-30 15:18:43

AddCdnDomain

描述

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

注意

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

说明:

  • 客户输入加速域名及源站等基本信息
  • 检测唯一性,如唯一则通过进入下一步,不唯一则接口直接返回“加速域名已存在”

请求语法

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

请求参数

参数名 必选 类型及范围 说明
DomainName String 需要接入CDN的域名
CdnType String 加速域名的产品类型,只允许输入一种类型,取值为file:大文件下载,video:音视频点播,page:图片小文件,live:流媒体直播,暂不支持直播域名添加
CdnSubType String 加速业务子类型,业务子类型是为了细分业务,默认不填写,具体枚举类型表见使用须知
ProjectId String 加速域名所属的项目,非必填项,默认归属为【默认项目】,若输入项目ID,可指定域名归属为已经创建好的项目ID下面
CdnProtocol String 客户访问服务节点的协议。默认http,流媒体直播必须填写:http+flv,hls,rtmp。当产品类型为大文件下载、音视频点播、图片小文件时,访问协议为http;当产品类型为流媒体直播时,访问协议为http+flv,hls,rtmp
Regions String 加速区域,默认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&OriginPort=80&Origin=www.test.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&OriginPort=80&Origin=www.test.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&OriginPort=80&Origin=www.test.com&SearchUrl=http://test.com/1.html

返回示例

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

金山云,开启您的云计算之旅

立即注册