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

ApsaraVideo Media Processing:SearchMediaWorkflow

最終更新日:Feb 25, 2026

指定された状態のメディアワークフローをクエリします。

操作説明

この操作を呼び出して、指定された状態のメディアワークフローをクエリできます。状態を指定しない場合、デフォルトですべてのメディアワークフローがクエリされます。

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:SearchMediaWorkflow

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

PageSize

integer

任意

各ページで返すエントリの数。

  • 各ページで最大 100 個のエントリを返すことができます。

  • デフォルト値:10

10

PageNumber

integer

任意

返すページ番号。デフォルト値:1

1

StateList

string

任意

クエリするメディアワークフローのステータス。複数のステータスを指定できます。複数のステータスはコンマ (,) で区切ります。デフォルト値:Inactive,Active,Deleted。有効な値:

  • Inactive:非アクティブ化されたメディアワークフローがクエリされます。

  • Active:アクティブ化されたメディアワークフローがクエリされます。

  • Deleted:削除されたメディアワークフローがクエリされます。

Inactive,Active,Deleted

レスポンスフィールド

フィールド

説明

object

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

TotalCount

integer

返されたエントリの総数。

1

MediaWorkflowList

object

MediaWorkflow

array<object>

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

object

メディアワークフローに関する情報。

CreationTime

string

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

2016-04-01T05:38:41Z

MediaWorkflowId

string

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

88c6ca184c0e4578645b665e2a12****

State

string

メディアワークフローのステータス。有効な値:

  • Inactive:メディアワークフローは非アクティブ化されています。

  • Active:メディアワークフローはアクティブ化されています。

  • Deleted:メディアワークフローは削除されています。

Active

TriggerMode

string

メディアワークフローのトリガーモード。有効な値:

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

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

OssAutoTrigger

Name

string

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

example-mediaworkflow-****

Topology

string

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

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

PageSize

integer

各ページで返されるエントリの数。

10

RequestId

string

リクエストの ID。

16CD0CDD-457E-420D-9755-8385075A1234

PageNumber

integer

返されたページのページ番号。

1

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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