調用ListLiveRecordJobs獲取實時錄制任務列表,可分頁獲取。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ice:ListLiveRecordJobs | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Keyword | string | 否 | 搜索關鍵詞,可以根據任務 ID 和名稱搜索。 | ab0e3e76-1e9d-11ed-ba64-0c42a1b73d66 |
StartTime | string | 否 | 查詢開始時間。格式為 yyyy-mm-ddthh:mm:ssz(UTC 時間)。 | 2022-07-15T08:00:00Z |
EndTime | string | 否 | 查詢結束時間,與 StartTime 相差不超過 30 天。格式為 yyyy-mm-ddthh:mm:ssz(UTC 時間)。 | 2022-07-11T08:00:00Z |
Status | string | 否 | 任務狀態。默認不過濾狀態。 枚舉值:
| started |
PageNo | long | 否 | 分頁的頁碼。默認值:1。 | 1 |
PageSize | long | 否 | 分頁大小。默認值:10。 | 20 |
SortBy | string | 否 | 排序參數,默認按創建時間倒序。 枚舉值:
| desc |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "A27DFFA4-F272-5563-8363-CB0BC42740BA",
"LiveRecordJobs": [
{
"RecordOutput": {
"Type": "oss",
"Bucket": "imsbucket1",
"Endpoint": "oss-cn-hangzhou.aliyuncs.com"
},
"Name": "直播活動錄制任務1",
"NotifyUrl": "https://example.com/imsnotify",
"TemplateId": "69e1f9fe-1e97-11ed-ba64-0c42a1b73d66",
"CreateTime": "2022-07-20T03:26:36Z",
"StreamInput": {
"Type": "rtmp",
"Url": "rtmp://example-live.com/live/stream1"
},
"JobId": "ab0e3e76-1e9d-11ed-ba64-0c42a1b73d66",
"Status": "paused",
"TemplateName": "test template"
}
],
"TotalCount": 180,
"PageNo": 1,
"PageSize": 20,
"SortBy": "desc"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。