使用AddMediaWorkflow新增媒體工作流程-ApsaraVideo for Media Processing-阿里雲

介面說明

本介面可以定義媒體工作流程的拓撲結構（DAG）、活動以及依賴關係。活動詳情，請參見媒體工作流程活動介紹。使用本介面建立的工作流程可以在ApsaraVideo for Media Processing控制台查看並調用。
MPS 媒體工作流程僅支援通過首碼（檔案路徑）自動觸發工作流程，不支援通過尾碼名觸發工作流程執行。詳細觸發規則，請參見媒體工作流程的檔案觸發匹配規則。

QPS 限制

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

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:AddMediaWorkflow

create

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
Name	string	是	媒體工作流程名稱。不可為空串。同一帳號下的工作流程名稱不可重複。不超過 64 個字元。 UTF-8 編碼。	mediaworkflow-example
Topology	string	是	媒體工作流程拓撲結構。格式為 JSON 對象，包括活動列表及活動依賴。更多資訊請參見下文Topology 樣本。說明 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

Topology 樣本

說明

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

返回參數

名稱	類型	描述	樣本值
	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": []}}

樣本

正常返回樣本

JSON格式

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

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。