修改频道打包信息 - ModifyOttChannelInfoEndPoints

live:ott:updateChannelEndpoint

Write

-

-

-

-

project_id

是

String

参数解释：

项目ID，获取方法请参考获取项目ID。

约束限制：

不涉及

取值范围：

[1,32]

默认取值：

不涉及

X-Auth-Token

否

String

参数解释：

用户Token，使用Token鉴权方式时为必填项。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及

取值范围：

[1,256]

默认取值：

不涉及

Authorization

否

String

参数解释：

使用AK/SK方式认证时必填，携带的鉴权信息。

约束限制：

不涉及

取值范围：

[1,256]

默认取值：

不涉及

X-Sdk-Date

否

String

参数解释：

请求的发生时间，使用AK/SK方式认证时为必填项。

约束限制：

不涉及

取值范围：

[1,256]

默认取值：

不涉及

X-Project-Id

否

String

参数解释：

使用AK/SK方式认证时为必填项，携带项目ID信息。

约束限制：

不涉及

取值范围：

[1,64]

默认取值：

不涉及

domain

是

String

参数解释：

频道推流域名

约束限制：

不涉及

取值范围：

只能由小写英文字符与"-"、"_"组成，且长度为[1~255]个字符。

默认取值：

不涉及

app_name

是

String

参数解释：

组名或应用名

约束限制：

不涉及

取值范围：

只能由英文字符与"-"、"_"组成，首字符必须为字母。且长度为[1~64]个字符。

默认取值：

不涉及

id

是

String

参数解释：

频道ID，频道唯一标识。

约束限制：

不涉及

取值范围：

只能由英文字符与"-"、"_"组成，首字符必须为字母。且长度为[2~64]个字符。

默认取值：

不涉及

endpoints

否

Array of EndpointItem objects

参数解释：

频道出流信息

约束限制：

不涉及

hls_package

否

Array of HlsPackageItem objects

参数解释：

HLS打包信息

约束限制：

不涉及

dash_package

否

Array of DashPackageItem objects

参数解释：

DASH打包信息

约束限制：

不涉及

mss_package

否

Array of MssPackageItem objects

参数解释：

MSS打包信息

约束限制：

不涉及

id

否

String

参数解释：

package唯一标识id，由服务创建并在查询时返回，修改endpoints时需要携带。

约束限制：

不涉及

取值范围：

只能由英文字符组成，且长度为[0~32]个字符。

默认取值：

不涉及

url

否

String

参数解释：

客户自定义的拉流地址

约束限制：

不涉及

取值范围：

只能由英文字符组成，且长度为[0~1024]个字符。

默认取值：

不涉及

stream_selection

否

Array of StreamSelectionItem objects

参数解释：

从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。

约束限制：

不涉及

hls_version

否

String

参数解释：

HLS版本号

约束限制：

不涉及

取值范围：

长度为[0~10]个字符。

默认取值：

不涉及

segment_duration_seconds

是

Integer

参数解释：

频道输出分片的时长，为必选项，单位：秒。

约束限制：

修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！

默认取值：

不涉及

取值范围：

1~10

playlist_window_seconds

否

Integer

参数解释：

频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。单位：秒。

约束限制：

不涉及

默认取值：

不涉及

取值范围：

0~86400

encryption

否

Encryption object

参数解释：

加密信息

约束限制：

不涉及

ads

否

Object

参数解释：

广告配置

约束限制：

不涉及

ext_args

否

Object

参数解释：

其他额外参数

约束限制：

不涉及

request_args

否

PackageRequestArgs object

参数解释：

播放相关配置

约束限制：

不涉及

ad_marker

否

Array of strings

参数解释：

广告标识。

约束限制：

不能超过10条。HLS取值：["ENHANCED_SCTE35"]。

enable_access

否

Boolean

参数解释：

允许本输出可以直接从源站拉流

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

• true：允许output访问

• false：禁止output访问

默认取值：

false

allow_all_ip_access

否

Boolean

参数解释：

是否放通所有的IP访问

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

• true：允许所有的IP地址访问，ip_whitelist配置不生效

• false：不允许所有的IP地址访问，ip_whitelist生效，仅在ip_whitelist配置的ip地址才能访问

默认取值：

false

ip_whitelist

否

String

参数解释：

允许直接从源站拉流的IP白名单

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

长度限制[0~2048]

默认取值：

不涉及

cdn_identifier_header

否

HttpHeader object

参数解释：

HttpHeader CDN认证头域

约束限制：

不涉及

origin_domain_master

否

String

参数解释：

源站分发域名-主region

约束限制：

domain.region跟CreateOttChannelInfoReq.region一致

满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$

取值范围：

长度限制[0~255]

默认取值：

不涉及

origin_domain_slave

否

