CreateLivePackageOriginEndpoint - 创建实时打包源站端点-智能媒体服务(IMS)-阿里云帮助中心

用于添加实时流媒体频道的源站端点配置，支持HLS、HLS_CMAF和DASH协议及DRM加密。

接口说明

请求说明

该接口允许用户创建一个实时打包服务的源站端点，主要用于配置频道的回源、安全策略（如 IP 黑白名单及授权码）及时移功能。目前仅支持 HLS 协议播放。创建源站端点前，需先创建好实时打包频道组和频道。创建成功后，将返回端点播放地址及其他配置详情。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ice:CreateLivePackageOriginEndpoint

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
GroupName	string	是	频道组名称	channel-group-1
ChannelName	string	是	频道名称	channel-1
EndpointName	string	是	源站端点名称，字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式：[A-Za-z0-9_-]+	endpoint-1
Protocol	string	是	分发协议	HLS
ManifestName	string	否	清单名称，默认 manifest	manifest
Description	string	否	端点描述	This is an origin endpoint.
TimeshiftVision	integer	否	时移天数，最大 30 天，默认为 0 表示不支持时移	1
AuthorizationCode	string	否	授权码，与 IpWhitelist 至少设置一个，最长 200 字符。格式：[A-Za-z0-9-_.]+	AbcDef123
IpWhitelist	string	否	IP 白名单，支持掩码，不允许配置 0.0.0.0/0，多个使用逗号分隔，与 AuthorizationCode 至少设置一个，最大 1000 字符	192.168.1.0/24,10.0.0.1/24
IpBlacklist	string	否	IP 黑名单，支持掩码，不允许配置 0.0.0.0/0，多个使用逗号分隔，最大 1000 字符	103.21.222.1/32,192.168.100.0/24
ClientToken	string	否	幂等参数	**0311a423d11a5f7dee713535**
LivePackagingConfig	LivePackagingConfig	否	直播封装配置

返回参数

名称	类型	描述	示例值
	object	Schema of Response
LivePackageOriginEndpoint	object	LivePackageOriginEndpoint 类型
AuthorizationCode	string	授权码	Abcded123
ChannelName	string	频道名称	channel-1
CreateTime	string	创建时间	2023-04-01T12:00:00Z
Description	string	端点描述	This is an origin endpoint.
EndpointName	string	端点名称	endpoint-1
EndpointUrl	string	端点播放地址	https://xxx.packagepull-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest
GroupName	string	频道组名称	channel-group-1
IpBlacklist	string	IP 黑名单	103.21.222.1/32,192.168.100.0/24
IpWhitelist	string	IP 白名单	192.168.1.0/24,10.0.0.1/24
LastModified	string	最后修改时间	2023-04-01T12:00:00Z
ManifestName	string	清单名称	manifest
Protocol	string	协议，暂只支持 HLS	HLS
TimeshiftVision	integer	时移天数，最大 30 天	1
LivePackagingConfig	LivePackagingConfig	直播封装配置
RequestId	string	请求 ID	****11-DB8D-4A9A-875B-275798****

示例

正常返回示例

JSON格式

{
  "LivePackageOriginEndpoint": {
    "AuthorizationCode": "Abcded123",
    "ChannelName": "channel-1",
    "CreateTime": "2023-04-01T12:00:00Z",
    "Description": "This is an origin endpoint.",
    "EndpointName": "endpoint-1",
    "EndpointUrl": "https://xxx.packagepull-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest",
    "GroupName": "channel-group-1",
    "IpBlacklist": "103.21.222.1/32,192.168.100.0/24",
    "IpWhitelist": "192.168.1.0/24,10.0.0.1/24",
    "LastModified": "2023-04-01T12:00:00Z",
    "ManifestName": "manifest",
    "Protocol": "HLS",
    "TimeshiftVision": 1,
    "LivePackagingConfig": {
      "DrmConfig": {
        "SystemIds": [
          "9a04f079-9840-4286-ab92-e65be0885f95"
        ],
        "EncryptionMethod": "SAMPLE_AES",
        "IV": "00000000000000000000000000000000",
        "Url": "https://exampledrm.com/path?arg1=xxx",
        "RotatePeriod": 0,
        "ContentId": "live-axb1-9dd2fa123"
      },
      "SegmentDuration": 6,
      "UseAudioRenditionGroups": true,
      "LiveManifestConfigs": [
        {
          "SegmentCount": 3,
          "DateTimeInterval": 5,
          "MinUpdatePeriod": 8,
          "AdMarkers": "NONE",
          "StreamOrder": "ORIGINAL",
          "MinVideoBitrate": 1000000,
          "MaxVideoBitrate": 8000000,
          "MinBufferTime": 8,
          "PresentationDelay": 12,
          "ManifestDuration": 60,
          "SegmentTemplateFormat": "NUMBER_TIMELINE",
          "PartHoldBackMs": 0
        }
      ],
      "PartDurationMs": 0
    }
  },
  "RequestId": "******11-DB8D-4A9A-875B-275798******"
}

错误码

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

变更历史

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