调用AddLiveDomain添加直播域名。

使用说明

  • 添加直播域名之前,必须先开通视频直播服务。具体操作请参见开通服务
  • 添加新的域名时,必须先进行验证,再调用本接口添加域名。您可以选择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

DomainName String example.aliyundoc.com

需要接入直播的推流域名或播流域名。支持泛域名,以英文句号(.)开头。

LiveDomainType String liveVideo

域名业务类型。取值:

  • liveVideo:播流域名。如果选择DomainName(需要接入直播的域名)为播流域名时,则域名业务类型必须选择为liveVideo。
  • liveEdge:边缘推流域名。如果选择DomainName(需要接入直播的域名)为推流域名时,则域名业务类型必须选择为liveEdge。
Region String cn-beijing

直播域名单元化信息。取值:

  • cn-beijing:北京。
  • cn-shanghai:上海。
  • cn-shenzhen:深圳。
  • cn-qingdao:青岛。
  • ap-southeast-1:新加坡。
  • eu-central-1:德国。
  • ap-northeast-1:东京。
  • ap-south-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格式

<AddLiveDomainResponse>
	  <RequestId>15C66C7B-671A-4297-9187-2C4477247A74</RequestId>
</AddLiveDomainResponse>

JSON格式

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

错误码

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