AddPipeline - 添加管道 - 媒体处理

新增一个管道。

调试

您可以在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	long	否	管道级别，取值范围：[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	long	管道级别。	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	long	管道配额分配。	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
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2023-09-21	OpenAPI 返回结构发生变更	查看变更详情
2023-09-21	OpenAPI 入参发生变更	查看变更详情