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

ApsaraVideo Media Processing:QueryMediaWorkflowList

最終更新日:Feb 25, 2026

登録済みのメディアワークフローをクエリします。

操作説明

この操作を使用すると、1 回の呼び出しで最大 10 個のメディアワークフローをクエリできます。

QPS 制限

アカウントあたり、この操作は 1 秒間に最大 100 回まで呼び出せます。この制限を超えるリクエストは破棄され、サービス中断が発生する場合があります。この制限を意識して操作を実行することを推奨します。詳細については、「QPS 制限」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

mts:QueryMediaWorkflowList

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

MediaWorkflowIds

string

必須

クエリ対象のメディアワークフローの ID。メディアワークフローの ID を取得するには、ApsaraVideo Media Processing (MPS) コンソールにログインし、左側ナビゲーションウィンドウから **[ワークフロー]** > **[ワークフロー設定]** を選択します。1 回の呼び出しで最大 10 個のメディアワークフローをクエリできます。複数のメディアワークフロー ID はカンマ (,) で区切ります。

93ab850b4f6f44eab54b6e9181d4****,72dfa5e679ab4be9a3ed9974c736****

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

NonExistMediaWorkflowIds

object

MediaWorkflowId

array

存在しないワークフロー。

string

存在しないメディアワークフローの ID。指定されたすべてのメディアワークフローが見つかった場合は、このパラメーターは返されません。

72dfa5e679ab4be9a3ed9974c736****

MediaWorkflowList

object

MediaWorkflow

array<object>

メディアワークフロー。

object

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

CreationTime

string

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

2016-04-01T05:29:38Z

MediaWorkflowId

string

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

93ab850b4f6f44eab54b6e9181d4****

State

string

メディアワークフローの状態。有効な値は以下のとおりです。

  • 非アクティブ (Inactive): メディアワークフローが無効化されています。

  • アクティブ (Active): メディアワークフローが有効化されています。

  • 削除済み (Deleted): メディアワークフローが削除されています。

Active

TriggerMode

string

メディアワークフローのトリガーモード。有効な値は以下のとおりです。

  • OssAutoTrigger: メディアワークフローが自動的にトリガーされます。

  • NotInAuto: メディアワークフローが自動的にトリガーされません。

OssAutoTrigger

Name

string

メディアワークフローの名前。

example-mediaworkflow-****

Topology

string

メディアワークフローのトポロジー。

{mediaworkflow","State":"Active","Topology":"{\"Activities\":{\"Act-Start\":{\"Parameters\":{\"PipelineId\":\"130266f58161436a80bf07cb12c8****\",\"InputFile\":\"{\\\"Bucket\\\": \\\"example-bucket-****\\\",\\\"Location\\\": \\\"cn-shanghai\\\"}\"},\"Type\":\"Start\"},\"Act-Report\":{\"Parameters\":{},\"Type\":\"Report\"},\"Act-Transcode-M3U8\":{\"Parameters\":{\"Outputs\":\"[{\\\"Object\\\":\\\"transcode/{ObjectPrefix}{FileName}\\\",\\\"TemplateId\\\": \\\"957d1719ee85ed6527b90cf62726****\\\"}]\",\"OutputBucket\":\"example-bucket-****\",\"OutputLocation\":\"cn-shanghai\"},\"Type\":\"Transcode\"}},\"Dependencies\":{\"Act-Start\":[\"Act-Transcode-M3U8\"],\"Act-Report\":[],\"Act-Transcode-M3U8\":[\"Act-Report\"]}}","MediaWorkflowId":"93ab850b4f6f44eab54b6e91d24d****"}]},"RequestId":"16CD0CDD-457E-420D-9755-8385075A1234"}

RequestId

string

リクエストの ID。

16CD0CDD-457E-420D-1234-8385075A618B

成功レスポンス

JSONJSON

{
  "NonExistMediaWorkflowIds": {
    "MediaWorkflowId": [
      "72dfa5e679ab4be9a3ed9974c736****"
    ]
  },
  "MediaWorkflowList": {
    "MediaWorkflow": [
      {
        "CreationTime": "2016-04-01T05:29:38Z",
        "MediaWorkflowId": "93ab850b4f6f44eab54b6e9181d4****",
        "State": "Active",
        "TriggerMode": "OssAutoTrigger",
        "Name": "example-mediaworkflow-****",
        "Topology": "{mediaworkflow\",\"State\":\"Active\",\"Topology\":\"{\\\"Activities\\\":{\\\"Act-Start\\\":{\\\"Parameters\\\":{\\\"PipelineId\\\":\\\"130266f58161436a80bf07cb12c8****\\\",\\\"InputFile\\\":\\\"{\\\\\\\"Bucket\\\\\\\": \\\\\\\"example-bucket-****\\\\\\\",\\\\\\\"Location\\\\\\\": \\\\\\\"cn-shanghai\\\\\\\"}\\\"},\\\"Type\\\":\\\"Start\\\"},\\\"Act-Report\\\":{\\\"Parameters\\\":{},\\\"Type\\\":\\\"Report\\\"},\\\"Act-Transcode-M3U8\\\":{\\\"Parameters\\\":{\\\"Outputs\\\":\\\"[{\\\\\\\"Object\\\\\\\":\\\\\\\"transcode/{ObjectPrefix}{FileName}\\\\\\\",\\\\\\\"TemplateId\\\\\\\": \\\\\\\"957d1719ee85ed6527b90cf62726****\\\\\\\"}]\\\",\\\"OutputBucket\\\":\\\"example-bucket-****\\\",\\\"OutputLocation\\\":\\\"cn-shanghai\\\"},\\\"Type\\\":\\\"Transcode\\\"}},\\\"Dependencies\\\":{\\\"Act-Start\\\":[\\\"Act-Transcode-M3U8\\\"],\\\"Act-Report\\\":[],\\\"Act-Transcode-M3U8\\\":[\\\"Act-Report\\\"]}}\",\"MediaWorkflowId\":\"93ab850b4f6f44eab54b6e91d24d****\"}]},\"RequestId\":\"16CD0CDD-457E-420D-9755-8385075A1234\"}"
      }
    ]
  },
  "RequestId": "16CD0CDD-457E-420D-1234-8385075A618B"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。