使用GetLiveEditingJob查詢直播剪輯作業詳細資料-智能媒體服務-阿里雲

擷取剪輯合成作業的詳細資料，具體包括剪輯合成任務的任務狀態、時間軸、模板及資料、輸出成品資源ID、儲存地址、時間長度、以及任務其他資訊等。本介面僅支援查詢近一年的直播剪輯任務資料。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:GetLiveEditingJob

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
JobId	string	否	直播剪輯 Jobld	**d80e4e4044975745c14b**

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID	**36-3C1E-4417-BDB2-1E034F**
LiveEditingJob	object	直播剪輯任務
JobId	string	直播剪輯任務 ID	**cdb3e74639973036bc84**
ProjectId	string	直播剪輯工程 ID	**fddd7748b58bf1d47e95**
Status	string	直播剪輯作業狀態，取值可能為如下值： Init （初始狀態） Queuing（排隊中） Processing（處理中） Success（成功） Failed（失敗）	Success
Clips	string	剪輯片段列表	[{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" }]
UserData	string	使用者資料	{"key": "value'}
CreationTime	string	直播剪輯作業建立時間，格式為 utc 時間。	2020-12-23T13:33:40Z
ModifiedTime	string	直播剪輯作業修改時間，格式為 utc 時間。	2020-12-23T13:33:49Z
CompleteTime	string	直播剪輯作業完成時間，格式為 utc 時間。	2020-12-23T13:33:52Z
MediaId	string	輸出成品的資源 Id	**0cc6ba49eab379332c5b**
MediaURL	string	輸出成品的資源檔 URL	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4
Code	string	剪輯合成作業錯誤碼註：作業失敗時關注該欄位	InvalidParameter
Message	string	剪輯合成作業錯誤資訊註：作業失敗時關注該欄位	The specific parameter LiveStreamConfig is not valid.
LiveStreamConfig	object	直播剪輯配置
AppName	string	播流所屬應用程式名稱	app
DomainName	string	播流所屬網域名稱	domain.com
StreamName	string	播流所屬流名	streamName
MediaProduceConfig	object	直播剪輯合成配置
Mode	string	剪輯模式，預設 Accurate	Accurate
OutputMediaConfig	object	輸出成片的儲存配置
MediaURL	string	輸出成片的檔案地址	https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4
StorageLocation	string	當 OutputMediaTarget 的目標為 vod-media 時，指定 storage location 來儲存媒資到 VOD； storage location 是 VOD 中的檔案儲存體位置，不包含 http:// 的首碼，如：outin-xxxxxx.oss-cn-shanghai.aliyuncs.com。	outin-xxxxxx.oss-cn-shanghai.aliyuncs.com
FileName	string	當 OutputMediaTarget 的目標為 vod-media 時，指定 fileName（包含檔案尾碼，不含路徑）作為輸出檔案名	test.mp4
Width	integer	輸出成品的寬。可以不填，預設值是多個素材的最大寬	640
Height	integer	輸出成品的高。可以不填，預設值是多個素材的最大高	480
Bitrate	integer	輸出成品的碼率，單位為 Kbps。可以不填，預設值是多個素材的最高碼率	1000
VodTemplateGroupId	string	合成成片輸出到 vod，指定 vod 轉碼模板組。如不需要 VOD 轉碼，請填寫 "VOD_NO_TRANSCODE".	VOD_NO_TRANSCODE

樣本

正常返回樣本

JSON格式

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "LiveEditingJob": {
    "JobId": "****cdb3e74639973036bc84****",
    "ProjectId": "****fddd7748b58bf1d47e95****",
    "Status": "Success",
    "Clips": "[{\\\"StartTime\\\": \\\" 2021-06-21T08:01:00Z\\\",  \\\"EndTime\\\": \\\" 2021-06-21T08:03:00Z\\\" }]",
    "UserData": "{\"key\": \"value'}",
    "CreationTime": "2020-12-23T13:33:40Z",
    "ModifiedTime": "2020-12-23T13:33:49Z",
    "CompleteTime": "2020-12-23T13:33:52Z",
    "MediaId": "****0cc6ba49eab379332c5b****",
    "MediaURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4",
    "Code": "InvalidParameter",
    "Message": "The specific parameter LiveStreamConfig is not valid.",
    "LiveStreamConfig": {
      "AppName": "app",
      "DomainName": "domain.com",
      "StreamName": "streamName"
    },
    "MediaProduceConfig": {
      "Mode": "Accurate"
    },
    "OutputMediaConfig": {
      "MediaURL": "https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4",
      "StorageLocation": "outin-xxxxxx.oss-cn-shanghai.aliyuncs.com",
      "FileName": "test.mp4",
      "Width": 640,
      "Height": 480,
      "Bitrate": 1000,
      "VodTemplateGroupId": "VOD_NO_TRANSCODE"
    }
  }
}

錯誤碼

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

變更歷史

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