調用CreateLivePullToPush建立拉流轉推任務-ApsaraVideo for Live-阿里雲

調用CreateLivePullToPush建立拉流轉推任務。

介面說明

重要拉流轉推屬於收費功能，於 2025 年 12 月 05 日 00:00 起正式計費。

費用詳情請參見拉流轉推費用。
調用本介面建立拉流轉推任務。
支援建立直播拉流任務，也支援建立點播拉流任務。
任務建立後，到了設定的開始時間，會真正開始運行，到了設定的結束時間，會自動停止並刪除清理。
任務中設定的推流目標地址需要確保未被其他任務使用，不然會因為多個任務同時轉推相同地址導致推流失敗。
拉流轉推回調事件包括拉流轉推任務運行狀態變化回調和拉流轉推任務已退出回調。更多資訊，請參見拉流轉推事件回調。

QPS 限制

本介面的單使用者 QPS 限制為 10 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:CreateLivePullToPush

create

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	否	地區 ID。	cn-beijing
Region	string	是	指定任務啟動所在地區，取值： ap-southeast-1（新加坡） ap-southeast-5（印尼） cn-beijing（北京） cn-shanghai（上海） cn-shenzhen（深圳）	cn-shanghai
TaskName	string	否	任務名稱，用於支援模糊查詢，預設值為""。	test
StartTime	string	是	任務開始時間。說明格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2024-08-26T10:30:00Z
EndTime	string	是	任務結束時間。說明格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 EndTime 必須大於 StartTime。 EndTime 必須大於目前時間。	2024-08-27T14:30:00Z
SourceType	string	是	源流類型，枚舉值： live，直播流。 vod，阿里雲ApsaraVideo for VOD資源。 url，第三方視頻檔案資源。	live
SourceProtocol	string	否	源流協議名。取值範圍 rtmp srt http-flv hls 說明此參數僅當sourcetype 參數取值為 live 時必填，取值為 vod、url 時無效。	rtmp
SourceUrls	array	是	源流 URL 地址清單。說明 live 類型僅支援填寫 1 個完整直播播放 URL。 vod、url 類型可填寫最多 30 個。 live 類型支援：rtmp、srt、http-flv 協議。 vod 類型填寫阿里雲ApsaraVideo for VOD媒資 ID。 url 類型支援：mp4、http-flv 協議。	testurls
	string	否	源流 URL 地址。說明 live 類型僅支援填寫 1 個完整直播播放 URL。 vod、url 類型可填寫最多 30 個。 live 類型支援：rtmp、srt、http-flv 協議。 vod 類型填寫阿里雲ApsaraVideo for VOD媒資 ID。 url 類型支援：mp4、http-flv 協議。	rtmp://pulltest.****.aliyunlive.com/pulltest493/pulltest-w434
DstUrl	string	是	推流目標 URL 地址。說明支援 rtmp 協議。最大長度為 2000 個字元。	rtmp://pushtest.********.aliyunlive.com/pulltest493/pulltest-w434
RepeatNumber	integer	否	播放完後重複繼續播放的次數。取值： 0（預設值）：不重複播放。 -1：一直迴圈重複。其他正整數：播放完後重複繼續播放的次數。說明此參數僅針對點播或第三方視頻流。	0
FileIndex	integer	否	檔案索引，從第 n 個檔案開始播放起。	0
Offset	integer	否	啟動位移，視頻檔案起始位移值。單位：秒。取值：大於 0。說明表示從相對於首幀的偏差時間作為開始讀取的位置（指第一個視頻）。此參數僅針對點播或第三方視頻流。	2
CallbackUrl	string	否	HTTP 回調地址，預設為空白。說明接收任務相關回調的地址。最大長度為 2000 個字元。不指定本參數則不會回調相關任務事件。	https://callback*****.com
RetryInterval	integer	否	稍候再試，單位秒，取值區間[60,300]，預設 60 秒。	60
RetryCount	integer	否	重試次數，預設值為 3。	3

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID。	16A96B9A-F203-4EC5-8E43-CB92E68*****
RetCode	integer	返回碼。說明正常情況返回“0”。異常情況請參考下文錯誤碼列表。	0
Description	string	錯誤描述。	OK
TaskId	string	任務 ID。	fd245384-4067-4f91-9d75-9666a6bc9****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK",
  "TaskId": "fd245384-4067-4f91-9d75-9666a6bc9****"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidParameter	%s.	參數錯誤
400	InvalidParam.CodeIllegalDuration	%s.	開始時間應該小於結束時間。
400	CodeInvalidAliUid	This aliuid does not have a live domain name.	這個aluid沒有直播網域名稱
400	CodeNotEnoughResource	Exceeded configuration limits or insufficient resources.	超過配置限制或沒有充足資源
400	CodeConfigAlreadyExists	Code Config Already Exists	配置已經存在
500	InternalError	%s.	直播 liveapi 服務端錯誤。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。