新增媒体工作流
描述
用于新增媒体工作流，定义媒体工作流的拓扑结构
请求参数
| 名称 | 类型 | 必填项 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作接口名，系统规定参数，取值：AddMediaWorkflow |
| Name | String | 是 | 媒体工作流名称，不能为空串，不可重复，不超过64个字符，utf-8编码 |
| Topology | String | 是 | 媒体工作流拓扑结构，Json对象，包括活动列表及活动依赖，见Topology示例。 |
Topology示例：
{
"Activities": {
"Act-Transcode-M3U8": {
"Parameters": {
"Outputs": "[{\"Object\":\"transcode/{ObjectPrefix}{FileName}\",\"TemplateId\": \"957d1719ee85ed6527b90cf62726cbef\"}]",
"OutputBucket": "panda-vod-hls",
"OutputLocation": "oss-cn-hangzhou"
},
"Type": "Transcode"
},
"Act-Start": {
"Name": "Act-Start",
"Parameters": {
"PipelineId": "130266f58161436a80bf07cb12c8009a",
"InputFile": "{\"Bucket\": \"panda-vod\",\"Location\": \"oss-cn-hangzhou\"}"
},
"Type": "Start"
},
"Act-Report": {
"Name": "Act-Report",
"Parameters": {},
"Type": "Report"
}
},
"Dependencies": {
"Act-Transcode-M3U8": [
"Act-Report"
],
"Act-Start": [
"Act-Transcode-M3U8"
],
"Act-Report": []
}
}
Start活动，设定媒体工作流的工作空间，以及全局配置，开始活动支持的参数
| 名称 | 类型 | 必填项 | 描述 |
|---|---|---|---|
| InputFile | String | 是 | 输入位置，示例：{“Bucket”: “example-001”,”Location”: “oss-cn-hangzhou”, “ObjectPrefix”: “test/“} |
| PipelineId | String | 是 | 管道ID,全局配置 |
| MessageType | String | 否 | 消息类别,默认Queue,范围：Queue,Topic |
| QueueName | String | 否 | 队列名称,全局配置 |
| TopicName | String | 否 | 主题名称,全局配置 |
| RoleName | String | 否 | 授权角色名称,默认值：AliyunMTSDefaultRole,全局配置 |
Transcode活动支持的参数
| 名称 | 类型 | 必填项 | 描述 |
|---|---|---|---|
| Outputs | String | 是 | 参考Output详情，示例：[{“Object”:”transcode/{ObjectPrefix}/{FileName}.{ExtName}”,”TemplateId”: “S00000001-000070”}]，其中参数Object是输出文件的动态规则，目前支持对原文件{ObjectPrefix},{FileName},{ExtName},{DestMd5},{DestAvgBitrate}以及媒体工作流信息{RunId},{MediaId},{TemplateId}的动态替换。 |
| OutputBucket | String | 是 | 输出Bucket |
| OutputLocation | String | 否 | 输出区域 |
Snapshot活动支持的参数
| 名称 | 类型 | 必填项 | 描述 |
|---|---|---|---|
| SnapshotConfig | String | 是 | 参考截图参数配置详情，示例：{“OutputFile”: {“Bucket”: “example-001”, “Location”: “oss-cn-hangzhou”, “Object”: “snapshot/{ObjectPrefix}/{FileName}.{ExtName}/1.jpg”},”Time”: “5”}，其中参数Object是输出文件的动态规则，目前支持对原文件{ObjectPrefix},{FileName},{ExtName}以及媒体工作流信息{RunId},{MediaId}的动态替换，还支持对截图时间点{SnapshotTime}的替换。 |
| MediaCover | String | 否 | 是否设置成媒体封面，只针对单张截图，默认是false,范围：true,false |
Analysis活动支持的参数
无
Report活动支持的参数
| 名称 | 类型 | 必填项 | 描述 |
|---|---|---|---|
| PublishType | String | 否 | 媒体发布类型，范围:Auto、Manual，Auto自动发布，Manual就是不发布，默认值：Manual |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| MediaWorkflow | MediaWorkflow | 媒体工作流 |
示例
请求示例
https://mts.aliyuncs.com/?Name=mediaworkflow-test&Action=AddMediaWorkflow&Topology=%7B%22Activities%22%3A%7B%22Act-Transcode-M3U8%22%3A%7B%22Parameters%22%3A%7B%22Outputs%22%3A%22%5B%7B%5C%22Object%5C%22%3A%5C%22transcode%2F%7BObjectPrefix%7D%7BFileName%7D%5C%22%2C%5C%22TemplateId%5C%22%3A%20%5C%22957d1719ee85ed6527b90cf62726cbef%5C%22%7D%5D%22%2C%22OutputBucket%22%3A%22panda-vod-hls%22%2C%22OutputLocation%22%3A%22oss-cn-hangzhou%22%7D%2C%22Type%22%3A%22Transcode%22%7D%2C%22Act-Start%22%3A%7B%22Name%22%3A%22Act-Start%22%2C%22Parameters%22%3A%7B%22PipelineId%22%3A%22130266f58161436a80bf07cb12c8009a%22%2C%22InputFile%22%3A%22%7B%5C%22Bucket%5C%22%3A%20%5C%22panda-vod%5C%22%2C%5C%22Location%5C%22%3A%20%5C%22oss-cn-hangzhou%5C%22%7D%22%7D%2C%22Type%22%3A%22Start%22%7D%2C%22Act-Report%22%3A%7B%22Name%22%3A%22Act-Report%22%2C%22Parameters%22%3A%7B%7D%2C%22Type%22%3A%22Report%22%7D%7D%2C%22Dependencies%22%3A%7B%22Act-Transcode-M3U8%22%3A%5B%22Act-Report%22%5D%2C%22Act-Start%22%3A%5B%22Act-Transcode-M3U8%22%5D%2C%22Act-Report%22%3A%5B%5D%7D%7D&<公共参数>
返回示例
XML:
<AddMediaWorkflowResponse>
<RequestId>F1D21261-ADB9-406A-BF6F-491382139D59</RequestId>
<MediaWorkflow>
<CreationTime>2016-04-01T05:29:37Z</CreationTime>
<Name>mediaworkflow-test</Name>
<State>Inactive</State>
<Topology>{"Activities":{"Act-Start":{"Parameters":{"PipelineId":"130266f58161436a80bf07cb12c8009a","InputFile":"{\"Bucket\": \"panda-vod\",\"Location\": \"oss-cn-hangzhou\"}"},"Type":"Start"},"Act-Report":{"Parameters":{},"Type":"Report"},"Act-Transcode-M3U8":{"Parameters":{"Outputs":"[{\"Object\":\"transcode/{ObjectPrefix}{FileName}\",\"TemplateId\": \"957d1719ee85ed6527b90cf62726cbef\"}]","OutputBucket":"panda-vod-hls","OutputLocation":"oss-cn-hangzhou"},"Type":"Transcode"}},"Dependencies":{"Act-Start":["Act-Transcode-M3U8"],"Act-Report":[],"Act-Transcode-M3U8":["Act-Report"]}}</Topology>
<MediaWorkflowId>e00732b977da427d9177a4dee646b1aa</MediaWorkflowId>
</MediaWorkflow>
</AddMediaWorkflowResponse>
Json:
{
"RequestId": "F1D21261-ADB9-406A-BF6F-491382139D59",
"MediaWorkflow": {
"CreationTime": "2016-04-01T05:29:37Z",
"Name": "mediaworkflow-test",
"State": "Inactive",
"Topology": "{\"Activities\":{\"Act-Start\":{\"Parameters\":{\"PipelineId\":\"130266f58161436a80bf07cb12c8009a\",\"InputFile\":\"{\\\"Bucket\\\": \\\"panda-vod\\\",\\\"Location\\\": \\\"oss-cn-hangzhou\\\"}\"},\"Type\":\"Start\"},\"Act-Report\":{\"Parameters\":{},\"Type\":\"Report\"},\"Act-Transcode-M3U8\":{\"Parameters\":{\"Outputs\":\"[{\\\"Object\\\":\\\"transcode/{ObjectPrefix}{FileName}\\\",\\\"TemplateId\\\": \\\"957d1719ee85ed6527b90cf62726cbef\\\"}]\",\"OutputBucket\":\"panda-vod-hls\",\"OutputLocation\":\"oss-cn-hangzhou\"},\"Type\":\"Transcode\"}},\"Dependencies\":{\"Act-Start\":[\"Act-Transcode-M3U8\"],\"Act-Report\":[],\"Act-Transcode-M3U8\":[\"Act-Report\"]}}",
"MediaWorkflowId": "93ab850b4f6f44eab54b6e91d24d81d4"
}
}