文档首页/ 视频直播 Live/ 媒体直播API参考/ OTT频道管理/ 修改频道打包信息

更新时间：2025-10-16 GMT+08:00

在线调试

CLI示例

查看PDF

修改频道打包信息

功能介绍

修改频道打包信息。

URI

PUT /v1/{project_id}/ott/channels/endpoints

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参考获取项目ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	用户Token，使用Token鉴权方式时为必填项。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
Authorization	否	String	使用AK/SK方式认证时必填，携带的鉴权信息。
X-Sdk-Date	否	String	请求的发生时间，使用AK/SK方式认证时为必填项。
X-Project-Id	否	String	使用AK/SK方式认证时为必填项，携带项目ID信息。

表3 请求Body参数
参数	是否必选	参数类型	描述
domain	是	String	频道推流域名
app_name	是	String	组名或应用名
id	是	String	频道ID。频道唯一标识，为必填项
endpoints	否	Array of EndpointItem objects	频道出流信息

表4 EndpointItem
参数	是否必选	参数类型	描述
hls_package	否	Array of HlsPackageItem objects	HLS打包信息
dash_package	否	Array of DashPackageItem objects	DASH打包信息
mss_package	否	Array of MssPackageItem objects	MSS打包信息

表5 HlsPackageItem
参数	是否必选	参数类型	描述
url	否	String	客户自定义的拉流地址，包括方法、域名、路径
stream_selection	否	Array of StreamSelectionItem objects	从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。
hls_version	否	String	HLS版本号
segment_duration_seconds	是	Integer	频道输出分片的时长，为必选项单位：秒。取值范围：1-10 说明：修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！
playlist_window_seconds	否	Integer	频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值）
encryption	否	Encryption object	加密信息
ads	否	Object	广告配置
ext_args	否	Object	其他额外参数
request_args	否	PackageRequestArgs object	播放相关配置
ad_marker	否	Array of strings	广告标识。 HLS取值：["ENHANCED_SCTE35"]。
enable_access	否	Boolean	当频道mode是ONLY_OS类型时，允许本输出可以直接从源站拉流，默认：false true：允许output访问 false：禁止output访问
allow_all_ip_access	否	Boolean	是否放通所有的IP访问，默认：false true：允许所有的IP地址访问，ip_whitelist配置不生效 false：不允许所有的IP地址访问，ip_whitelist生效，仅在ip_whitelist配置的ip地址才能访问
ip_whitelist	否	String	当频道类型mode是ONLY_OS类型时，允许直接从源站拉流的IP白名单
cdn_identifier_header	否	HttpHeader object	HttpHeader CDN认证头域
origin_domain_master	否	String	源站分发域名-主region 跟CreateOttChannelInfoReq.region一致满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$ 最大长度255
origin_domain_slave	否	String	源站分发域名-备region 约束： 1、国际站新加坡的备源站：香港香港的备源站：新加坡利雅得的备源站：新加坡约翰内斯堡的备源站：新加坡 2、中国站北京四的备源站：上海满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$ 最大长度255
manifest_name	否	String	output的索引文件名字默认：index 长度：0-128 字符集：大小写字母、数字、"-"、"."、"_"，不能有/路径
slave_url	否	String	客户自定义的拉流地址，包括方法、域名、路径

