QueryMediaWorkflowExecutionList - 查询媒体工作流执行实例 - 媒体处理

查询媒体工作流执行实例。

接口说明

本接口一次最多查询 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"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。