全部產品
Search
文件中心

ApsaraVideo Media Processing:QueryMediaWorkflowExecutionList - 查詢媒體工作流程執行執行個體

更新時間:Feb 25, 2026

查詢媒體工作流程執行執行個體。

介面說明

  • 本介面一次最多查詢 10 個媒體工作流程執行執行個體。

  • 請確保工作流程中使用的管道為開啟狀態,否則可能會導致工作流程無法正常使用(比如:工作流程節點顯示已失效、工作流程狀態一直卡在已提交等)。

QPS 限制

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

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:QueryMediaWorkflowExecutionList

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

RunIds

string

媒體工作流程執行執行個體 ID 列表,可以通過 MPS 控制台 > 工作流程管理 > 執行執行個體擷取。使用半形逗號(,)分隔,一次最多查詢 10 個。

48e33690ac19445488c706924321****

返回參數

名稱

類型

描述

樣本值

object

返回參數。

NonExistRunIds

object

RunId

array

不存在的媒體工作流程執行個體列表。

string

不存在的執行執行個體 ID。如果沒有則此參數不返回。

null

MediaWorkflowExecutionList

object

MediaWorkflowExecution

array<object>

媒體工作流程列表。

array<object>

媒體工作流程詳細資料。

CreationTime

string

建立時間。

016-04-01T06:53:43Z

MediaWorkflowId

string

媒體工作流程 ID。

93ab850b4f6f44eab54b6e91****81d4

State

string

狀態。取值:

  • Running:執行中。

  • Completed:執行完成。

說明

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

  • Fail:執行失敗。

Completed

ActivityList

object

Activity

array<object>

媒體工作流程活動列表。

array<object>

媒體工作流程活動詳情。

EndTime

string

活動結束執行時間。

2016-04-01T06:53:44Z

Type

string

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

Start

StartTime

string

活動開始執行時間。

2016-04-01T06:53:44Z

State

string

狀態。取值:

  • Running:活動執行中。

  • Success:活動執行成功。

  • Fail:活動執行失敗。

  • Skipped:活動被跳過。

說明

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

Running

JobId

string

活動執行時產生的作業 ID(例如分析作業 ID、轉碼作業 ID、截圖作業 ID)。

2376030d9d0849399cd20e20f4f3****

Code

string

錯誤碼。

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

  • 當活動狀態是 Success 時,不返回此參數。

InvalidParameter.ResourceContentBad

Message

string

錯誤資訊。

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

  • 當活動狀態是 Success 時,此參數不返回。

The resource operated InputFile is bad

Name

string

媒體工作流程活動名稱。

說明

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

Start

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

媒體工作流程的輸入檔案。

Object

string

輸入檔案的 OSS Object。

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

Location

string

輸入檔案的 OSS Location。

mps-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

樣本

正常返回樣本

JSON格式

{
  "NonExistRunIds": {
    "RunId": [
      "null"
    ]
  },
  "MediaWorkflowExecutionList": {
    "MediaWorkflowExecution": [
      {
        "CreationTime": "016-04-01T06:53:43Z",
        "MediaWorkflowId": "93ab850b4f6f44eab54b6e91****81d4",
        "State": "Completed",
        "ActivityList": {
          "Activity": [
            {
              "EndTime": "2016-04-01T06:53:44Z",
              "Type": "Start",
              "StartTime": "2016-04-01T06:53:44Z",
              "State": "Running",
              "JobId": "2376030d9d0849399cd20e20f4f3****",
              "Code": "InvalidParameter.ResourceContentBad",
              "Message": "The resource operated InputFile is bad",
              "Name": "Start",
              "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": "mps-cn-shanghai",
            "Bucket": "example-bucket-****"
          }
        },
        "MediaId": "512046582a924698a41e0f8b0d2b****",
        "RunId": "48e33690ac19445488c706924321****"
      }
    ]
  },
  "RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情