AddLiveDomain_视频直播_API文档-阿里云OpenAPI开发者门户

接口说明

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

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

QPS 限制

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

流控信息

请求速率为30/1(s)。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称	字段详情
LiveDomainTypestring	域名业务类型。取值：展开详情示例值:liveVideo枚举值:liveVideoliveEdgeliveGrtnPubliveGrtnSub参考取值来源: DescribeLiveUserDomains
DomainNamestring	需要接入直播的推流域名或播流域名。支持泛域名，以英文句号（.）开头。示例值:example.aliyundoc.com参考取值来源: DescribeDomainUsageData ListLiveRealtimeLogDeliveryDomains
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

返回示例

错误返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidDomainName.Malformed	Specified DomainName is malformed.	诊断
400	InvalidRegion.Malformed	Specified Region is malformed.	诊断
400	InvalidSource.Content.Malformed	Specified source content is malformed.	诊断
400	InvalidTypeContent.Mismatch	Specified source type does not math the specified source content.	诊断
400	MissingSource.Content	Specified source content is mandatory for this action.	诊断
400	MissingSource.Type	Specified source type is mandatory for this action.	诊断
400	InvalidSource.Type.Malformed	Specified source type is malformed.	诊断
400	InvalidSource.Priority.Malformed	Specified source priority is malformed.	诊断
400	InvalidScope.Malformed	Specified Scope is malformed.	诊断
400	SourceIp.Exceed	The Certificate you provided is malformed!	诊断
400	InvalidCertificate	The Certificate you provided is malformed!	诊断
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length!	诊断
400	InnerAddDomainDenied	Your account haven't bind aoneId, can not add domain.	诊断
400	CheckSourceHealthFailed	sources ip or source domain check health failed，please input right source.	诊断
400	ExtensiveAndAllBothExist	Extensive domain and the domain begins with 'all.' can not exist at the same time.	诊断
400	CdnTypeNotSupportExtensiveDomain	Extensive domain not supported for this cdn type.	诊断
400	ExtensiveAndSpecificDomainConflict	Extensive domain and corresponding specific domain are mutually exclusive.	诊断
400	InvalidDomainNameLevel	Domain name suffixed with alicdn.com only support third level.	诊断
400	TopLevelDomain.NotFound	TopLevelDomain is not exist.	诊断
400	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	NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.	诊断
400	RecordCheckNotAvailable	Please try again later.	诊断
400	IcpBlack	The domain is on the ICP blacklist.	诊断
400	IspBlack	The domain is on the ISP blacklist.	诊断
400	DomainNotRecordedAliyun	The domain not access Ali Cloud for the record please access.	诊断
400	Abs.CheckUrl.Malformed	The CheckUrl you provided is malformed!	诊断
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.	诊断
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.	诊断
400	InvalidResourceGroupId.Malformed	Specified ResourceGroupId is malformed.	诊断
400	DomainReserved	The root domain of your domain is reserved by another account.	诊断
400	ExceedLimit	The number of domains has exceeded the limit.	诊断
400	LockFail	Domain has been occupied.	诊断
403	AccountException	Account exception. Please open ticket to make an appeal.	诊断
403	EntityNotExist.ResourceGroup	The resource group does not exist.	诊断
404	InvalidUser	The user's account is invalid.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-10-24	新增请求参数Tag
	2024-09-25	变更错误码403 新增请求参数ResourceGroupId
	2023-05-09	变更错误码400
	2022-12-22	变更错误码400