CDNW创建加速域名-文档中心

为指定的域名申请加速服务

限制说明：· 加速域名必须已备案完成。 · 加速域名必须不包含如下信息：出售药物和管制刀具类，含有不法言论、信息。 · 视频类加速域名必须有视听许可证；博客论坛或社区类加速域名必须有BBS专项审批资质。 · 接口请求和返回结果接受xml和json格式。
单用户调用频率：300/5min
适用产品：静态加速、动态加速、流媒体点播、Flood Shield、Flood Shield 2.0

请求参数

Body 参数

参数名称	描述
*versionString	版本号，当前版本号1.0.0
*domain-nameString	需要接入CDN的域名。支持泛域名，以符号“.”开头，如：.example.com，泛域名也包含多级 a.b.example.com。如果example.com已备案，那么域名xx.example.com则不需要备案。
referenced-domain-nameString	指定参考域名。当使用参考域名来新增域名是，新域名将复用参考域名的配置
config-form-idString	配置单模板，特定的使用场景下，如果希望新增的加速域名参照某些指定配置时，可以指定配置单模板，具体使用请咨询对应的客户负责人。
accelerate-no-chinaString	是否纯海外加速，入参范围：true、false
*contract-idString	合同号，如40015677
*item-idString	产品号，如10
cname-labelString	共用一级别名，客户存在较多一级域名共用的需求，因此在接口中引入cname-label标识，即拥有相同cname-label的一组域名，共用一级cname。当加速域名的加速区域、加速类型、资源链是一致的时候，建议使用共用一级别名，相同的业务使用相同一级别名cname。注意： 1、拥有相同cname-label的域名共用一级cname，且有完全一致的dns覆盖 2、共用一级的约束：配置一致、加速类型一致、证书id一致（如果有证书）、加速区域一致、平台套餐一致 3、多个http域名可共用一级，多个sni https域名可共用一级，多个共享证书域名可共用一级 4、单个域名使用cname-label时，域名可取消加速；多个域名共用一级时，不允许取消加速这些域名 5、支持通过修改cname-label达到修改cname的目的
commentString	备注信息，最大限制1000个字符
header-of-clientipString	传递客户端ip的响应头部，可选值为Cdn-Src-Ip和X-Forwarded-For，默认值为Cdn-Src-Ip
- *origin-configObject	回源策略设置，用于设置加速域名的源站信息和回源策略
origin-ipsString	回源地址，可以是IP或域名。 1. IP以分号分隔，支持多个。 2. 域名只能输入一个。IP与域名不能同时输入。 3.限制最大不能超过500个字符长度。
default-origin-host-headerString	回源HOST，用于更改回源HTTP请求头中的HOST字段。支持格式为: 域名或ip。注意：必须符合ip/域名格式规范。如果是域名，则域名每段（点号分隔）长度小于等于62，域名总长度小于等于128。
origin-portString	回源请求端口，不能为0
- live-configObject	直播域名配置，用于设置直播加速域名的推拉流（使用需申请）注意：该节点下的相关参数配置，除开通API调用权限外，还需要联系专属客服申请开通对应的API客户模板
stream-typeString	直播推拉流类型，可选值为pull和push，pull表示拉流； push表示推流。
origin-push-hostString	配套推流域名，用于设置直播拉流域名对应的推流域名，当stream-type为pull时，源站IP和配套推流域名至少一个不为空；当stream-type为push时，无需传入。
origin-ipsString	源站IP，当stream-type为pull时，源站IP和配套推流域名至少一个不为空。 1、如果是推拉流配套，则填写127.0.0.1，不传系统也默认为127.0.0.1 2、如果是直接回源拉流，则填写回源拉流的源站IP
- publish-pointsList	设置直播推拉流域名的发布点注意： 1、拉流和对应的推流域名，必须配置相同的发布点； 2、不想修改发布点时，不要传入该节点及以下入参； 3、发布点采用覆盖式更新，每次修改时，需要提交全部发布点，不能仅提交需要修改的部分。
uriString	发布点，支持多个，多个值用\|\|隔开，不传系统默认生成一条发布点uri为“/”
- sslObject	ssl证书设置，用于设置加速域名的ssl证书配置。上传证书请使用接口：【新增证书V2】；若要修改证书，请使用接口：【修改证书V2】
use-sslString	使用证书，可选值为true和false，true表示使用证书，false表示不使用证书
use-for-sniString	使用sni证书，可选值为true和false，true表示使用sni证书，false表示使用合用证书（暂不支持）
ssl-certificate-idInteger	证书ID，新增证书成功后，系统返回的证书ID，use-ssl为true时，才能传ssl-certificate-id。

