添加加速域名_域名管理_点播CDN_服务端API

描述

添加点播加速域名。每次只能提交一个加速域名，一个用户最多添加20个域名。

请注意：

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

请求参数

名称	类型	是否必需	描述
Action	String	是	操作接口名，系统规定参数。取值：AddVodDomain
DomainName	String	是	需要接入点播的加速域名。支持泛域名，以符号“.”开头，如：.example.com
Sources	String	是	回源地址列表
Scope	String	否	取值范围：domestic(表示中国大陆)，overseas(港澳台及海外)，global(全球加速)。默认为domestic。国际用户、国内L3及以上用户设置有效
CheckUrl	String	否	检查域名是否能正常访问url

Sources格式

[{"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

API示例

请求示例

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

返回示例

JSON格式

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

特殊错误码

错误代码	错误信息	HTTP 状态码	说明
InvalidDomainName.Malformed	Specified DomainName is malformed.	400	DomainName 参数错误
InvalidCdnType.Malformed	Specified CdnType is malformed.	400	CdnType 参数错误
InvalidSourceType.Malformed	Specified SourceType is malformed.	400	SourceType 参数错误
InvalidSources.Malformed	Specified Sources is malformed.	400	回源地址与源站类型不一致
InvalidScope.Malformed	Specified Scope is malformed.	400	Scope 参数错误
InvaildParameter	The Certificate you provided is malformed!	400	https安全加速时证书和密钥长度和过长
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	域名正在配置中, 请稍后再试
InvalidDomain.NotFound	The domain provided does not belong to you.	404	域名不存在或不属于当前用户
InnerAddDomainDenied	Your account haven’t bind aoneId, can not add domain.	400	内部账号未绑定aoneId，不能添加域名
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	泛域名与对应同级别精确域名互斥
InvalidParameter	Add live region parameters have error.	400	添加的直播region信息时出错
InvalidRegion.Malformed	Specified Region is malformed.	400	region参数不正确
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	资源组状态检查失败
InvalidPriorities.Malformed	The length of priorities is not the same with source.	400	优先级个数与源站个数不同
NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.	400	用中国大陆资源时，账号需要国际认证