AddLivePullStreamInfoConfig_视频直播_API文档

2016-11-01

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

请确保在使用该接口前，已充分了解直播拉流的收费方式和价格。计费详情，请参见标准直播。
拉流是将第三方直播流地址拉取到阿里直播中心进行加速分发的过程。
本接口仅支持固定拉流方式，即指定拉流的起始时间和结束时间，在指定时间进行拉流直播。
控制台支持固定拉流和触发拉流两种方式，详细内容请参见拉流配置。
AppName 与 StreamName 可自定义修改，不同的值生成不同的直播流地址。可用地址生成器生成。
(DomainName, AppName, StreamName)三元组只能对应一个配置，如果该三元组已经存在一个配置了，再调用本接口添加配置会返回配置已存在错误。

QPS 限制

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

流控信息

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

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

live:AddLivePullStreamInfoConfig	Create	Domain acs:cdn:*:{#accountId}:domain/{#DomainName}	无	无

请求参数

字段名称	字段详情
DomainNamestring	您的拉流域名为用户的主播流域名。示例值:example.com参考取值来源: AddLiveDomain DescribeDomainUsageData ListLiveRealtimeLogDeliveryDomains
AppNamestring	直播流所属应用名称，用户自定义。示例值:liveApp****参考取值来源: GetMessageApp ListMessageApp QueryMessageApp CreateMessageApp
StreamNamestring	直播流名，用户自定义。示例值:liveStream****参考取值来源: AddLiveStreamMerge DescribeMixStreamList QueryLiveDomainMultiStreamList
SourceUrlstring	用户的直播流所在的源站完整 url。多个源站可以填多个地址，用英文分号（;）分隔。展开详情示例值:rtmp://guide.aliyundoc.com/liveApp**/liveStream;rtmp://developer.aliyundoc.com/liveApp/liveStream**
StartTimestring	拉流开始时间。展开详情示例值:2017-12-21T08:00:00Z
EndTimestring	拉流结束时间。展开详情示例值:2017-12-22T08:00:00Z

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:16A96B9A-F203-4EC5-8E43-CB92E68F4CF8

返回示例

错误码

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

全局错误码

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

400	InvalidStartTime.Malformed	Specified StartTime is malformed.	诊断
400	InvalidEndTime.Malformed	Specified EndTime is malformed.	诊断
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time or current time.	诊断
400	Duration.Exceed	Duration between StartTime and EndTime is too long.	诊断
400	ConfigAlreadyExists	Config has already exist.	诊断
400	PullStreamOverLimit	Pull stream is over limit for this domainName.	诊断
400	InvalidParam	Parameter invalid.	诊断
500	InternalError	The request processing has failed due to backend service exception.	诊断

变更历史

暂无变更历史

相关示例

添加直播拉流配置

调用AddLivePullStreamInfoConfig添加直播拉流配置信息。

2022-03-14