调用本接口添加点播加速域名。
接口说明
目前服务地址仅支持：华东 2（上海）。
创建加速域名之前，您需要先开通点播服务，并且加速域名必须已备案完成。
源站内容。如果不在阿里云平台上，需要审核，审核工作会在下一工作日前完成。
每次只能提交一个加速域名，一个用户最多添加 20 个域名。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vod:AddVodDomain |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DomainName |
string |
是 |
需要接入点播的加速域名。支持泛域名，以英文句号（.）开头，如：.example.com。 |
example.com |
| Sources |
string |
是 |
回源地址列表。参数详情，请参见下表 Sources。 |
[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}] |
| CheckUrl |
string |
否 |
健康检测 URL。 |
www.example.com/test.html |
| Scope |
string |
否 |
国际用户、中国内地 L3 及以上用户设置有效。 取值范围：
|
domestic |
| TopLevelDomain |
string |
否 |
顶级接入域。 |
example.com |
Sources
| 名称 | 类型 | 是否必需 | 描述 |
| type | String | 是 | 源站类型。取值： ipaddr：IP 源站。 domain：域名源站。 oss：OSS Bucket 为源站。 |
| content | String | 是 | 回源地址，可以是 IP 或域名。 |
| port | Integer | 否 | 端口号。可以指定 443、80。默认值 80。443 端口使用 HTTPS 回源。也可以自定义端口。 |
| priority | String | 否 | 源站地址对应的优先级。支持 20 和 30，默认值为 20。20 是主源，30 是备源。 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
15C66C7B-671A-4297-****-2C4477247A74 |
示例
正常返回示例
JSON格式
{
"RequestId": "15C66C7B-671A-4297-****-2C4477247A74"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidDomainName.Malformed | Specified DomainName is malformed. | |
| 400 | MissingParameter | The input parameter cdnType that is mandatory for processing this request is not supplied. | |
| 400 | InvalidCdnType.Malformed | Specified CdnType is malformed. | |
| 400 | InvalidSources.Malformed | Specified Sources is malformed. | 源站信息格式错误。 |
| 400 | InvalidSourceStr.Malformed | Specified SourceStr is malformed. | 传入源站信息格式错误。 |
| 400 | InvalidSourceType.Malformed | Specified CdnType is malformed. | |
| 400 | InvalidSource.Priority.Malformed | The specified Source Priority is invalid. | |
| 400 | InvalidTypeAndContent.MissMatch | The specified source type does not match the specified source content. | |
| 400 | InvalidScope.Malformed | Specified Scope is malformed. | |
| 400 | DomainOverLimit | The Number of Domain is over the limit | |
| 400 | DomainAlreadyExist | This domain name is exist already | |
| 400 | DomainNotRegistration | The Domain name is not registered | |
| 400 | InvaildParameter | Source name can not equal to domain name | |
| 400 | IllegalSources | The specified origin site information is invalid. | 加速域名源站信息错误。 |
| 400 | SourceIp.Exceed | The Certificate you provided is malformed! | |
| 400 | InvalidCertificate | The Certificate you provided is malformed! | |
| 400 | InvalidCertificate.TooLong | The Certificate you provided is over the max length! | |
| 400 | InnerAddDomainDenied | Your account haven't bind aoneId, can not add domain. | |
| 400 | CheckSourceHealthFailed | sources ip or source domain check health failed，please input right source. | |
| 400 | ExtensiveAndAllBothExist | Extensive domain and the domain begins with 'all.' can not exist at the same time. | |
| 400 | CdnTypeNotSupportExtensiveDomain | Extensive domain not supported for this cdn type. | |
| 400 | ExtensiveAndSpecificDomainConflict | Extensive domain and corresponding specific domain are mutually exclusive. | 泛域名和同级精确域名互斥，请重新添加。 |
| 400 | DomainReserved | The root domain of your domain is reserved by another account. Submit a ticket to contact customer support. | 当前根域名已被使用。请提交工单咨询。 |
| 400 | InvalidDomainNameLevel | Domain name suffixed with alicdn.com only support third level. | |
| 400 | InvalidTopLevelDomain.Malformed | Specified TopLevelDomain is malformed. | |
| 400 | TopLevelDomain.NotFound | The specified TopLevelDomain does not exist. | |
| 400 | 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 | TopLevelDomain.Mismatch | The specified TopLevelDomain does not match webSiteType. | |
| 400 | DomainOwnerVerifyFail | Owner verification of the root domain failed. | 域名验证失败。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。