メディアワークフローの実行インスタンスを照会します。
操作説明
この操作では、過去 90 日間の実行インスタンスのみが返されます。
QPS 制限
この操作は、アカウントごとに 1 秒あたり 100 回まで呼び出すことができます。 この制限を超えたリクエストはドロップされ、サービスが中断されます。 この操作を呼び出す際は、この制限に注意することを推奨します。 詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:ListMediaWorkflowExecutions |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| MediaWorkflowId |
string |
任意 |
実行インスタンスを照会するメディアワークフローの ID。ワークフロー ID を取得するには、ApsaraVideo Media Processing (MPS) コンソールにログインし、[ワークフロー] > [ワークフロー設定] を選択します。 |
43b7335a4b1d4fe883670036affb**** |
| MediaWorkflowName |
string |
任意 |
メディアワークフローの名前。ワークフロー名を取得するには、MPS コンソールにログインし、[ワークフロー] > [ワークフロー設定] を選択します。 |
example-mediaworkflow-**** |
| InputFileURL |
string |
任意 |
メディアワークフローの入力ファイルの Object Storage Service (OSS) URL。URL は RFC 3986 に準拠し、UTF-8 でエンコードされ、予約文字はパーセントエンコーディングされます。 詳細については、「URL エンコーディング」をご参照ください。 |
http://example-****.cn-hangzhou.aliyuncs.com/test****.flv |
| NextPageToken |
string |
任意 |
次のリクエストで新しい結果ページを取得するために使用されるページネーショントークン。値は 32 文字の UUID です。 クエリ結果の最初のページをリクエストする場合、NextPageToken パラメーターは空のままにします。 より多くのクエリ結果をリクエストする場合は、前のページのクエリ結果で返された NextPageToken パラメーターの値を指定します。 |
39f8e0bc005e4f309379701645f4**** |
| MaximumPageSize |
integer |
任意 |
返すメディアワークフロー実行インスタンスの最大数。有効な値： |
1 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| MediaWorkflowExecutionList |
object |
||
| MediaWorkflowExecution |
array<object> |
メディアワークフローの詳細。 |
|
|
array<object> |
メディアワークフローの詳細。 |
||
| CreationTime |
string |
メディアワークフローが作成された時刻。 |
2016-04-01T06:53:43Z |
| MediaWorkflowId |
string |
メディアワークフローの ID。 |
43b7335a4b1d4fe883670036affb**** |
| State |
string |
メディアワークフローのステータス。有効な値：
説明
Completed の値は、実行が完了したことを示します。トランスコードやスナップショットなどの各アクティビティが成功したかどうかについては、アクティビティのステータスを確認してください。
|
Success |
| ActivityList |
object |
||
| Activity |
array<object> |
メディアワークフローで実行されるアクティビティ。 |
|
|
array<object> |
メディアワークフローアクティビティの詳細。 |
||
| EndTime |
string |
アクティビティの終了時刻。 |
2016-04-01T06:54:00Z |
| Type |
string |
メディアワークフローアクティビティのタイプ。有効な値：Start、Snapshot、Transcode、Analysis、Report。詳細については、「メディアワークフローでサポートされているメソッド」をご参照ください。 |
Start |
| StartTime |
string |
アクティビティの開始時刻。 |
2016-04-01T06:53:45Z |
| State |
string |
アクティビティのステータス。有効な値：
説明
たとえば、分析アクティビティが完了した後に、高解像度および標準解像度のトランスコードアクティビティが実行されます。システムは、分析結果に基づいて実行するアクティビティを決定します。入力ビデオコンテンツの解像度が不十分な場合、高解像度のトランスコードアクティビティはスキップされることがあります。 |
Success |
| JobId |
string |
アクティビティの実行時に生成されるジョブの ID。後続の操作呼び出しのために、この ID を保持することを推奨します。 |
2376030d9d0849399cd20e20c876**** |
| Code |
string |
リクエストが失敗した場合に返されるエラーコード。
|
null |
| Message |
string |
リクエストが失敗した場合に返されるエラーメッセージ。
|
null |
| Name |
string |
メディアワークフローアクティビティの名前。 説明
メディアワークフロー内のアクティビティの名前は一意です。 |
Act-2 |
| MNSMessageResult |
object |
ジョブの結果をユーザーに通知するために Message Service (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 |
OSS 内のメディアワークフローの入力ファイルのストレージ場所に関する情報。 |
|
| Object |
string |
入力メディアファイルとして使用される OSS オブジェクトの名前。 |
example-mediaWorkflow-****/example-object-****/example.mp4 |
| Location |
string |
入力ファイルが存在する OSS リージョン。 |
cn-shanghai |
| Bucket |
string |
入力メディアファイルが保存されている OSS バケットの名前。 |
example-bucket-**** |
| MediaId |
string |
メディアファイルの ID。メディアファイルには、メディアワークフローに関するすべての情報が含まれます。 |
512046582a924698a41e0f8b0d2b**** |
| RunId |
string |
実行インスタンスの ID。 |
48e33690ac19445488c706924321**** |
| RequestId |
string |
リクエスト ID。 |
D1D5C080-8E2F-5030-8AB4-13092F17631B |
| NextPageToken |
string |
NextPageToken の戻り値はページネーショントークンであり、次のリクエストで新しい結果ページを取得するために使用できます。 |
39f8e0bc005e4f309379701645f4**** |
例
成功レスポンス
JSONJSON
{
"MediaWorkflowExecutionList": {
"MediaWorkflowExecution": [
{
"CreationTime": "2016-04-01T06:53:43Z",
"MediaWorkflowId": "43b7335a4b1d4fe883670036affb****",
"State": "Success",
"ActivityList": {
"Activity": [
{
"EndTime": "2016-04-01T06:54:00Z",
"Type": "Start",
"StartTime": "2016-04-01T06:53:45Z",
"State": "Success",
"JobId": "2376030d9d0849399cd20e20c876****",
"Code": "null",
"Message": "null",
"Name": "Act-2",
"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": "cn-shanghai",
"Bucket": "example-bucket-****"
}
},
"MediaId": "512046582a924698a41e0f8b0d2b****",
"RunId": "48e33690ac19445488c706924321****"
}
]
},
"RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B",
"NextPageToken": "39f8e0bc005e4f309379701645f4****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。