調用GetEditingProject查詢單個雲剪輯工程資訊-智能媒體服務-阿里雲 - Intelligent Media Services

查詢單一雲端剪輯專案的資訊。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:GetEditingProject

get

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
ProjectId	string	是	雲端剪輯專案 ID。	**fb2101bf24b2754cb318787dc**
RequestSource	string	否	請求來源標識。 -OpenAPI：預設，不會進行時間軸轉換操作。 -WebSDK：若傳入該欄位，則會自動將專案時間軸轉換為前端風格，並將時間軸中關聯素材與專案綁定，供前端 WebSDK 預覽。	WebSDK

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID。	**63E8B7C7-4812-46AD-0FA56029AC86**
Project	object	雲端剪輯專案。
ProjectId	string	雲端剪輯專案 ID。	**fb2101bf24b2754cb318787dc**
Title	string	雲端剪輯專案標題。	範例 title
Timeline	string	雲端剪輯專案時間軸。	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"**9b4d7cf14dc7b83b0e801cbe"},{"MediaId":"9b4d7cf14dc7b83b0e801cbe"},{"MediaId":"1656bca4474999c961a6d2a2**"}]}]}
TemplateId	string	範本 ID。	**96e8864746a0b6f3**
ClipsParam	string	範本對應的素材參數，JSON 格式，當 TemplateId 不為空時，ClipsParam 不能為空。具體格式請參閱普通範本建立及使用、進階範本建立及使用。	請參閱範本使用文件
Description	string	雲端剪輯專案描述。	範例描述
CoverURL	string	雲端剪輯專案封面。	http://aaa.bbb/your-cover.jpg
CreateTime	string	雲端剪輯專案建立時間。時間格式為 ISO 8601，使用 UTC 時間（以 Z 結尾）。	2020-12-20T12:00:00Z
ModifiedTime	string	雲端剪輯專案最新修改時間。時間格式為 ISO 8601，使用 UTC 時間（以 Z 結尾）。	2020-12-20T13:00:00Z
Duration	integer	雲端剪輯專案總時長。	24.120000
Status	string	雲端剪輯專案狀態。所有雲端剪輯專案狀態清單： -Draft -Editing -Producing -Produced -ProduceFailed -Deleted	Editing
CreateSource	string	雲端剪輯專案建立方式。 -OpenAPI -AliyunConsole -WebSDK -LiveEditingOpenAPI -LiveEditingConsole	OpenAPI
TemplateType	string	雲端剪輯專案範本類型。 -Timeline -VETemplate	Timeline
ModifiedSource	string	雲端剪輯專案編輯方式。 -OpenAPI -AliyunConsole -WebSDK -LiveEditingOpenAPI -LiveEditingConsole	OpenAPI
ProjectType	string	剪輯專案類型，預設為 EditingProject。 - EditingProject：普通剪輯專案 - LiveEditingProject：直播剪輯專案	EditingProject
BusinessConfig	string	專案業務設定，一般剪輯專案可忽略。	{ "OutputMediaConfig" : { "StorageLocation": "test-bucket.oss-cn-shanghai.aliyuncs.com", "Path": "test-path" }, "OutputMediaTarget": "oss-object", "ReservationTime": "2021-06-21T08:05:00Z" }
BusinessStatus	string	專案業務狀態，一般剪輯專案可忽略。預約中：Reserving 預約取消：ReservationCanceled 直播中：BroadCasting 載入失敗：LoadingFailed 直播結束：LiveFinished	Reserving
TimelineConvertStatus	string	專案轉換狀態，API 風格時間軸轉換為前端風格時間軸是一個非同步過程，只有在設定 RequestSource:WebSDK 時生效。 -Unconverted：未進行時間軸轉換 -Converting：專案正在轉換中 -Converted：專案轉換完成 -ConvertFailed：專案轉換失敗	Converted
TimelineConvertErrorMessage	string	專案轉換失敗資訊，只有 TimelineConvertStatus 為 ConvertFailed 時回傳，專案轉換的詳細失敗資訊。	The StorageLocation must be in the same division(apiRegion) as ICE service access point.

樣本

正常返回樣本

JSON格式

{
  "RequestId": "****63E8B7C7-4812-46AD-0FA56029AC86****",
  "Project": {
    "ProjectId": "****fb2101bf24b2754cb318787dc****",
    "Title": "样本title",
    "Timeline": "{\"VideoTracks\":[{\"VideoTrackClips\":[{\"MediaId\":\"****9b4d7cf14dc7b83b0e801cbe****\"},{\"MediaId\":\"****9b4d7cf14dc7b83b0e801cbe****\"},{\"MediaId\":\"****1656bca4474999c961a6d2a2****\"}]}]}",
    "TemplateId": "****96e8864746a0b6f3****",
    "ClipsParam": "见模板使用文档",
    "Description": "示例描述",
    "CoverURL": "http://aaa.bbb/your-cover.jpg",
    "CreateTime": "2020-12-20T12:00:00Z",
    "ModifiedTime": "2020-12-20T13:00:00Z",
    "Duration": 24.12,
    "Status": "Editing",
    "CreateSource": "OpenAPI",
    "TemplateType": "Timeline",
    "ModifiedSource": "OpenAPI",
    "ProjectType": "EditingProject",
    "BusinessConfig": "{ \"OutputMediaConfig\" : { \"StorageLocation\": \"test-bucket.oss-cn-shanghai.aliyuncs.com\", \"Path\": \"test-path\" }, \"OutputMediaTarget\": \"oss-object\", \"ReservationTime\": \"2021-06-21T08:05:00Z\" }",
    "BusinessStatus": "Reserving",
    "TimelineConvertStatus": "Converted",
    "TimelineConvertErrorMessage": "The StorageLocation must be in the same division(apiRegion) as ICE service access point."
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidParameter	The specified parameter \ is not valid.

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

變更歷史

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