添加直播域名 -

使用说明

添加直播域名之前，必须先开通视频直播服务。具体操作请参见开通服务。
添加新的域名时，必须先进行验证，再调用本接口添加域名。您可以选择DNS解析验证或文件验证。请参见验证域名归属权。
使用视频直播需要进行推流和播流，您需要分别添加推流域名和播流域名，一次只能提交一个域名。
完成添加域名操作后，还需要对添加的域名进行CNAME解析，请参见配置CNAME域名解析。
在添加推流域名和播流域名后，您需要关联域名，才能使用视频直播服务，具体操作请参见关联域名。

重要从2019年2月19日起，通过AddLiveDomain添加的域名不支持中心推流的方式，通过CDN API添加的新域名同样不支持中心推流。请使用边缘推流添加一个推流域名（调用AddLiveDomain，业务类型为liveEdge），一个播流域名（调用AddLiveDomain，业务类型为liveVideo），并做关联（调用AddLiveDomainMapping），2019年2月19日之前添加的域名不受影响。

QPS限制

本接口的单用户QPS限制为30次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	AddLiveDomain	系统规定参数。取值：AddLiveDomain。
LiveDomainType	String	是	liveVideo	域名业务类型。取值： liveVideo：播流域名。如果选择DomainName（需要接入直播的域名）为播流域名时，则域名业务类型必须选择为liveVideo。 liveEdge：边缘推流域名。如果选择DomainName（需要接入直播的域名）为推流域名时，则域名业务类型必须选择为liveEdge。
DomainName	String	是	example.aliyundoc.com	需要接入直播的推流域名或播流域名。支持泛域名，以英文句号（.）开头。
Region	String	是	cn-beijing	直播域名单元化信息。取值： cn-beijing：北京。 cn-shanghai：上海。 cn-shenzhen：深圳。 cn-qingdao：青岛。 ap-southeast-1：新加坡。 eu-central-1：德国。 ap-northeast-1：东京。 ap-southeast-5：雅加达。说明 Region（直播域名单元化信息）与Scope（加速区域）之间不存在相互限制。
CheckUrl	String	否	http://demo.aliyundoc.com/status.html	健康检测URL。
Scope	String	否	domestic	加速区域。国际用户、中国站L3及以上用户设置有效。取值： domestic（默认值）：中国内地。 overseas：海外及港澳台加速。 global：全球加速。
TopLevelDomain	String	否	learn.aliyundoc.com	顶级接入域。

返回数据

名称	类型	示例值	描述
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddLiveDomain
&DomainName=example.aliyundoc.com
&LiveDomainType=liveVideo
&Region=cn-beijing
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<AddLiveDomainResponse>
	<RequestId>15C66C7B-671A-4297-9187-2C4477247A74</RequestId>
</AddLiveDomainResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode	错误码	错误信息	描述
400	NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.	你需要使用真正的授权身份来访问中国大陆的资源
400	DomainReserved	The root domain of your domain is reserved by another account.	此域名的根域名已添加到其他账号。

访问错误中心查看更多错误码。