String

参数解释：

源站分发域名-备region

约束限制：

origin_domain_master的备源站

1、国际站

新加坡的备源站：香港

香港的备源站：新加坡

利雅得的备源站：新加坡

约翰内斯堡的备源站：新加坡

2、中国站

北京四的备源站：上海

满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$

取值范围：

长度限制[0~255]

默认取值：

不涉及

manifest_name

否

String

参数解释：

output的索引文件名字

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

大小写字母、数字、"-"、"."、"_"，不能有/路径，且长度限制[0~128]

默认取值：

index

slave_url

否

String

参数解释：

备region拉流地址，无需配置，由服务生成。

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

长度限制[0~1024]

默认取值：

不涉及

manifest_selection

否

ManifestSelection object

参数解释：

流选择配置

约束限制：

不涉及

id

否

String

参数解释：

package唯一标识id，由服务创建并在查询时返回，修改endpoints时需要携带。

约束限制：

不涉及

取值范围：

只能由英文字符组成，且长度为[0~32]个字符。

默认取值：

不涉及

url

否

String

参数解释：

客户自定义的拉流地址

约束限制：

不涉及

取值范围：

只能由英文字符组成，且长度为[0~1024]个字符。

默认取值：

不涉及

stream_selection

否

Array of StreamSelectionItem objects

参数解释：

从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。

约束限制：

不涉及

segment_duration_seconds

是

Integer

参数解释：

频道输出分片的时长，为必选项，单位：秒。

修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！

约束限制：

不涉及

默认取值：

不涉及

取值范围：

1~10

playlist_window_seconds

否

Integer

参数解释：

频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。单位：秒。

约束限制：

不涉及

默认取值：

不涉及

取值范围：

0~86400

encryption

否

Encryption object

参数解释：

加密信息

约束限制：

不涉及

ads

否

Object

参数解释：

广告配置

约束限制：

不涉及

ext_args

否

Object

参数解释：

其他额外参数

约束限制：

不涉及

request_args

否

PackageRequestArgs object

参数解释：

播放相关配置

约束限制：

不涉及

ad_marker

否

String

参数解释：

广告标识

约束限制：

DASH取值："xml+bin"

取值范围：

• xml+bin

• xml

默认取值：

不涉及

suggested_presentation_delay

否

Integer

参数解释：

建议播放延迟，单位：秒

约束限制：

不涉及

默认取值：

不涉及

取值范围：

1~120

minimum_update_period

否

Integer

参数解释：

索引最短更新周期，单位：秒

约束限制：

不涉及

默认取值：

不涉及

取值范围：

1~120

min_buffer_time

否

Integer

参数解释：

最小缓冲时间，单位：秒

约束限制：

不涉及

默认取值：

不涉及

取值范围：

1~120

enable_access

否

Boolean

参数解释：

允许本输出可以直接从源站拉流。

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

• true：允许output访问

• false：禁止output访问

默认取值：

false

allow_all_ip_access

否

Boolean

参数解释：

是否放通所有的IP访问

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

• true：允许所有的IP地址访问，ip_whitelist配置不生效

• false：不允许所有的IP地址访问，ip_whitelist生效，仅在ip_whitelist配置的ip地址才能访问

默认取值：

false

ip_whitelist

否

String

参数解释：

允许直接从源站拉流的IP白名单

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

长度限制[0~2048]

默认取值：

不涉及

cdn_identifier_header

否

HttpHeader object

参数解释：

HttpHeader CDN认证头域

约束限制：

不涉及

origin_domain_master

否

String

参数解释：

源站分发域名-主region

约束限制：

domain.region跟CreateOttChannelInfoReq.region一致

满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$

取值范围：

长度限制[0~255]

默认取值：

不涉及

origin_domain_slave

否

String

参数解释：

源站分发域名-备region

约束限制：

origin_domain_master的备源站

1、国际站

新加坡的备源站：香港

香港的备源站：新加坡

利雅得的备源站：新加坡

约翰内斯堡的备源站：新加坡

2、中国站

北京四的备源站：上海

满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$

取值范围：

长度限制[0~255]

默认取值：

不涉及

manifest_name

否

String

参数解释：

output的索引文件名字

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

大小写字母、数字、"-"、"."、"_"，不能有/路径，且长度限制[0~128]

默认取值：

index

slave_url

否

String

参数解释：

备region拉流地址，无需配置，由服务生成。

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

长度限制[0~1024]

默认取值：

不涉及

manifest_selection

否

ManifestSelection object

参数解释：

流选择配置

约束限制：

不涉及

id

否

String

参数解释：

package唯一标识id，由服务创建并在查询时返回，修改endpoints时需要携带。

约束限制：

不涉及

取值范围：

只能由英文字符组成，且长度为[0~32]个字符。