表6 DashPackageItem
参数	是否必选	参数类型	描述
url	否	String	客户自定义的拉流地址，包括方法、域名、路径
stream_selection	否	Array of StreamSelectionItem objects	从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。
segment_duration_seconds	是	Integer	频道输出分片的时长，为必选项单位：秒。取值范围：1-10 说明：修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！
playlist_window_seconds	否	Integer	频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值）
encryption	否	Encryption object	加密信息
ads	否	Object	广告配置
ext_args	否	Object	其他额外参数
request_args	否	PackageRequestArgs object	播放相关配置
ad_marker	否	String	广告标识。 DASH取值："xml+bin"。
suggested_presentation_delay	否	Integer	建议播放延迟单位：秒。取值范围：[1 - 120]
minimum_update_period	否	Integer	索引最短更新周期单位：秒。取值范围：[1 - 120]
min_buffer_time	否	Integer	最小缓冲时间单位：秒。取值范围：[1 - 120]
enable_access	否	Boolean	默认：false true：允许output访问 false：禁止output访问
allow_all_ip_access	否	Boolean	是否放通所有的IP访问，默认：false true：允许所有的IP地址访问，ip_whitelist配置不生效 false：不允许所有的IP地址访问，ip_whitelist生效，仅在ip_whitelist配置的ip地址才能访问
ip_whitelist	否	String	当allow_all_ip_access为false时生效允许访问的ip地址，规则是CIDR，可以配置多个用,隔开
cdn_identifier_header	否	HttpHeader object	HttpHeader CDN认证头域
origin_domain_master	否	String	源站分发域名-主region 跟CreateOttChannelInfoReq.region一致满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$ 最大长度255
origin_domain_slave	否	String	源站分发域名-备region 约束： 1、国际站新加坡的备源站：香港香港的备源站：新加坡利雅得的备源站：新加坡约翰内斯堡的备源站：新加坡 2、中国站北京四的备源站：上海满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$ 最大长度255
manifest_name	否	String	output的索引文件名字默认：index 长度：0-128 字符集：大小写字母、数字、"-"、"."、"_"，不能有/路径
slave_url	否	String	客户自定义的拉流地址，包括方法、域名、路径

表7 MssPackageItem
参数	是否必选	参数类型	描述
url	否	String	客户自定义的拉流地址，包括方法、域名、路径
stream_selection	否	Array of StreamSelectionItem objects	从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。
segment_duration_seconds	是	Integer	频道输出分片的时长，为必选项单位：秒。取值范围：1-10 说明：修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！
playlist_window_seconds	否	Integer	频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值）
encryption	否	Encryption object	加密信息
ext_args	否	Object	其他额外参数
delay_segment	否	Integer	延播时长，单位秒
request_args	否	PackageRequestArgs object	播放相关配置
enable_access	否	Boolean	默认：false true：允许output访问 false：禁止output访问
allow_all_ip_access	否	Boolean	是否放通所有的IP访问，默认：false true：允许所有的IP地址访问，ip_whitelist配置不生效 false：不允许所有的IP地址访问，ip_whitelist生效，仅在ip_whitelist配置的ip地址才能访问
ip_whitelist	否	String	当allow_all_ip_access为false时生效允许访问的ip地址，规则是CIDR，可以配置多个用,隔开
cdn_identifier_header	否	HttpHeader object	HttpHeader，CDN认证头域
origin_domain_master	否	String	源站分发域名-主region 跟CreateOttChannelInfoReq.region一致满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$ 最大长度255
origin_domain_slave	否	String	源站分发域名-备region 约束： 1、国际站新加坡的备源站：香港香港的备源站：新加坡利雅得的备源站：新加坡约翰内斯堡的备源站：新加坡 2、中国站北京四的备源站：上海满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$ 最大长度255
manifest_name	否	String	output的索引文件名字默认：index 长度：0-128 字符集：大小写字母、数字、"-"、"."、"_"，不能有/路径
slave_url	否	String	客户自定义的拉流地址，包括方法、域名、路径

表8 StreamSelectionItem
参数	是否必选	参数类型	描述
key	否	String	拉流URL中用于码率过滤的参数
max_bandwidth	否	Integer	最大码率，单位：bps 取值范围：0 - 104,857,600（100Mbps）
min_bandwidth	否	Integer	最小码率，单位：bps 取值范围：0 - 104,857,600（100Mbps）

表9 Encryption
参数	是否必选	参数类型	描述
key_rotation_interval_seconds	否	Integer	密钥缓存时间。如果密钥不变，默认缓存七天。请注意：目前为保留字段，不支持配置。
encryption_method	否	String	加密方式。请注意：目前为保留字段，不支持配置。
level	否	String	取值如下： content：一个频道对应一个密钥 profile：一个码率对应一个密钥默认值：content
resource_id	是	String	客户生成的DRM内容ID
system_ids	是	Array of strings	system_id枚举值。取值如下： HLS：FairPlay DASH：Widevine、PlayReady MSS：PlayReady
url	是	String	获取密钥的DRM地址
speke_version	是	String	drm speke 版本号当前只支持1.0
request_mode	是	String	请求模式。取值如下： direct_http：HTTP(S)直接访问DRM。 functiongraph_proxy：FunctionGraph代理访问DRM。
http_headers	否	Array of HttpHeader objects	需要添加在drm请求头中的鉴权信息。最多支持配置5个。仅direct_http请求模式支持配置http_headers。
urn	否	String	functiongraph_proxy请求模式需要提供functiongraph的urn。

