更新媒體工作流。
接口說明
- 本接口用于更新媒體工作流的拓撲結構。如需更新媒體工作流觸發模式，請參見更新媒體工作流觸發模式。
- 刪除或停用工作流后，工作流將無法使用。此時，如果上傳文件至工作流指定的 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 | 否 | 媒體工作流名稱。
| mediaworkflow-example |
| TriggerMode | string | 否 | 觸發模式。 取值：
| OssAutoTrigger |
返回參數
示例
正常返回示例
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}"
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史