返回参数

Body 参数

参数名称	描述
http status codeInteger	httpstatus=202; 表示成功调用新增域名接口，可使用header中的x-cnc-request-id查看当前新增域名的部署情况
x-cnc-request-idString	唯一标示的id，用于查询每次请求的任务（适用全部接口）
locationString	响应信用于访问该域名信息的URL，其中domain-id为我司云平台为该域名生成的唯一标示，其值为字符串。
cnameString	由我司自动生成的服务域名名称，例如：xxxx.cdn30.com
codeString	请求结果状态码
messageString	响应信息，成功时为success

错误码

错误代码（code）	描述（message）	HTTP状态码	语义
MalformedXML	The XML you provided was not well-formed or did not validate against our published schema.	400	提供的xml不正确或者不符合规则
InternalError	We encountered an internal error. Please try again.	500	服务器异常，数据获取失败等内部错误
DomainAlreadyExists	The domain name you provided is already in our system.	409	添加的域名已经存在。
ConfigError	The domain name is invalid.	400	域名无效
ICPNotFound	There is no ICP number for the domain you provided.	400	您提供的域名没有备案号
InvalidOrigin	Please specify at least one IP or hostname.	400	没有提供回源ip或回源域名。
InvalidOrigin	Origin domain and accelerated domain cannot be the same.	400	回源域名和加速域名不能相同
InvalidOrigin	The origin IP or hostname is invalid.	400	回源ip/域名不合法。
InvalidOrigin	{"$domainName":{"src-ip":"Duplicate source ip or source domain name."}}	400	回源ip重复
CustomizedCnameError	Customized CNAME error.	409	客户共用一级错误
ConfigFormNotExists	The configuration does not exist.	400	入参服务区域错误
CnameError	CNAME error.	409	共用一级错误
CnameError	The cname label has one more templet forms	400	共用一级属于多个配置单模板
InvalidOrigin	{"$domainName":{"$xmlTag":"$msg"}}	400	域名属性值错误
InvalidOrigin	{"$domainName":{"ssl":"No certificate id when use ssl."}}	400	使用证书时没有传入证书id
ConfigError	The specified service type does not exist.	400	没有对应的服务单
ConfigError	parameter custSuitType is blank.	400	参数的外部加速类型为空
ConfigError	can not find form id for domain: [$domainName]	400	找不到域名的配置单
ConfigError	can not find service form for domain: [$domainName]	400	找不到域名的服务单
ConfigError	The suit does not match the suit associated with the value of cname-label.	409	指定配置与指定共用一级域名不匹配
ConfigError	The service-type does not match the service-type associated with the value of cname-label.	400	指定加速类型与指定共用一级域名不匹配
NoSuchConfigTemplet	The specified config templet does not exist.	404	入参服务区域与指定共用一级域名的服务区域不匹配
NO_AVAILABLE_CONFIG	Can not find effective ConfServiceForm by input parameter custSuitType : [$CustSuitType]	400	配置单模板不存在
PARSE_PARAM_ERROR	Error parameter.	400	根据加速类型找不到合适的服务单
NULL_DOMAIN_NAME	Domain name is null.	400	入参解析错误
STAGING_SUIT_ERROR	can not find any suit	400	证书id不能为空
SUIT_HAS_NOT_CONFIG_CERTIFICATE_SERVICE	The suit belong to serviceForm does not have a certificate service.	400	该证书不支持Cipher加密套件的自助配置
ERROR_CONFIG_PARAM	{"$configXmlTag":"$msg"}orWrong delete data id $dataIdorWrong data id $dataId	400	配置单配置项错误
MAIN_DOMAIN_NAME_EXIST	Main domain names exists for domain [$errDomainNames]	400	主域名已存在

示例

JSON

