全部產品
Search
文件中心

ApsaraVideo Media Processing:UpdateMediaWorkflow - 更新媒體工作流程的拓撲結構

更新時間:Feb 25, 2026

更新媒體工作流程。

介面說明

  • 本介面用於更新媒體工作流程的拓撲結構。如需更新媒體工作流程觸發模式,請參見更新媒體工作流程觸發模式

  • 刪除或停用工作流程後,工作流程將無法使用。此時,如果上傳檔案至工作流程指定的 Bucket 路徑中,也不會自動觸發工作流程執行。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理調用。更多資訊,請參見 QPS 限制

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:UpdateMediaWorkflow

update

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

MediaWorkflowId

string

需要更新的媒體工作流程 ID,可以通過 MPS 控制台 > 工作流程管理 > 工作流程設定擷取。

6307eb0d3f85477882d205aa040f****

Topology

string

更新的媒體工作流程拓撲結構。JSON 對象,包括活動列表及活動依賴。

說明

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

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情