メディアワークフロー実行インスタンスを照会します。
説明
この操作では、一度に最大10個のメディアワークフロー実行インスタンスをクエリできます。
この操作を呼び出す前に、ワークフローパイプラインが有効になっていることを確認してください。 そうしないと、ワークフローが期待どおりに実行されません。 たとえば、ワークフローノードが無効で、ワークフローで作成されたジョブを実行できないという例外が発生する場合があります。
QPS制限
この操作は1秒間に最大100回呼び出すことができます。 この制限を超えるリクエストは削除され、サービスが中断されます。 この操作を呼び出すときは、この制限に注意することをお勧めします。 詳細については、「QPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
操作 | 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 | 完了 | メディアワークフローのステータス。 設定可能な値は以下のとおりです。
説明 完了は、メディアワークフローが完了したことを示します。 ワークフロー内の各メソッド (トランスコードメソッドやスナップショットメソッドなど) のステータスを表示して、メソッドが呼び出されているかどうかを確認します。
|
ActivityList | アクティビティの配列 | メディアワークフローで呼び出されるメソッド。 | |
アクティビティ | |||
EndTime | String | 2016-04-01T06:53:44Z | メソッドが終了する時刻。 |
データ型 | String | 開始 | メディアワークフローでサポートされているメソッド。 有効な値: Start、Snapshot、Transcode、Analysis、およびReport。 詳細については、「メディアワークフローでサポートされているメソッド」をご参照ください。 |
StartTime | String | 2016-04-01T06:53:44Z | メソッドが呼び出される時刻。 |
ステータス | String | 実行中 | メソッドのステータス。 設定可能な値は以下のとおりです。
説明 たとえば、分析が完了すると、トランスコードメソッドが呼び出され、高解像度および標準解像度のトランスコードジョブが作成されます。 システムは、分析結果に基づいてジョブを実行するかどうかを決定する。 入力ビデオの解像度が低い場合、高解像度トランスコードジョブはスキップされ得る。 |
JobId | String | 2376030d9d0849399cd20e20f4f3 **** | メソッドが呼び出されたときに生成されるジョブのID。 たとえば、分析、トランスコード、およびスナップショットメソッドのジョブIDです。 |
Code | String | InvalidParameter.ResourceContentBad | メソッドの呼び出しに失敗した場合に返されるエラーコード。
|
Message | String | リソースによって操作されるInputFileが悪い | メソッドの呼び出しに失敗した場合に返されるエラーメッセージ。
|
パラメーター名 | 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 エラーセンター」をご参照ください。