すべてのプロダクト
Search
ドキュメントセンター

:QueryMediaWorkflowExecutionList

最終更新日:May 08, 2025

メディアワークフロー実行インスタンスを照会します。

説明

  • この操作では、一度に最大10個のメディアワークフロー実行インスタンスをクエリできます。

  • この操作を呼び出す前に、ワークフローパイプラインが有効になっていることを確認してください。 そうしないと、ワークフローが期待どおりに実行されません。 たとえば、ワークフローノードが無効で、ワークフローで作成されたジョブを実行できないという例外が発生する場合があります。

QPS制限

この操作は1秒間に最大100回呼び出すことができます。 この制限を超えるリクエストは削除され、サービスが中断されます。 この操作を呼び出すときは、この制限に注意することをお勧めします。 詳細については、「QPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター

データ型

必須/任意

説明

操作

String

必須

QueryMediaWorkflowExecutionList

実行する操作です。 値をQueryMediaWorkflowExecutionListに設定します。

RunIds

String

必須

48e33690ac19445488c706924321 ****

メディアワークフロー実行インスタンスのID。 インスタンスIDを取得するには、ApsaraVideo Media Processing (MPS) コンソールにログインし、左側のナビゲーションウィンドウでワークフロー > 実行インスタンスを選択します。 ID が複数ある場合は、カンマ (,) で区切ります。 一度に最大10個のメディアワークフロー実行インスタンスをクエリできます。

レスポンスパラメーター

パラメーター

データ型

説明

NonExistRunIds

文字列の配列

null

存在しない実行インスタンスのID。 指定されたすべての実行インスタンスが存在する場合はnullが返されます。

MediaWorkflowExecutionList

MediaWorkflowExecutionの配列

メディアワークフローの詳細。

MediaWorkflowExecution

CreationTime

String

016-04-01T06:53:43Z

メディアワークフローが作成された時刻。

MediaWorkflowId

String

93ab850b4f6f44eab54b6e91 **** 81d4

メディアワークフローのID。

ステータス

String

完了

メディアワークフローのステータス。 設定可能な値は以下のとおりです。

  • 実行中: メディアワークフローが実行中です。

  • Completed: The media workflow is complete.

説明

完了は、メディアワークフローが完了したことを示します。 ワークフロー内の各メソッド (トランスコードメソッドやスナップショットメソッドなど) のステータスを表示して、メソッドが呼び出されているかどうかを確認します。

  • Fail: メディアワークフローが失敗します。

ActivityList

アクティビティの配列

メディアワークフローで呼び出されるメソッド。

アクティビティ

EndTime

String

2016-04-01T06:53:44Z

メソッドが終了する時刻。

データ型

String

開始

メディアワークフローでサポートされているメソッド。 有効な値: Start、Snapshot、Transcode、Analysis、およびReport。 詳細については、「メディアワークフローでサポートされているメソッド」をご参照ください。

StartTime

String

2016-04-01T06:53:44Z

メソッドが呼び出される時刻。

ステータス

String

実行中

メソッドのステータス。 設定可能な値は以下のとおりです。

  • Running: メソッドが呼び出されています。

  • Success: メソッドが呼び出されます。

  • Fail: メソッドの呼び出しに失敗しました。

  • Skipped: メソッドはスキップされます。

説明

たとえば、分析が完了すると、トランスコードメソッドが呼び出され、高解像度および標準解像度のトランスコードジョブが作成されます。 システムは、分析結果に基づいてジョブを実行するかどうかを決定する。 入力ビデオの解像度が低い場合、高解像度トランスコードジョブはスキップされ得る。

JobId

String

2376030d9d0849399cd20e20f4f3 ****

メソッドが呼び出されたときに生成されるジョブのID。 たとえば、分析、トランスコード、およびスナップショットメソッドのジョブIDです。

Code

String

InvalidParameter.ResourceContentBad

メソッドの呼び出しに失敗した場合に返されるエラーコード。

  • このパラメーターは、Stateパラメーターに対してFailが返された場合にのみ返されます。

Message

String

リソースによって操作されるInputFileが悪い

メソッドの呼び出しに失敗した場合に返されるエラーメッセージ。

  • このパラメーターは、Stateパラメーターに対してFailが返された場合にのみ返されます。

パラメーター名

String

開始

メソッドの名前。The name of the method.

説明

メディアワークフロー内の各メソッドの名前は一意です。

MNSMessageResult

オブジェクト

ジョブ結果をユーザーに通知するためにmessage Service (MNS) によって送信されるメッセージ。

MessageId

String

4f3bc83233de4e2f81c7dade443e ****

