CreateLivePackageChannel - 创建实时打包频道-智能媒体服务(IMS)-阿里云帮助中心

生成实时视频流处理频道，支持HLS协议，自动分配端点和密钥。

接口说明

请求说明

该接口用于创建一个实时视频打包服务频道，目前支持 HLS 协议。系统将自动生成输入端点地址及认证所需的用户名和密码。

注意事项

频道组名称与频道名称只能包含大小写字母、数字、下划线和短横线。
协议目前仅支持HLS。
切片时长需设置在 1 至 30 秒之间。
m3u8 切片个数需在 2 至 100 个之间。

成功响应将返回新创建频道的详细信息，包括通道名、创建时间、修改时间、输入端点详情等。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:CreateLivePackageChannel

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
GroupName	string	是	频道组名称，字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式：[A-Za-z0-9_-]+	channel-group-1
SegmentCount	integer	否	输入流 m3u8 切片个数，2～100	3
Description	string	否	描述，最大 1000 个字符	This is a test channel.
SegmentDuration	integer	否	输入流切片时长，1～30	6
ChannelName	string	是	频道名称，字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式：[A-Za-z0-9_-]+	channel-1
ClientToken	string	否	幂等参数	**12e8864746a0a398**
Protocol	string	是	输入协议，目前仅支持 HLS	HLS

返回参数

名称	类型	描述	示例值
	object	Schema of Response
LivePackageChannel	object	实时打包频道的具体信息
ChannelName	string	频道名称	example-channel
CreateTime	string	格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）	2023-04-01T12:00:00Z
Description	string	描述	This is a test channel.
GroupName	string	频道组名称	channel-group-1
IngestEndpoints	array<object>	输入端点
	object	输入端点 URL
Id	string	输入端点 ID	ingest1
Password	string	密码	2F9e******b569c8
Url	string	输入端点 URL	http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest
Username	string	用户名	us12******das
LastModified	string	格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）	2023-04-01T12:00:00Z
Protocol	string	输入协议，HLS	HLS
SegmentCount	integer	输入流 m3u8 切片个数	3
SegmentDuration	integer	输入流切片时长	5
RequestId	string	请求 ID	****3B-0E1A-586A-AC29-742247****

示例

正常返回示例

JSON格式

{
  "LivePackageChannel": {
    "ChannelName": "example-channel",
    "CreateTime": "2023-04-01T12:00:00Z",
    "Description": "This is a test channel.",
    "GroupName": "channel-group-1",
    "IngestEndpoints": [
      {
        "Id": "ingest1",
        "Password": "2F9e******b569c8",
        "Url": "http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest",
        "Username": "us12******das"
      }
    ],
    "LastModified": "2023-04-01T12:00:00Z",
    "Protocol": "HLS",
    "SegmentCount": 3,
    "SegmentDuration": 5
  },
  "RequestId": "******3B-0E1A-586A-AC29-742247******"
}

错误码

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

变更历史

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