メディアワークフローの実行インスタンスを照会します。
操作説明
この操作を呼び出すことで、一度に最大 10 個のメディアワークフロー実行インスタンスを照会できます。
この操作を呼び出す前に、ワークフローパイプラインが有効になっていることを確認してください。そうでない場合、ワークフローが期待どおりに実行されない可能性があります。例えば、ワークフローノードが無効である、ワークフローで作成されたジョブが実行できないなどの例外が発生する可能性があります。
QPS 制限
1 アカウントあたり、毎秒最大 100 回この操作を呼び出すことができます。この制限を超えたリクエストは破棄され、サービスが中断されます。この操作を呼び出す際は、この制限に注意することを推奨します。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:QueryMediaWorkflowExecutionList |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RunIds |
string |
必須 |
メディアワークフロー実行インスタンスの ID。インスタンス ID を取得するには、ApsaraVideo Media Processing (MPS) コンソールにログインし、左側のナビゲーションウィンドウで [ワークフロー] > [実行インスタンス] を選択します。複数の ID はコンマ (,) で区切ります。一度に最大 10 個のメディアワークフロー実行インスタンスを照会できます。 |
48e33690ac19445488c706924321**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| NonExistRunIds |
object |
||
| RunId |
array |
存在しない実行インスタンスの ID。 |
|
|
string |
存在しない実行インスタンスの ID。指定されたすべての実行インスタンスが存在する場合、null が返されます。 |
null |
|
| MediaWorkflowExecutionList |
object |
||
| MediaWorkflowExecution |
array<object> |
メディアワークフローの詳細。 |
|
|
array<object> |
メディアワークフローに関する情報。 |
||
| CreationTime |
string |
メディアワークフローが作成された時刻。 |
016-04-01T06:53:43Z |
| MediaWorkflowId |
string |
メディアワークフローの ID。 |
93ab850b4f6f44eab54b6e91****81d4 |
| State |
string |
メディアワークフローのステータス。有効な値：
説明
Completed はメディアワークフローが完了したことのみを示します。メソッドが呼び出されたかどうかを確認するには、トランスコードやスナップショットなどのワークフロー内の各メソッドのステータスを確認してください。
|
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 |
| JobId |
string |
メソッドが呼び出されたときに生成されるジョブの ID (分析、トランスコード、スナップショットメソッドのジョブ ID など)。 |
2376030d9d0849399cd20e20f4f3**** |
| Code |
string |
エラーコード。
|
InvalidParameter.ResourceContentBad |
| Message |
string |
エラーメッセージ。
|
The resource operated InputFile is bad |
| Name |
string |
メソッドの名前。 説明
メディアワークフロー内の各メソッドの名前は一意です。 |
Start |
| MNSMessageResult |
object |
ジョブの結果をユーザーに通知するために Message Service (MNS) によって送信されたメッセージ。 |
|
| MessageId |
string |
MNS メッセージが送信されたことを示すメッセージの ID。MNS メッセージの送信に失敗した場合、このパラメーターは返されません。 |
4f3bc83233de4e2f81c7dade443e**** |
| ErrorMessage |
string |
MNS メッセージの送信に失敗した場合に返されるエラーメッセージ。MNS メッセージが送信された場合、このパラメーターは返されません。 |
MessageConfigEmpty |
| ErrorCode |
string |
MNS メッセージの送信に失敗した場合に返されるエラーコード。MNS メッセージが送信された場合、このパラメーターは返されません。 |
The Topic/Queue config is empty, not send message |
| Name |
string |
メディアワークフローの名前。 |
example-mediaworkflow-**** |
| Input |
object |
メディアワークフローの入力データ。 |
|
| UserData |
string |
ユーザー定義データ。 |
example data **** |
| InputFile |
object |
メディアワークフローの入力ファイル。 |
|
| Object |
string |
入力ファイルとして使用される OSS オブジェクトの名前。 |
example-mediaWorkflow-****/example-object-****/example.mp4 |
| Location |
string |
入力ファイルが存在する OSS リージョンの ID。 |
mps-cn-shanghai |
| Bucket |
string |
入力ファイルが格納されている OSS バケットの名前。 |
example-bucket-**** |
| MediaId |
string |
メディアアセットの ID。メディアファイルには、メディアワークフローに関するすべての情報が含まれています。 |
512046582a924698a41e0f8b0d2b**** |
| RunId |
string |
実行インスタンスの ID。 |
48e33690ac19445488c706924321**** |
| RequestId |
string |
リクエストの ID。 |
D1D5C080-8E2F-5030-8AB4-13092F17631B |
例
成功レスポンス
JSONJSON
{
"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"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。