全部產品
Search
文件中心

ApsaraVideo Media Processing:ListMediaWorkflowExecutions - 遍曆媒體工作流程執行執行個體

更新時間:Feb 25, 2026

遍曆媒體工作流程執行執行個體。

介面說明

本介面只返回近 90 天執行執行個體。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理調用。更多資訊,請參見 QPS 限制

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:ListMediaWorkflowExecutions

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

MediaWorkflowId

string

需要查詢執行個體的媒體工作流程 ID。可以通過 MPS 控制台 > 工作流程管理 > 工作流程設定擷取。

43b7335a4b1d4fe883670036affb****

MediaWorkflowName

string

媒體工作流程名稱。可以通過 MPS 控制台 > 工作流程管理 > 工作流程設定擷取。

example-mediaworkflow-****

InputFileURL

string

媒體工作流程指定的輸入檔案 OSS Bucket。遵循 RFC 3986(UTF8 編碼,並對保留字元進行 URLEncode)。更多資訊,請參見 URLEncode 說明

http://example-****.cn-hangzhou.aliyuncs.com/test****.flv

NextPageToken

string

下一頁標識,32 位 UUID。請求第一頁時,NextPageToken 為空白;請求後續檔案時需傳入前一頁查詢結果中的 NextPageToken 值。

39f8e0bc005e4f309379701645f4****

MaximumPageSize

integer

最大可返回的媒體工作流程執行執行個體數。取值範圍:[1,100],預設值:10

1

返回參數

名稱

類型

描述

樣本值

object

返回參數。

MediaWorkflowExecutionList

object

MediaWorkflowExecution

array<object>

媒體工作流程列表。

array<object>

詳細資料。

CreationTime

string

建立時間。

2016-04-01T06:53:43Z

MediaWorkflowId

string

媒體工作流程 ID。

43b7335a4b1d4fe883670036affb****

State

string

工作流程狀態。可取值:

  • Running:執行中。

  • Completed:執行完成。

說明

Completed 僅表示工作流程執行完成,每個活動(轉碼、截圖等)是否成功要看每個活動具體的狀態值。

  • Fail:執行失敗。

  • Success:執行成功。

Success

ActivityList

object

Activity

array<object>

媒體工作流程活動列表。

array<object>

詳細資料。

EndTime

string

活動結束執行時間。

2016-04-01T06:54:00Z

Type

string

媒體工作流程活動類型。可取值:Start 活動、Snapshot 活動、Transcode 活動、Analysis 活動、Report 活動。更多資訊請參見媒體工作流程活動介紹

Start

StartTime

string

活動開始執行時間。

2016-04-01T06:53:45Z

State

string

活動狀態。可取值:

  • Running:活動執行中。

  • Fail:活動執行失敗。

  • Skipped:活動被跳過。

  • Success:執行成功。

說明

例如:分析活動之後有高清、標清兩個轉碼活動,會根據實際分析的結果來決策,如果原視頻內容清晰度不夠,高清的轉碼活動就可能被跳過。

Success

JobId

string

活動執行時產生的作業 ID。建議您儲存此 ID 便於後續調用其他介面時使用。

2376030d9d0849399cd20e20c876****

Code

string

錯誤碼。

  • 如果活動狀態是 Fail,會給出具體的錯誤碼。

  • 如果活動狀態是 Success,此參數不返回。

null

Message

string

錯誤資訊。

  • 如果活動狀態是 Fail,會給出詳細的錯誤描述資訊。

  • 如果活動狀態是 Success,此參數不返回。

null

Name

string

媒體工作流程活動名稱。

說明

在同一個工作流程中活動的名稱是唯一的。

Act-2

MNSMessageResult

object

MNS 通知使用者作業完成結果。

MessageId

string

執行成功時訊息 ID。如果執行失敗則不返回此參數。

4f3bc83233de4e2f81c7dade443e****

ErrorMessage

string

執行失敗時錯誤資訊。如果執行成功則不返回此參數。

MessageConfigEmpty

ErrorCode

string

執行失敗時錯誤碼。如果執行成功則不返回此參數。

The Topic/Queue config is empty, not send message

Name

string

媒體工作流程名稱。

example-mediaworkflow-****

Input

object

媒體工作流程的使用者自訂資料。

UserData

string

使用者自訂資料。

example data

InputFile

object

媒體工作流程的輸入 OSS Bucket。

Object

string

輸入檔案的 OSS Object。

example-mediaWorkflow-****/example-object-****/example.mp4

Location

string

輸入檔案的 OSS Location。

cn-shanghai

Bucket

string

輸入檔案的 OSS Bucket。

example-bucket-****

MediaId

string

媒體 ID。媒體工作流程產生的所有資訊都屬於這個媒體 ID。

512046582a924698a41e0f8b0d2b****

RunId

string

執行執行個體 ID。

48e33690ac19445488c706924321****

RequestId

string

請求 ID。

D1D5C080-8E2F-5030-8AB4-13092F17631B

NextPageToken

string

下一頁標識。

39f8e0bc005e4f309379701645f4****

樣本

正常返回樣本

JSON格式

{
  "MediaWorkflowExecutionList": {
    "MediaWorkflowExecution": [
      {
        "CreationTime": "2016-04-01T06:53:43Z",
        "MediaWorkflowId": "43b7335a4b1d4fe883670036affb****",
        "State": "Success",
        "ActivityList": {
          "Activity": [
            {
              "EndTime": "2016-04-01T06:54:00Z",
              "Type": "Start",
              "StartTime": "2016-04-01T06:53:45Z",
              "State": "Success",
              "JobId": "2376030d9d0849399cd20e20c876****",
              "Code": "null",
              "Message": "null",
              "Name": "Act-2",
              "MNSMessageResult": {
                "MessageId": "4f3bc83233de4e2f81c7dade443e****",
                "ErrorMessage": "MessageConfigEmpty",
                "ErrorCode": "The Topic/Queue config is empty, not send message"
              }
            }
          ]
        },
        "Name": "example-mediaworkflow-****",
        "Input": {
          "UserData": "example data",
          "InputFile": {
            "Object": "example-mediaWorkflow-****/example-object-****/example.mp4",
            "Location": "cn-shanghai",
            "Bucket": "example-bucket-****"
          }
        },
        "MediaId": "512046582a924698a41e0f8b0d2b****",
        "RunId": "48e33690ac19445488c706924321****"
      }
    ]
  },
  "RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B",
  "NextPageToken": "39f8e0bc005e4f309379701645f4****"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情