调用AddLiveDomain添加直播域名,一次只能提交一个域名。
限制条件:
- 创建直播域名之前,必须先开通视频直播服务。具体操作,请参见开通服务。
- 直播域名必须已备案完成。
说明 从2019年2月19日起,通过AddLiveDomain添加的域名不支持中心推流的方式;通过CDN API添加的新域名同样不支持中心推流。请使用边缘推流创建一个推流域名(调用AddLiveDomain,业务类型为liveEdge),一个播流域名(调用AddLiveDomain,业务类型为liveVideo),并做关联(调用AddLiveDomainMapping),2019年2月19日之前创建的域名不受影响。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AddLiveDomain |
系统规定参数。取值:AddLiveDomain。 |
DomainName | String | 是 | live.yourdomain.com |
需要接入直播的域名。支持泛域名,以英文句号(.)开头。 |
LiveDomainType | String | 是 | liveVideo |
域名业务类型。取值:
|
Region | String | 是 | cn-beijing |
直播域名单元化信息。取值:
|
CheckUrl | String | 否 | http://live.yourdomain.com/status.html |
健康检测URL。 |
Scope | String | 否 | domestic |
加速区域。国际用户、国内L3及以上用户设置有效。取值:
|
TopLevelDomain | String | 否 | www.yourTopLevelDomain |
顶级接入域。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=AddLiveDomain
&DomainName=live.yourdomain.com
&LiveDomainType=liveVideo
&Region=cn-beijing
&<公共请求参数>
正常返回示例
XML
格式
<AddLiveDomainResponse>
<RequestId>15C66C7B-671A-4297-9187-2C4477247A74</RequestId>
</AddLiveDomainResponse>
JSON
格式
{
"RequestId":"15C66C7B-671A-4297-9187-2C4477247A74"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交