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

:UpdateMediaWorkflow

最終更新日:Feb 25, 2026

メディアワークフローを更新します。

操作説明

  • この API は、メディアワークフローのトポロジーを更新するために使用します。メディアワークフローのトリガーモードを更新する場合は、「メディアワークフローのトリガーモードの更新」をご参照ください。

  • ワークフローが削除または無効化された場合、そのワークフローは利用不可になります。この状態では、当該ワークフローに指定された OSS バケットパスへのファイルアップロードによって、ワークフローの実行が自動的にトリガーされません。

クエリ/秒 (QPS) 制限

この API の QPS 制限は、ユーザーあたり 100 クエリ/秒です。この制限を超えると、API 呼び出しに対してレート制限が適用され、ビジネスに影響を及ぼす可能性があります。適切な頻度でこの API を呼び出してください。詳細については、「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:UpdateMediaWorkflow

update

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

MediaWorkflowId

string

必須

更新対象のメディアワークフローの ID です。メディアワークフローの ID を取得するには、ApsaraVideo Media Processing (MPS) コンソール にログインし、左側のナビゲーションウィンドウから [ワークフロー][ワークフロー設定] を選択します。

6307eb0d3f85477882d205aa040f****

Topology

string

必須

新しいメディアワークフローのトポロジーです。値は、アクティビティ一覧およびアクティビティ間の依存関係を含む JSON オブジェクトです。

説明

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

{ "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" ] } }

Name

string

任意

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

  • 空欄にできません。

  • 同一アカウント内で重複しない名前にする必要があります。

  • 最大 64 文字までです。

  • UTF-8 エンコーディングを使用します。

mediaworkflow-example

TriggerMode

string

任意

トリガーモードです。有効な値は以下のとおりです。

  • OssAutoTrigger:自動トリガー。

  • NotInAuto:自動トリガーなし。

OssAutoTrigger

レスポンスフィールド

フィールド

説明

object

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

RequestId

string

リクエストの ID です。

7D752035-97DA-54E5-88E2-E8405EEA****

MediaWorkflow

object

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

CreationTime

string

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

2016-04-01T05:29:38Z

MediaWorkflowId

string

更新されたメディアワークフローの ID です。

6307eb0d3f85477882d205aa040f****

State

string

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

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

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

Active

TriggerMode

string

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

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

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

OssAutoTrigger

Name

string

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

examp-mediaworkflow-****

Topology

string

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

{ "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" ] } }

成功レスポンス

JSONJSON

{
  "RequestId": "7D752035-97DA-54E5-88E2-E8405EEA****",
  "MediaWorkflow": {
    "CreationTime": "2016-04-01T05:29:38Z",
    "MediaWorkflowId": "6307eb0d3f85477882d205aa040f****",
    "State": "Active",
    "TriggerMode": "OssAutoTrigger",
    "Name": "examp-mediaworkflow-****",
    "Topology": "{\n      \"Activities\": {\n            \"Act-Start\": {\n                  \"Parameters\": {\n                        \"PipelineId\": \"130266f58161436a80bf07cb12c8****\",\n                        \"InputFile\": \"{\\\"Bucket\\\": \\\"example-bucket-****\\\",\\\"Location\\\": \\\"cn-shanghai\\\"}\"\n                  },\n                  \"Type\": \"Start\"\n            },\n            \"Act-Report\": {\n                  \"Parameters\": {},\n                  \"Type\": \"Report\"\n            },\n            \"Act-Transcode-M3U8\": {\n                  \"Parameters\": {\n                        \"Outputs\": \"[{\\\"Object\\\":\\\"transcode/{ObjectPrefix}{FileName}\\\",\\\"TemplateId\\\": \\\"957d1719ee85ed6527b90cf62726****\\\"}]\",\n                        \"OutputBucket\": \"example-bucket-****\",\n                        \"OutputLocation\": \"cn-shanghai\"\n                  },\n                  \"Type\": \"Transcode\"\n            }\n      },\n      \"Dependencies\": {\n            \"Act-Start\": [\n                  \"Act-Transcode-M3U8\"\n            ],\n            \"Act-Report\": [],\n            \"Act-Transcode-M3U8\": [\n                  \"Act-Report\"\n            ]\n      }\n}"
  }
}

エラーコード

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

変更履歴

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