调用本接口添加点播加速域名。
接口说明
- 目前服务地址仅支持：华东 2（上海）。
- 创建加速域名之前，您需要先开通点播服务，并且加速域名必须已备案完成。
- 源站内容。如果不在阿里云平台上，需要审核，审核工作会在下一工作日前完成。
- 每次只能提交一个加速域名，一个用户最多添加 20 个域名。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| vod:AddVodDomain |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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 |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "15C66C7B-671A-4297-****-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 | 用中国大陆资源时，账号需要国际认证。 |