默认取值：

不涉及

url

否

String

参数解释：

客户自定义的拉流地址

约束限制：

不涉及

取值范围：

只能由英文字符组成，且长度为[0~1024]个字符。

默认取值：

不涉及

stream_selection

否

Array of StreamSelectionItem objects

参数解释：

从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。

约束限制：

不涉及

segment_duration_seconds

是

Integer

参数解释：

频道输出分片的时长，为必选项，单位：秒。

约束限制：

修改分片时长会影响已录制内容的时移和回看服务，请谨慎修改！

默认取值：

不涉及

取值范围：

1~10

playlist_window_seconds

否

Integer

参数解释：

频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。单位：秒。

约束限制：

不涉及

默认取值：

不涉及

取值范围：

0~86400

encryption

否

Encryption object

参数解释：

加密信息

约束限制：

不涉及

ext_args

否

Object

参数解释：

其他额外参数

约束限制：

不涉及

delay_segment

否

Integer

参数解释：

延播时长，单位：秒

约束限制：

不涉及

默认取值：

不涉及

取值范围：

1~10

request_args

否

PackageRequestArgs object

参数解释：

播放相关配置

约束限制：

不涉及

enable_access

否

Boolean

参数解释：

允许本输出可以直接从源站拉流

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

• true：允许output访问

• false：禁止output访问

默认取值：

false

allow_all_ip_access

否

Boolean

参数解释：

是否放通所有的IP访问

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

• true：允许所有的IP地址访问，ip_whitelist配置不生效

• false：不允许所有的IP地址访问，ip_whitelist生效，仅在ip_whitelist配置的ip地址才能访问

默认取值：

false

ip_whitelist

否

String

参数解释：

允许直接从源站拉流的IP白名单

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

长度限制[0~2048]

默认取值：

不涉及

cdn_identifier_header

否

HttpHeader object

参数解释：

HttpHeader CDN认证头域

约束限制：

不涉及

origin_domain_master

否

String

参数解释：

源站分发域名-主region

约束限制：

domain.region跟CreateOttChannelInfoReq.region一致

满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$

取值范围：

长度限制[0~255]

默认取值：

不涉及

origin_domain_slave

否

String

参数解释：

源站分发域名-备region

约束限制：

origin_domain_master的备源站

1、国际站

新加坡的备源站：香港

香港的备源站：新加坡

利雅得的备源站：新加坡

约翰内斯堡的备源站：新加坡

2、中国站

北京四的备源站：上海

满足正则：^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.){2,}[a-zA-Z]{2,16}$

取值范围：

长度限制[0~255]

默认取值：

不涉及

manifest_name

否

String

参数解释：

output的索引文件名字

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

大小写字母、数字、"-"、"."、"_"，不能有/路径，且长度限制[0~128]

默认取值：

index

slave_url

否

String

参数解释：

备region拉流地址，无需配置，由服务生成。

约束限制：

频道类型mode是ONLY_OS类型

取值范围：

长度限制[0~1024]

默认取值：

不涉及

manifest_selection

否

ManifestSelection object

参数解释：

流选择配置

约束限制：

不涉及

key

否

String

参数解释：

拉流URL中用于码率过滤的参数

约束限制：

不涉及

取值范围：

长度限制[1,1024]

默认取值：

不涉及

max_bandwidth

否

Integer

参数解释：

最大码率，单位：bps

约束限制：

不涉及

取值范围：

[1,104857600]（100Mbps）

默认取值：

不涉及

min_bandwidth

否

Integer

参数解释：

最小码率，单位：bps

约束限制：

不涉及

取值范围：

[1,104857600]（100Mbps）

默认取值：

不涉及

key_rotation_interval_seconds

否

Integer

参数解释：

密钥缓存时间。如果密钥不变，默认缓存七天。

约束限制：

目前为保留字段，不支持配置。

默认取值：

不涉及

取值范围：

0~604800

encryption_method

否

String

参数解释：

加密方式。

约束限制：

目前为保留字段，不支持配置。

取值范围：

• SAMPLE-AES

• AES-128

默认取值：

SAMPLE-AES

level

否

String

参数解释：

加密等级。

约束限制：

不涉及

取值范围：

• content：一个频道对应一个密钥

• profile：一个码率对应一个密钥

默认取值：

content

resource_id

是

String

参数解释：

客户生成的DRM内容ID。

约束限制：

不涉及

取值范围：

支持英文字符与“-”、“_”，且长度限制[1~128]个字符

默认取值：

不涉及

system_ids

是

Array of strings

参数解释：

system_id枚举值。

• HLS：FairPlay

• DASH：Widevine、PlayReady

• MSS：PlayReady

约束限制：

不涉及

url

是

String

参数解释：