MNSメッセージが送信されたことを示すメッセージのID。 MNSメッセージの送信に失敗した場合、このパラメーターは返されません。

ErrorMessage

String

MessageConfigEmpty

MNSメッセージの送信に失敗した場合に返されるエラーメッセージ。 MNSメッセージが送信された場合、このパラメーターは返されません。

ErrorCode

String

トピック /キュー設定が空で、メッセージを送信しない

MNSメッセージの送信に失敗した場合に返されるエラーコード。 MNSメッセージが送信された場合、このパラメーターは返されません。

パラメーター名

String

example-mediaworkflow-****

The name of the media workflow.

入力

オブジェクト

メディアワークフローの入力データ。

UserData

String

データ例 ****

カスタムデータ。

入力ファイル

オブジェクト

The input file of the media workflow.

オブジェクト

String

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

The name of the Object Storage Service (OSS) object that is used as the input file.

[場所] >

String

mps-cn-上海

入力ファイルが存在するリージョンのID。

バケット

String

例-バケット-****

入力ファイルが保存されているOSSバケットの名前。

MediaId

String

512046582a924698a41e0f8b0d2b ****

メディアファイルのID。 メディアファイルには、メディアワークフローに関するすべての情報が含まれます。

RunId

String

48e33690ac19445488c706924321 ****

実行インスタンスのID。

RequestId

String

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

リクエストの ID です。

リクエストの例

http(s):// mts.cn-hangzhou.aliyuncs.com/?Action=QueryMediaWorkflowExecutionList
&RunIds=48e33690ac19445488c706924321 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryMediaWorkflowExecutionListResponse>
    <NonExistRunIds>null</NonExistRunIds>
    <MediaWorkflowExecutionList>
        <CreationTime>016-04-01T06:53:43Z</CreationTime>
        <MediaWorkflowId>93ab850b4f6f44eab54b6e91 **** 81d4</MediaWorkflowId>
        <State> 完了 </State>
        <ActivityList>
            <EndTime>2016-04-01T06:53:44Z</EndTime>
            <タイプ> スタート </タイプ>
            <StartTime>2016-04-01T06:53:44Z</StartTime>
            <State> ランニング </State>
            <JobId>2376030d9d0849399cd20e20f4f3 ****</JobId>
            <Code>InvalidParameter.ResourceContentBad</Code>
            <メッセージ> リソース操作されたInputFileが不良です </Message>
            <名前> スタート </名前>
            <MNSMessageResult>
                <MessageId>4f3bc83233de4e2f81c7dade443e ****</MessageId>
                <ErrorMessage>MessageConfigEmpty</ErrorMessage>
                <ErrorCode> トピック /キュー設定が空で、メッセージを送信しない </ErrorCode>
            </MNSSMessageResult>
        </ActivityList>
        <Name>example-mediaworkflow-****</Name>
        <入力>
            <UserData> サンプルデータ ****</UserData>
            <InputFile>
                <Object>example-mediaWorkflow-****/example-object-****/example.mp4</Object>
                <ロケーション> mps-cn-shanghai</Location>
                <バケット> example-Bucket-****</bucket>
            </InputFile>
        </入力>
        <MediaId>512046582a924698a41e0f8b0d2b ****</MediaId>
        <RunId>48e33690ac19445488c706924321 ****</RunId>
    </MediaWorkflowExecutionList>
    <RequestId>D1D5C080-8E2F-5030-8AB4-13092F17631B</RequestId>
</QueryMediaWorkflowExecutionListResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NonExistRunIds" : [ "null"] 、
  "MediaWorkflowExecutionList" : [ {
    "CreationTime" : "016-04-01T06:53:43Z" 、
    "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91 **** 81d4" 、
    "状態" : "完成" 、
    "ActivityList" : [ {
      "EndTime" : "2016-04-01T06:53:44Z" 、
      "タイプ" : "スタート" 、
      "StartTime" : "2016-04-01T06:53:44Z" 、
      "状態" : "ランニング" 、
      "JobId" : "2376030d9d0849399cd20e20f4f3 ****" 、
      "コード" : "InvalidParameter.ResourceContentBad" 、
      "メッセージ" : "InputFileを操作するリソースが悪い" 、
      "名前" : "スタート" 、
      "MNSMessageResult" : {
        "MessageId" : "4f3bc83233de4e2f81c7dade443e ****" 、
        "ErrorMessage" : "MessageConfigEmpty" 、
        "ErrorCode" : "トピック /キュー設定が空で、メッセージを送信しない"
      }
    } ],
    "名前" : "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"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。