調用AddLivePullStreamInfoConfig添加直播拉流配置信息。
使用說明
- 拉流是將第三方直播流地址拉取到阿里直播中心進行加速分發的過程。
- 本接口僅支持固定拉流方式,即指定拉流的起始時間和結束時間,在指定時間進行拉流直播。
- 控制臺支持固定拉流和觸發拉流兩種方式,詳細內容請參見拉流配置。
QPS限制
本接口的單用戶QPS限制為15次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | AddLivePullStreamInfoConfig | 系統規定參數。取值:AddLivePullStreamInfoConfig。 |
DomainName | String | 是 | example.com | 您的拉流域名為用戶的主播流域名。 |
AppName | String | 是 | liveApp**** | 直播流所屬應用名稱,用戶自定義。 |
StreamName | String | 是 | liveStream**** | 直播流名,用戶自定義。 |
SourceUrl | String | 是 | rtmp://guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream**** | 用戶的直播流所在的源站完整url。多個源站可以填多個地址,用英文分號(;)分隔。 說明 僅支持拉取直播流,支持RTMP、FLV、HLS、SRT格式。 |
StartTime | String | 是 | 2017-12-21T08:00:00Z | 拉流開始時間。 StartTime和EndTime時間間隔在7天內。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
EndTime | String | 是 | 2017-12-22T08:00:00Z | 拉流結束時間。 StartTime和EndTime時間間隔在7天內,且EndTime超過當前時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CF8 | 請求ID。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=AddLivePullStreamInfoConfig
&AppName=liveApp****
&DomainName=example.com
&EndTime=2017-12-22T08:00:00Z
&StartTime=2017-12-21T08:00:00Z
&SourceUrl=rtmp://guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream****
&StreamName=liveStream****
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<AddLivePullStreamInfoConfigResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</AddLivePullStreamInfoConfigResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime參數錯誤,請您確認該StartTime參數是否正確。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間錯誤,請您確認結束時間是否正確。 |
400 | ConfigAlreadyExists | Config has already exist. | 配置已添加。 |
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?