更新媒体工作流。
接口说明
本接口用于更新媒体工作流的拓扑结构。如需更新媒体工作流触发模式，请参见更新媒体工作流触发模式。
删除或停用工作流后，工作流将无法使用。此时，如果上传文件至工作流指定的 Bucket 路径中，也不会自动触发工作流执行。
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
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 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回参数。 |
||
| RequestId |
string |
请求 ID。 |
7D752035-97DA-54E5-88E2-E8405EEA**** |
| MediaWorkflow |
object |
媒体工作流详细信息。 |
|
| CreationTime |
string |
创建时间。 |
2016-04-01T05:29:38Z |
| MediaWorkflowId |
string |
更新的媒体工作流 ID。 |
6307eb0d3f85477882d205aa040f**** |
| State |
string |
媒体工作流状态。可取值：
|
Active |
| TriggerMode |
string |
触发模式。可取值：
|
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}"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。