请求示例 复制代码 复制成功#!/bin/bash username="example_username" apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -H "Content-Type:application/json" \ -d '{ "version": "1.0.0", "domain-name": "www.example.com", "contract-id": "40012086", "item-id": "10", "origin-config":{ "origin-ips":"1.1.1.0" }, "referenced-domain-name":"aaa.linlytest.com", "ssl":{ "use-ssl":"true", "ssl-certificate-id":"certificate ID" } }'

#!/bin/bash
username="example_username"
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-H "Content-Type:application/json" \
-d '{
  "version": "1.0.0",
  "domain-name": "www.example.com",
  "contract-id": "40012086",
  "item-id": "10",
  "origin-config":{
        "origin-ips":"1.1.1.0"
    },
    "referenced-domain-name":"aaa.linlytest.com",
    "ssl":{
         "use-ssl":"true",
         "ssl-certificate-id":"certificate ID"
    }
}'

返回示例 复制代码 复制成功HTTP/1.1 202 Accepted Date: Fri, 17 May 2017 06:33:26 GMT Content-Type: application/xml;charset=utf-8 x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd Location:https://api.cdnetworks.com/api/domain/1234567 cname: 7nt6mrh7sdkslj.cdn30.com {"message":"success"}

HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
Location:https://api.cdnetworks.com/api/domain/1234567
cname: 7nt6mrh7sdkslj.cdn30.com
{"message":"success"}

XML

请求示例 复制代码 复制成功#!/bin/bash username="example_username" apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/xml" \ -d '<?xml version="1.0" encoding="utf-8"?> <domain> <version>1.0.0</version> <domain-name>www.example.com</domain-name> <contract-id>40012086</contract-id> <item-id>10</item-id> <comment>comment added by yourself</comment> <origin-config> <origin-ips>1.1.1.0</origin-ips> <default-origin-host-header>a.example.com</default-origin-host-header> </origin-config> <header-of-clientip>X-Forwarded-For</header-of-clientip> <ssl> <use-ssl>true</use-ssl> <ssl-certificate-id>10001</ssl-certificate-id> </ssl> </domain>'

#!/bin/bash
username="example_username"
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml" \
-d '<?xml version="1.0" encoding="utf-8"?>
<domain>
  <version>1.0.0</version>
  <domain-name>www.example.com</domain-name>
  <contract-id>40012086</contract-id>
  <item-id>10</item-id>
  <comment>comment added by yourself</comment>
  <origin-config>
    <origin-ips>1.1.1.0</origin-ips>
    <default-origin-host-header>a.example.com</default-origin-host-header>
  </origin-config>
  <header-of-clientip>X-Forwarded-For</header-of-clientip>
  <ssl>
    <use-ssl>true</use-ssl>
    <ssl-certificate-id>10001</ssl-certificate-id>
  </ssl>
</domain>'

返回示例 复制代码 复制成功HTTP/1.1 202 Accepted Date: Fri, 17 May 2017 06:33:26 GMT Content-Type: application/xml;charset=utf-8 x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd Location:https://api.cdnetworks.com/api/domain/1234567 cname: 7nt6mrh7sdkslj.cdn30.com <?xml version="1.0" encoding="UTF-8"?> <response> <message>success</message> </response>

HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
Location:https://api.cdnetworks.com/api/domain/1234567
cname: 7nt6mrh7sdkslj.cdn30.com
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <message>success</message>
</response>

JSON FOR LIVE-PUSH

请求示例 复制代码 复制成功#!/bin/bash username="example_username" apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -H "Content-Type:application/json" \ -d '{ "version": "1.0.0", "domain-name": "push.example.com", "contract-id": "40012086", "item-id": "10", "live-config":{ "stream-type":"push" } }'

#!/bin/bash
username="example_username"
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-H "Content-Type:application/json" \
-d '{
  "version": "1.0.0",
  "domain-name": "push.example.com",
  "contract-id": "40012086",
  "item-id": "10",
  "live-config":{
        "stream-type":"push"
    }
}'

返回示例 复制代码 复制成功HTTP/1.1 202 Accepted Date: Fri, 17 May 2017 06:33:26 GMT Content-Type: application/xml;charset=utf-8 x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd Location:https://api.cdnetworks.com/api/domain/1234567 cname: 7nt6mrh7sdkslj.cdn30.com {"message":"success"}

HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
Location:https://api.cdnetworks.com/api/domain/1234567
cname: 7nt6mrh7sdkslj.cdn30.com
{"message":"success"}