**表10** HttpHeader
参数	是否必选	参数类型	描述
key	是	String	请求头中key字段名
value	是	String	请求头中key对应的value值

**表11** PackageRequestArgs
参数	是否必选	参数类型	描述
record	否	Array of RecordRequestArgs objects	录制播放相关配置
timeshift	否	Array of TimeshiftRequestArgs objects	时移播放相关配置
live	否	Array of LiveRequestArgs objects	直播播放相关配置

**表12** RecordRequestArgs
参数	是否必选	参数类型	描述
start_time	否	String	开始时间
end_time	否	String	结束时间
format	否	String	格式
unit	否	String	单位

**表13** TimeshiftRequestArgs
参数	是否必选	参数类型	描述
back_time	否	String	时移时长字段名
unit	否	String	单位

**表14** LiveRequestArgs
参数	是否必选	参数类型	描述
delay	否	String	时延字段
unit	否	String	单位

响应参数

状态码：200

**表15** 响应Body参数
参数	参数类型	描述
result_code	String	错误码
result_msg	String	错误描述
domain	String	推流域名
app_name	String	组名或应用名，为必填项
id	String	频道ID。频道唯一标识，为必填项
sources	Array of SourceRsp objects	推流URL列表。创建频道时，只有入流协议为RTMP_PUSH时，会返回推流URL列表

**表16** SourceRsp
参数	参数类型	描述
url	String	RTMP推流地址
bitrate	Integer	码率。单位：bps。取值范围：(0,104,857,600]（100Mbps）
width	Integer	分辨率对应宽的值。取值范围：0 - 4096（4K）
height	Integer	分辨率对应高的值。取值范围：0 - 2160（4K）
enable_snapshot	Boolean	描述是否使用该流做截图

状态码：400

**表17** 响应Body参数
参数	参数类型	描述
result_code	String	错误码
result_msg	String	错误描述
domain	String	推流域名
app_name	String	组名或应用名，为必填项
id	String	频道ID。频道唯一标识，为必填项

请求示例

PUT https://{endpoint}/v1/{project_id}/ott/channels/endpoints

{
  "domain" : "push.testott.hls.com",
  "app_name" : "ott",
  "id" : "test",
  "endpoints" : [ {
    "hls_package" : [ {
      "url" : "pull.testott.hls.com/ott/test/index.m3u8",
      "stream_selection" : [ {
        "key" : "sss",
        "max_bandwidth" : 1000,
        "min_bandwidth" : 100
      } ],
      "hls_version" : "1",
      "segment_duration_seconds" : 4,
      "playlist_window_seconds" : 3600
    } ],
    "dash_package" : [ {
      "url" : "pull.testott.hls.com/ott/test/index.mpd",
      "stream_selection" : [ {
        "key" : "bitrate=900000-1800000",
        "max_bandwidth" : 1800000,
        "min_bandwidth" : 900000
      } ],
      "segment_duration_seconds" : 4,
      "playlist_window_seconds" : 3600
    } ],
    "mss_package" : [ {
      "url" : "pull.testott.hls.com/ott/channel/manifest",
      "stream_selection" : [ {
        "key" : "bitrate=900000-1800000",
        "max_bandwidth" : 1800000,
        "min_bandwidth" : 900000
      } ],
      "segment_duration_seconds" : 4,
      "playlist_window_seconds" : 3600
    } ]
  } ]
}

响应示例

状态码：200

Demo Information

{
  "result_code" : "LIVE.100000000",
  "result_msg" : "SUCCESS",
  "domain" : "push.testott.hls.com",
  "app_name" : "ott",
  "id" : "test"
}

状态码：400

Error response

{
  "result_code" : "LIVE.100011001",
  "result_msg" : "param check failed",
  "domain" : "push.testott.hls.com",
  "app_name" : "ott",
  "id" : ""
}

状态码

状态码	描述
200	Demo Information
400	Error response

错误码

请参见错误码。

父主题： OTT频道管理

上一篇：删除频道信息

下一篇：修改频道入流信息

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消