AddLiveDomain
调用该接口添加直播域名,一次只能提交一个域名
服务地址:
华东2(上海)
输入参数
只看必填
LiveDomainType域名业务类型
DomainName需要接入直播的推流域名或播流域名
Region直播域名单元化信息
CheckUrl健康检测URL
Scope加速区域
TopLevelDomain顶级接入域
ResourceGroupId资源组ID
Tag标签列表
0标签列表
Key标签健
Value标签值
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 添加直播域名之前,必须先开通视频直播服务。具体操作请参见开通服务

  • 添加新的域名时,必须先进行验证,再调用本接口添加域名。您可以选择 DNS 解析验证或文件验证。请参见验证域名归属权

  • 使用视频直播需要进行推流和播流,您需要分别添加推流域名和播流域名,一次只能提交一个域名。

  • 完成添加域名操作后,还需要对添加的域名进行 CNAME 解析,请参见配置 CNAME 域名解析

  • 在添加推流域名和播流域名后,您需要关联域名,才能使用视频直播服务,具体操作请参见关联域名

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

QPS 限制

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

请求参数

字段名称字段详情
LiveDomainTypestring

域名业务类型。取值:展开详情

示例值:liveVideo枚举值:liveVideoliveEdgeliveGrtnPubliveGrtnSub
DomainNamestring

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

示例值:example.aliyundoc.com
Regionstring

直播域名单元化信息。取值:展开详情

示例值:cn-beijing
CheckUrlstring

健康检测 URL。

示例值:http://demo.aliyundoc.com/status.html
Scopestring

加速区域。国际用户、中国站 L3 及以上用户设置有效。取值:展开详情

示例值:domestic
TopLevelDomainstring

顶级接入域。

示例值:learn.aliyundoc.com
ResourceGroupIdstring

资源组 ID。关于资源组的更多信息,请参见什么是资源组

示例值:rg-aekzw******
Tagarray<object>

标签列表。

子级条数 <= 21

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:16A96B9A-F203-4EC5-8E43-CB92E68F4CD8
变更历史
暂无变更历史