JSON FOR LIVE-PULL

请求示例 复制代码 复制成功#!/bin/bash username="example_username" apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -H "Content-Type:application/json" \ -d '{ "version": "1.0.0", "domain-name": "pull.example.com", "contract-id": "40012086", "item-id": "10", "live-config":{ "stream-type":"pull", "origin-push-host":"push.example.com" } }'

#!/bin/bash
username="example_username"
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-H "Content-Type:application/json" \
-d '{
  "version": "1.0.0",
  "domain-name": "pull.example.com",
  "contract-id": "40012086",
  "item-id": "10",
  "live-config":{
        "stream-type":"pull",
        "origin-push-host":"push.example.com"
    }
}'

返回示例 复制代码 复制成功HTTP/1.1 202 Accepted Date: Fri, 17 May 2017 06:33:26 GMT Content-Type: application/xml;charset=utf-8 x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd Location:https://api.cdnetworks.com/api/domain/1234567 cname: 7nt6mrh7sdkslj.cdn30.com {"message":"success"}

HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
Location:https://api.cdnetworks.com/api/domain/1234567
cname: 7nt6mrh7sdkslj.cdn30.com
{"message":"success"}

XML FOR LIVE-PUSH

请求示例 复制代码 复制成功#!/bin/bash username="example_username" apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/xml" \ -d '<?xml version="1.0" encoding="utf-8"?> <domain> <version>1.0.0</version> <domain-name>push.example.com</domain-name> <contract-id>40012081</contract-id> <item-id>10</item-id> <comment>comment added by yourself</comment> <live-config> <stream-type>push</stream-type> </live-config> </domain>'

#!/bin/bash
username="example_username"
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml" \
-d '<?xml version="1.0" encoding="utf-8"?>
<domain>
  <version>1.0.0</version>
  <domain-name>push.example.com</domain-name>
  <contract-id>40012081</contract-id>
  <item-id>10</item-id>
  <comment>comment added by yourself</comment>
  <live-config>
    <stream-type>push</stream-type>
  </live-config>
</domain>'

返回示例 复制代码 复制成功HTTP/1.1 202 Accepted Date: Fri, 17 May 2017 06:33:26 GMT Content-Type: application/xml;charset=utf-8 x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd Location:https://api.cdnetworks.com/api/domain/1234567 cname: 7nt6mrh7sdkslj.cdn30.com <?xml version="1.0" encoding="UTF-8"?> <response> <message>success</message> </response>

HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
Location:https://api.cdnetworks.com/api/domain/1234567
cname: 7nt6mrh7sdkslj.cdn30.com
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <message>success</message>
</response>

XML FOR LIVE-PULL

请求示例 复制代码 复制成功#!/bin/bash username="example_username" apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/xml" \ -d '<?xml version="1.0" encoding="utf-8"?> <domain> <version>1.0.0</version> <domain-name>pull.example.com</domain-name> <contract-id>40012086</contract-id> <item-id>10</item-id> <comment>comment added by yourself</comment> <live-config> <stream-type>pull</stream-type> <origin-push-host>push.example.com</origin-push-host> </live-config> </domain>'

#!/bin/bash
username="example_username"
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/cdnw/api/domain" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml" \
-d '<?xml version="1.0" encoding="utf-8"?>
<domain>
  <version>1.0.0</version>
  <domain-name>pull.example.com</domain-name>
  <contract-id>40012086</contract-id>
  <item-id>10</item-id>
  <comment>comment added by yourself</comment>
  <live-config>
    <stream-type>pull</stream-type>
    <origin-push-host>push.example.com</origin-push-host>
  </live-config>
</domain>'

返回示例 复制代码 复制成功HTTP/1.1 202 Accepted Date: Fri, 17 May 2017 06:33:26 GMT Content-Type: application/xml;charset=utf-8 x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd Location:https://api.cdnetworks.com/api/domain/1234567 cname: 7nt6mrh7sdkslj.cdn30.com <?xml version="1.0" encoding="UTF-8"?> <response> <message>success</message> </response>

HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
Location:https://api.cdnetworks.com/api/domain/1234567
cname: 7nt6mrh7sdkslj.cdn30.com
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <message>success</message>
</response>

CDNW创建加速域名

请求参数

Body 参数

返回参数

Body 参数

错误码

示例

目录