全部产品
阿里云办公

添加域名

更新时间:2018-11-13 20:32:18

概述

添加全站加速域名,一次只能提交一个加速域名。

限制条件

  • 创建加速域名之前, 必须先开通DCDN服务。
  • 加速域名必须已备案完成。
  • 源站内容,如果不在阿里云平台上,需要审核,审核工作会在下一工作日前完成。

请求参数

参数 类型 是否必需 描述
Action String 操作接口名,系统规定参数 取值:AddDcdnDomain
DomainName String 需要接入DCDN的域名。支持泛域名,以符号“.”开头,如:.a.com
Sources Json 回源地址列表。
Scope String 取值范围:domestic,overseas,global,默认domestic。国际用户、国内L3及以上用户设置有效。
ResourceGroupId String 资源组ID。不传时,自动补全默认资源组ID。
TopLevelDomain String 顶级接入域,只有白名单用户设置才有效。

Sources格式

  1. [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]

Sources各字段含义

参数 类型 必要 描述
type String 源站类型。取值:ipaddr:IP源站;domain:域名源站;oss:OSS Bucket为源站。
content String 回源地址,可以是IP或域名。
port Integer 可以指定443,80。默认值80。443的话走https回源。也可以自定义端口。
priority String 源站地址对应的优先级,默认20。

返回参数

名称 类型 描述
RequestId String 该条任务请求ID

示例

请求示例

  1. http://dcdn.aliyuncs.com?Action=AddDcdnDomain&DomainName=example.com&Sources=[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]&<公共请求参数>

返回示例

JSON格式:

  1. {
  2. "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
  3. }

错误码

错误代码 错误信息 HTTP状态码 说明
InvalidDomainName.Malformed Specified DomainName is malformed. 400 DomainName 参数错误
InvalidSource.Content.Malformed Specified source content is malformed. 400 回源地址参数错误
InvalidSource.Type.Malformed Specified source type is malformed. 400 源站类型参数错误
InvalidTypeContent.Mismatch Specified source type does not math the specified source content. 400 回源地址与回源类型不匹配
InvalidSource.Priority.Malformed Specified source priority is malformed. 400 优先级参数错误
InvalidScope.Malformed Specified Scope is malformed. 400 Scope 参数错误
BusinessExist Business exist do not repeated submission. 400 该域名正在添加,不用重复提交
DomainAlreadyExist This domain name is exist already. 400 该域名已经添加
DomainOverLimit The Number of Domain is over the limit. 403 超过域名个数限制
DomainNotRegistration The Domain name is not registered. 404 该域名没有备案
IllegalOperation Illegal domain operate is not permitted. 403 没有权限执行当前操作
ServiceBusy The specified Domain is configuring, please retry later. 403 域名正在配置中, 请稍后再试
ExtensiveAndAllBothExist Extensive domain and the domain begins with ‘all.’ can not exist at the same time. 400 泛域名与all.开头域名不能同时存在
CdnTypeNotSupportExtensiveDomain Extensive domain not supported for this cdn type. 400 泛域名不支持该业务类型
ExtensiveAndSpecificDomainConflict Extensive domain and corresponding specific domain are mutually exclusive. 400 泛域名与对应同级别精确域名互斥
InvalidResourceGroupId.Malformed Specified ResourceGroupId is malformed. 400 ResourceGroupId参数不正确
EntityNotExists.ResourceGroup The resource group does not exist. 400 资源组不存在
InvalidStatus.ResourceGroup It’s now allowed to do this operation because of the current status of resource-group. 400 资源组状态检查失败
NotInternationRealIdentity You need to do real name authentication when you use Chinese mainland resources. 400 用中国大陆资源时,账号需要国际认证