获取密钥的DRM地址

约束限制：

不涉及

取值范围：

长度限制[1~2048]个字符

默认取值：

不涉及

speke_version

是

String

参数解释：

drm speke版本号

约束限制：

当前仅支持1.0版本

取值范围：

• '1.0'

默认取值：

不涉及

request_mode

是

String

参数解释：

请求模式。

约束限制：

不涉及

取值范围：

• direct_http：HTTP(S)直接访问DRM。

• functiongraph_proxy：FunctionGraph代理访问DRM。

默认取值：

不涉及

http_headers

否

Array of HttpHeader objects

参数解释：

需要添加在drm请求头中的鉴权信息。

约束限制：

仅direct_http请求模式支持配置http_headers。最多支持配置5个。

urn

否

String

参数解释：

functiongraph_proxy请求模式需要提供functiongraph的urn。

约束限制：

不涉及

取值范围：

长度限制[1~512]个字符

默认取值：

不涉及

key

是

String

参数解释：

请求头中key字段名

约束限制：

不涉及

取值范围：

长度[1~128]个字符。

默认取值：

不涉及

value

是

String

参数解释：

请求头中key对应的value值

约束限制：

不涉及

取值范围：

长度[1~8000]个字符。

默认取值：

不涉及

record

否

Array of RecordRequestArgs objects

参数解释：

录制播放相关配置

约束限制：

不涉及

取值范围：

限制最多12个

默认取值：

不涉及

timeshift

否

Array of TimeshiftRequestArgs objects

参数解释：

时移播放相关配置

约束限制：

不涉及

取值范围：

限制最多12个

默认取值：

不涉及

live

否

Array of LiveRequestArgs objects

参数解释：

直播播放相关配置

约束限制：

不涉及

取值范围：

限制最多12个

默认取值：

不涉及

start_time

否

String

参数解释：

开始时间

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

end_time

否

String

参数解释：

结束时间

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

format

否

String

参数解释：

格式

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

unit

否

String

参数解释：

单位

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

back_time

否

String

参数解释：

时移时长字段名

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

unit

否

String

参数解释：

单位

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

delay

否

String

参数解释：

时延字段

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

unit

否

String

参数解释：

单位

约束限制：

不涉及

取值范围：

长度限制[0,20]

默认取值：

不涉及

stream_order

否

String

参数解释：

流排序模式

约束限制：

不涉及

取值范围：

• ORIGINAL：保持原始顺序，即按照频道配置中转码模板的顺序

• VIDEO_BITRATE_ASCENDING：按照视频码率升序

• VIDEO_BITRATE_DESCENDING：按照视频码率降序

默认取值：

ORIGINAL

min_video_bandwidth

否

Integer

参数解释：

视频码率过滤的最小码率

约束限制：

单位：bit/s；取值必须比max_video_bandwidth小

取值范围：

0~2147483647

默认取值：

0

max_video_bandwidth

否

Integer

参数解释：

视频码率过滤的最大码率

约束限制：

单位：bit/s；取值必须比min_video_bandwidth大

取值范围：

0~2147483647

默认取值：

2147483647

result_code

String

参数解释：

错误码

取值范围：

详见错误码。

result_msg

String

参数解释：

错误描述

取值范围：

详见错误码描述。

domain

String

参数解释：

推流域名，响应参数不涉及。

取值范围：

不涉及

app_name

String

参数解释：

组名或应用名，响应参数不涉及。

取值范围：

不涉及

id

String

参数解释：

频道ID，频道唯一标识。响应参数不涉及。

取值范围：

不涉及

sources

Array of SourceRsp objects

参数解释：

推流URL列表，最多返回12条。创建频道时，只有入流协议为RTMP_PUSH、SRT_PUSH时，会返回推流URL列表。

url

String

参数解释：

频道源流URL，用于外部拉流

取值范围：

长度限制[1~1024]个字符

bitrate

Integer

参数解释：

码率，单位：bps

取值范围：

0~104857600

width

Integer

参数解释：

分辨率对应宽的值

取值范围：

0~4096

height

Integer

参数解释：

分辨率对应高的值

取值范围：

0~2160

enable_snapshot

Boolean

参数解释：

描述是否使用该流做截图

取值范围：

• true：使用该流做截图

• false：

result_code

String

参数解释：

错误码

取值范围：

详见错误码。

result_msg

String

参数解释：

错误描述

取值范围：

详见错误码描述。

domain

String

参数解释：

推流域名，响应参数不涉及。

取值范围：

不涉及

app_name

String

参数解释：

组名或应用名，响应参数不涉及。

取值范围：

不涉及

id

String

参数解释：

频道ID，频道唯一标识。响应参数不涉及。

取值范围：

不涉及

200

Demo Information

400

Error response