全部产品
Search
文档中心

媒体处理:AddPipeline - 添加管道

更新时间:Aug 27, 2026

新增一个管道。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

mts:AddPipeline

create

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

Name

string

是

管道名称,最大长度 128 字节。

test-pipeline

Speed

string

否

管道类型。 取值:

  • Boost:倍速转码

  • Standard:普通管道

  • NarrowBandHDV2:窄带高清 2.0

  • AIVideoCover:智能截图

  • AIVideoTag:视频标签(支持区域上海、北京、杭州)

默认值:Standard。

Standard

SpeedLevel

integer

否

管道级别,取值范围:[1,3]。

1

NotifyConfig

string

否

MNS 通知配置。

{"Topic":"mts-topic-1"}

Role

string

否

角色。

AliyunMTSDefaultRole

返回参数

名称

类型

描述

示例值

object

返回参数。

RequestId

string

请求 ID。

CFEA608A-5A1C-4C83-A54B-6197BC250D23

Pipeline

object

管道。

Speed

string

管道类型。

Standard

State

string

管道状态。

  • Active:表示管道内的作业会被媒体转码服务调度转码执行。

  • Paused:表示管道暂停,作业不再会被媒体转码调度转码执行,管道内的所有作业状态维持在已提交状态,已经处于转码中的任务将继续转码,不受影响。

Active

SpeedLevel

integer

管道级别。

1

NotifyConfig

object

MNS 通知配置。

MqTopic

string

消息队列 topic。

example1

QueueName

string

队列名称。

mts-queue-1

MqTag

string

消息队列 mq 标签。

mts-test

Topic

string

主题名称。

mts-topic-1

Role

string

角色。

AliyunMTSDefaultRole

Name

string

管道名称。

视频DNA

Id

string

管道 ID。

ed450ea0bfbd41e29f80a401fb4d****

QuotaAllocate

integer

管道配额分配。

10

示例

正常返回示例

JSON格式

{
  "RequestId": "CFEA608A-5A1C-4C83-A54B-6197BC250D23",
  "Pipeline": {
    "Speed": "Standard",
    "State": "Active",
    "SpeedLevel": 1,
    "NotifyConfig": {
      "MqTopic": "example1",
      "QueueName": "mts-queue-1",
      "MqTag": "mts-test",
      "Topic": "mts-topic-1"
    },
    "Role": "AliyunMTSDefaultRole",
    "Name": "视频DNA",
    "Id": "ed450ea0bfbd41e29f80a401fb4d****",
    "QuotaAllocate": 10
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。