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

:UpdateMediaWorkflow

最終更新日:May 08, 2025

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

使用上の注意

  • この操作を呼び出して、メディアワークフローのトポロジーを更新できます。メディアワークフローのトリガーモードを更新するには、UpdateMediaWorkflowTriggerMode 操作を呼び出します。
  • メディアワークフローを削除または非アクティブ化した後、ワークフローは使用できません。この場合、ワークフローで指定されたバケットにファイルをアップロードしても、ワークフローは自動的にトリガーされません。

QPS 制限

この操作は、1 秒あたり最大 100 回呼び出すことができます。1 秒あたりの呼び出し数が制限を超えると、速度制限がトリガーされます。その結果、ビジネスに影響を与える可能性があります。この操作を呼び出す際は、制限に注意することをお勧めします。詳細については、「QPS 制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK 用の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター タイプ 必須 説明
Action String Yes UpdateMediaWorkflow

実行する操作。値を UpdateMediaWorkflow に設定します。

MediaWorkflowId String Yes 6307eb0d3f85477882d205aa040f****

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

Topology String Yes {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"}

メディアワークフローの新しいトポロジー。値は、アクティビティリストとアクティビティの依存関係を含む JSON オブジェクトです。

レスポンスパラメーター

パラメーター タイプ 説明
RequestId String 7D752035-97DA-54E5-88E2-E8405EEA****

リクエストの ID。

MediaWorkflow Object

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

CreationTime String 2016-04-01T05:29:38Z

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

MediaWorkflowId String 6307eb0d3f85477882d205aa040f****

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

State String Active

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

  • Inactive: メディアワークフローは非アクティブです。
  • Active: メディアワークフローはアクティブです。
TriggerMode String OssAutoTrigger

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

  • OssAutoTrigger: メディアワークフローは自動的にトリガーされます。
  • NotInAuto: メディアワークフローは自動的にトリガーされません。
Name String examp-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"}

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

リクエストの例

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMediaWorkflow
&MediaWorkflowId=6307eb0d3f85477882d205aa040f****
&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"}
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateMediaWorkflowResponse>
    <RequestId>7D752035-97DA-54E5-88E2-E8405EEA****</RequestId>
    <MediaWorkflow>
        <CreationTime>2016-04-01T05:29:38Z</CreationTime>
        <MediaWorkflowId>6307eb0d3f85477882d205aa040f****</MediaWorkflowId>
        <State>Active</State>
        <TriggerMode>OssAutoTrigger</TriggerMode>
        <Name>examp-mediaworkflow-****</Name>
        <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"}</Topology>
    </MediaWorkflow>
</UpdateMediaWorkflowResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7D752035-97DA-54E5-88E2-E8405EEA****",
  "MediaWorkflow" : {
    "CreationTime" : "2016-04-01T05:29:38Z",
    "MediaWorkflowId" : "6307eb0d3f85477882d205aa040f****",
    "State" : "Active",
    "TriggerMode" : "OssAutoTrigger",
    "Name" : "examp-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\"}"
  }
}

エラーコード

エラーコードのリストについては、「API エラーセンター」をご参照ください。