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

:AddMediaWorkflow

最終更新日:Feb 25, 2026

メディアワークフローを作成します。

操作説明

  • この操作を呼び出して、メディアワークフローのトポロジー、アクティビティ、および依存関係を定義できます。トポロジーはコンソール上で有向非循環グラフ(DAG)で表現されます。詳細については、「ワークフローのアクティビティ」をご参照ください。この操作を呼び出して作成したワークフローは、ApsaraVideo Media Processing (MPS) コンソールで確認および実行できます。

  • MPS のメディアワークフローは、ファイルパスのプレフィックスのみを使用して自動的にトリガーできます。ファイルパスのサフィックスによる自動トリガーはサポートされていません。トリガーに関するルールの詳細については、「ファイルのワークフロー自動トリガールール」をご参照ください。

1 秒あたりの API 呼び出し回数(QPS)制限

アカウント単位で、この API 操作を 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:AddMediaWorkflow

create

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Name

string

必須

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

  • 空値を指定できません。

  • 現在の Alibaba Cloud アカウント内で既に存在するメディアワークフローと同名を指定できません。

  • 最大 64 文字まで指定できます。

  • UTF-8 エンコーディング形式で指定する必要があります。

mediaworkflow-example

Topology

string

必須

メディアワークフローのトポロジーです。アクティビティおよびアクティビティ間の依存関係を含む JSON オブジェクトを指定する必要があります。詳細については、本トピックの「トポロジーのサンプル」セクションをご参照ください。

説明

Object Storage Service (OSS) バケットは、ご利用の MPS サービスと同じリージョンに配置されている必要があります。

{"Activities": {"mediaworkflow-example": {"Parameters": {"Outputs": "[{\"OutputObject\":\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\",\"TemplateId\":\"S00000001-200010\",\"TemplateName\":\"MP4-流畅\"}]","OutputBucket": "examplebucket","OutputLocation": "oss-cn-shanghai"},"Type": "Transcode"},"Act-Start": {"Parameters": {"PipelineId": "a7d481f07d8c45da88c71853ce7d****","InputFile": "{\"Bucket\":\"example-input\",\"Location\":\"oss-cn-shanghai\",\"ObjectPrefix\":\"mps-test/input/\"}"},"Type": "Start"},"Act-Report": {"Parameters": {"PublishType": "Manual"},"Type": "Report"}},"Dependencies": {"mediaworkflow-example": ["Act-Report"],"Act-Start": ["mediaworkflow-example"],"Act-Report": []}}

TriggerMode

string

任意

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

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

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

OssAutoTrigger

トポロジーのサンプル

説明

Object Storage Service (OSS) バケットは、ご利用の MPS サービスと同じリージョンに配置されている必要があります。

{
  "Activities": {
    "mediaworkflow-example": {
      "Parameters": {
        "Outputs": "[{\"OutputObject\":\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\",\"TemplateId\":\"S00000001-200010\",\"TemplateName\":\"MP4-Low definition\"}]",
        "OutputBucket": "examplebucket",
        "OutputLocation": "oss-cn-shanghai"
      },
      "Type": "Transcode"
    },
    "Act-Start": {
      "Parameters": {
        "PipelineId": "a7d481f07d8c45da88c71853ce7d****",
        "InputFile": "{\"Bucket\":\"example-input\",\"Location\":\"oss-cn-shanghai\",\"ObjectPrefix\":\"mps-test/input/\"}"
      },
      "Type": "Start"
    },
    "Act-Report": {
      "Parameters": {
        "PublishType": "Manual"
      },
      "Type": "Report"
    }
  },
  "Dependencies": {
    "mediaworkflow-example": ["Act-Report"],
    "Act-Start": ["mediaworkflow-example"],
    "Act-Report": []
  }
}

レスポンスフィールド

フィールド

説明

object

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

RequestId

string

リクエスト ID です。

F1D21261-ADB9-406A-1234-491382139D59

MediaWorkflow

object

メディアワークフローの情報です。

CreationTime

string

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

016-04-01T05:29:37Z

MediaWorkflowId

string

メディアワークフローの ID です。今後のワークフロー操作で使用するため、この ID を記録しておくことを推奨します。

e00732b977da427d9177a4deb1aa****

State

string

メディアワークフローの状態です。デフォルトでは、作成されたワークフローは Active 状態になります。

Active

TriggerMode

string

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

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

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

OssAutoTrigger

Name

string

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

mediaworkflow-example

Topology

string

メディアワークフローのトポロジーです。アクティビティおよびアクティビティ間の依存関係を含む JSON オブジェクトが返されます。

{"Activities": {"mediaworkflow-example": {"Parameters": {"Outputs": "[{\"OutputObject\":\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\",\"TemplateId\":\"S00000001-200010\",\"TemplateName\":\"MP4-流畅\"}]","OutputBucket": "examplebucket","OutputLocation": "oss-cn-shanghai"},"Type": "Transcode"},"Act-Start": {"Parameters": {"PipelineId": "a7d481f07d8c45da88c71853ce7d****","InputFile": "{\"Bucket\":\"example-input\",\"Location\":\"oss-cn-shanghai\",\"ObjectPrefix\":\"mps-test/input/\"}"},"Type": "Start"},"Act-Report": {"Parameters": {"PublishType": "Manual"},"Type": "Report"}},"Dependencies": {"mediaworkflow-example": ["Act-Report"],"Act-Start": ["mediaworkflow-example"],"Act-Report": []}}

成功レスポンス

JSONJSON

{
  "RequestId": "F1D21261-ADB9-406A-1234-491382139D59",
  "MediaWorkflow": {
    "CreationTime": "016-04-01T05:29:37Z",
    "MediaWorkflowId": "e00732b977da427d9177a4deb1aa****",
    "State": "Active",
    "TriggerMode": "OssAutoTrigger",
    "Name": "mediaworkflow-example",
    "Topology": "{\"Activities\": {\"mediaworkflow-example\": {\"Parameters\": {\"Outputs\": \"[{\\\"OutputObject\\\":\\\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\\\",\\\"TemplateId\\\":\\\"S00000001-200010\\\",\\\"TemplateName\\\":\\\"MP4-流畅\\\"}]\",\"OutputBucket\": \"examplebucket\",\"OutputLocation\": \"oss-cn-shanghai\"},\"Type\": \"Transcode\"},\"Act-Start\": {\"Parameters\": {\"PipelineId\": \"a7d481f07d8c45da88c71853ce7d****\",\"InputFile\": \"{\\\"Bucket\\\":\\\"example-input\\\",\\\"Location\\\":\\\"oss-cn-shanghai\\\",\\\"ObjectPrefix\\\":\\\"mps-test/input/\\\"}\"},\"Type\": \"Start\"},\"Act-Report\": {\"Parameters\": {\"PublishType\": \"Manual\"},\"Type\": \"Report\"}},\"Dependencies\": {\"mediaworkflow-example\": [\"Act-Report\"],\"Act-Start\": [\"mediaworkflow-example\"],\"Act-Report\": []}}"
  }
}

エラーコード

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

変更履歴

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