查詢 RTC 雲轉碼任務狀態 - DescribeRtcCloudTranscode - ApsaraVideo for Live - 阿里雲 - ApsaraVideo Live

查詢雲端轉碼任務。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:DescribeRtcCloudTranscode

none

*All Resource

*

無

請求文法

POST  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
AppId	string	是	應用 ID。由大小寫字母、數字、底線、短劃線（-）組成，最大 64 字元。	******-7074--9ef5-85c19a4***
TaskId	string	是	雲端轉碼任務 ID。由大小寫字母、數字、底線、短劃線（-）組成，最大 64 字元。	****73-8501--8ac1-72295a****

返回參數

名稱	類型	描述	樣本值
	object	返回內容。
RequestId	string	請求 ID。	****3B-0E1A-586A-AC29-742247****
TaskInfo	object	雲端轉碼任務詳情資訊。
AppId	string	應用 ID。	******-7074--9ef5-85c19a4***
ChannelId	string	頻道 ID。	myChannel
TaskId	string	雲端轉碼任務 ID。	****73-8501--8ac1-72295a****
Status	string	雲端轉碼任務狀態： STARTING RUNNING RECOVERING STOPPED。	RUNNING
InputParam	object	訂閱輸入相關參數。
SingleSubUserParam	object	單流訂閱輸入參數。
UserId	string	訂閱的使用者識別碼。	userA
StreamType	integer	訂閱使用者的媒體類型。	0
SourceType	integer	訂閱的視頻輸入資料流類型。	0
OutputParams	array<object>	轉碼輸出相關參數。
	object	轉碼輸出參數。
ChannelId	string	轉碼流轉推到的頻道 ID。	myChannel
UserId	string	轉碼流轉推到頻道的使用者識別碼。	userA_360p
UserToken	string	轉碼流轉推到頻道所需的使用者 Token。	eyJhcHBpZCI********
TranscodeTemplate	string	轉碼模板名。	lhd
MaxIdleTime	integer	閒置逾時時間。當任務處於閒置狀態的時長超過 MaxIdleTime 時，自動停止任務。單位為秒，範圍須在[10,14400]內，即最大 4 小時。（預設為 300 秒）。	600

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "TaskInfo": {
    "AppId": "********-7074-****-9ef5-85c19a4*****",
    "ChannelId": "myChannel",
    "TaskId": "******73-8501-****-8ac1-72295a******",
    "Status": "RUNNING",
    "InputParam": {
      "SingleSubUserParam": {
        "UserId": "userA",
        "StreamType": 0,
        "SourceType": 0
      }
    },
    "OutputParams": [
      {
        "ChannelId": "myChannel",
        "UserId": "userA_360p",
        "UserToken": "eyJhcHBpZCI********",
        "TranscodeTemplate": "lhd"
      }
    ],
    "MaxIdleTime": 600
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	InvalidParameter%s	%s.
400	MissingParameter%s	%s.
400	TooManyRequests	%s.
500	InternalError	%s.
403	Forbidden	%s.
404	NotFound%s	%s.

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

變更歷史

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