查询频道信息 - ListOttChannelInfo
功能介绍
查询频道信息,支持批量查询。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
live:ott:listChannel | List | - | - | - | - |
URI
GET /v1/{project_id}/ott/channels
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 项目ID,获取方法请参考获取项目ID。 约束限制: 不涉及 取值范围: [1,32] 默认取值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
data_display | 否 | String | 参数解释: 是否获取隐藏密钥信息。 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
domain | 否 | String | 参数解释: 推流域名 约束限制: 不涉及 取值范围: 只能由小写英文字符与"-"、"_"组成,且长度为[1~255]个字符。 默认取值: 不涉及 |
app_name | 否 | String | 参数解释: 组名或应用名 约束限制: 不涉及 取值范围: 只能由英文字符与"-"、"_"组成,首字符必须为字母。且长度为[1~64]个字符。 默认取值: 不涉及 |
id | 否 | String | 参数解释: 频道ID 约束限制: 不涉及 取值范围: 只能由英文字符与"-"、"_"组成,首字符必须为字母。且长度为[2~64]个字符。 默认取值: 不涉及 |
limit | 否 | Integer | 参数解释: 单次请求分页数量。 约束限制: 查询全量信息时,最大限制100。查询基础信息时,最大限制1000。 取值范围: 1~1000 默认取值: 10 |
offset | 否 | Integer | 参数解释: 偏移量,表示从此偏移量开始查询。 约束限制: 不涉及 取值范围: 0~2147483647 默认取值: 0 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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] 默认取值: 不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
total | Integer | 参数解释: 总频道数 取值范围: 0~1024 |
channels | Array of CreateOttChannelInfoReq objects | 参数解释: 频道信息,根据请求时limit限制返回频道最大数量。 |
参数 | 参数类型 | 描述 |
|---|---|---|
domain | String | 参数解释: 频道推流域名 约束限制: 不涉及 取值范围: 只能由小写英文字符与"-"、"_"组成,且长度为[1~255]个字符。 默认取值: 不涉及 |
app_name | String | 参数解释: 组名或应用名 约束限制: 不涉及 取值范围: 只能由英文字符与"-"、"_"组成,首字符必须为字母。且长度为[1~64]个字符。 默认取值: 不涉及 |
id | String | 参数解释: 频道ID,频道唯一标识。 约束限制: 不涉及 取值范围: 只能由英文字符与"-"、"_"组成,首字符必须为字母。且长度为[2~64]个字符。 默认取值: 不涉及 |
name | String | 参数解释: 频道名称 约束限制: 不涉及 取值范围: 长度为[1~64]个字符。 默认取值: 不涉及 |
state | String | 参数解释: 频道状态 约束限制: 不涉及 取值范围: 默认取值: ON |
mode | String | 参数解释: 频道模式 约束限制: 不涉及 取值范围: 默认取值: ADD_CDN |
region | String | 参数解释: 当mode是ONLY_OS时,该字段生效,表示频道所在Region 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
input | InputStreamInfo object | 参数解释: 频道入流信息 约束限制: 不涉及 |
encoder_settings | Array of encoder_settings objects | 参数解释: 转码模板配置,转码模板个数最大为12个。 约束限制: 不涉及 |
record_settings | record_settings object | 参数解释: 回看录制的配置信息 约束限制: 不涉及 |
endpoints | Array of EndpointItem objects | 参数解释: 频道出流信息 约束限制: 不涉及 |
encoder_settings_expand | EncoderSettingsExpand object | 参数解释: 音频输出配置 约束限制: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
input_protocol | String | 参数解释: 频道入流协议 约束限制: 不涉及 取值范围: 默认取值: FLV_PULL |
sources | Array of SourcesInfo objects | 参数解释: 频道主源流信息 约束限制: |
secondary_sources | Array of SecondarySourcesInfo objects | 参数解释: 频道备源流信息 约束限制: |
failover_conditions | FailoverConditions object | 参数解释: 频道供应商提供的主备音视频流URL切换的配置 约束限制: 非必填项 |
max_bandwidth_limit | Integer | 参数解释: 当入流协议为HLS_PULL时,需要配置的最大带宽。 约束限制: 用户提供的拉流URL中,针对不同码率的音视频,均会携带带宽参数“BANDWIDTH”。 取值范围: [0,104857600] 默认取值: 不涉及 |
ip_port_mode | Boolean | 参数解释: 当推流协议为SRT_PUSH时,如果配置了直推源站,编码器不支持输入streamid,需要打开设置为true 约束限制: 不涉及 取值范围: 默认取值: false |
ip_whitelist | String | 参数解释: 客户推流的IP白名单 约束限制: 协议为SRT_PUSH类型时,需要携带推流白名单 取值范围: 支持数字与“/”、“,”,字符串,长度限制[0~256]个字符 默认取值: 不涉及 |
scte35_source | String | 参数解释: 广告的scte35信号源 约束限制: 仅HLS_PULL类型的频道支持此配置,且目前仅支持SEGMENTS 取值范围: SEGMENTS、MANIFEST 默认取值: 不涉及 |
ad_triggers | Array of strings | 参数解释: 广告触发器配置。 约束限制: 最多设置五个 取值范围: 默认取值: 不涉及 |
audio_selectors | Array of InputAudioSelector objects | 参数解释: 音频选择器, 约束限制: 最多设置8个音频选择器 |
参数 | 参数类型 | 描述 |
|---|---|---|
url | String | 参数解释: 频道源流URL,用于外部拉流,当请求协议为SRT_PUSH、RTMP_PUSH时,无需填写 约束限制: 无需直播转码时,此参数为必填项 取值范围: 长度限制[1~1024]位 默认取值: 不涉及 |
bitrate | Integer | 参数解释: 码率,单位:bps 约束限制: 无需直播转码时,此参数为必填项 默认取值: 不涉及 取值范围: 0~104857600 |
width | Integer | 参数解释: 分辨率对应宽的值 约束限制: 不涉及 默认取值: 不涉及 取值范围: 0~4096 |
height | Integer | 参数解释: 分辨率对应高的值 约束限制: 不涉及 默认取值: 不涉及 取值范围: 0~2160 |
enable_snapshot | Boolean | 参数解释: 描述是否使用该流做截图 约束限制: 不涉及 取值范围: 默认取值: false |
bitrate_for3u8 | Boolean | 参数解释: 是否使用bitrate来固定码率 约束限制: 不涉及 取值范围: 默认取值: false |
passphrase | String | 参数解释: 协议为SRT_PUSH时的加密信息 约束限制: 不涉及 取值范围: 长度限制[10~79]个字符 默认取值: 不涉及 |
backup_urls | Array of strings | 参数解释: 备入流地址列表 约束限制: 不涉及 取值范围: 限制最多12个 默认取值: 不涉及 |
stream_id | String | 参数解释: 频道为SRT_PULL类型时,拉流地址的Stream ID 约束限制: 不涉及 取值范围: 长度限制[0~512]个字符 默认取值: 不涉及 |
latency | Integer | 参数解释: 频道为SRT_PULL类型时的拉流时延 约束限制: 不涉及 取值范围: 取值限制100~15000 默认取值: 不涉及 |
pbkeylen | Integer | 参数解释: srt加密算法,包含如下取值: 约束限制: 不涉及 取值范围: 16~32 默认取值: 32 |
参数 | 参数类型 | 描述 |
|---|---|---|
url | String | 参数解释: 频道源流URL,用于外部拉流,当请求协议为SRT_PUSH、RTMP_PUSH时,无需填写 约束限制: 无需直播转码时,此参数为必填项 取值范围: 不涉及 默认取值: 不涉及 |
bitrate | Integer | 参数解释: 码率,单位:bps 约束限制: 无需直播转码时,此参数为必填项 默认取值: 不涉及 取值范围: 0~104857600 |
width | Integer | 参数解释: 分辨率对应宽的值 约束限制: 不涉及 默认取值: 不涉及 取值范围: 0~4096 |
height | Integer | 参数解释: 分辨率对应高的值 约束限制: 不涉及 默认取值: 不涉及 取值范围: 0~2160 |
bitrate_for3u8 | Boolean | 参数解释: 是否使用bitrate来固定码率 取值范围: 约束限制: 不涉及 默认取值: false |
passphrase | String | 参数解释: 协议为SRT_PUSH时的加密信息 约束限制: 不涉及 取值范围: 长度限制[10~79]个字符 默认取值: 不涉及 |
backup_urls | Array of strings | 参数解释: 备入流地址列表 约束限制: 不涉及 取值范围: 限制最多12个 默认取值: 不涉及 |
stream_id | String | 参数解释: 频道为SRT_PULL类型时,拉流地址的Stream ID 约束限制: 不涉及 取值范围: 长度限制[0~512]个字符 默认取值: 不涉及 |
latency | Integer | 参数解释: 频道为SRT_PULL类型时的拉流时延 约束限制: 不涉及 取值范围: 取值限制100~15000 默认取值: 不涉及 |
pbkeylen | Integer | 参数解释: srt加密算法,取值如下: 约束限制: 不涉及 取值范围: 16~32 默认取值: 32 |
参数 | 参数类型 | 描述 |
|---|---|---|
input_loss_threshold_msec | Integer | 参数解释: 入流停止的时长阈值,到达此阈值后,自动触发主备切换。单位:毫秒。 约束限制: 不涉及 默认取值: 2000 取值范围: 0~3600000 |
input_preference | String | 参数解释: 以主入流URL为第一优先级(PRIMARY)或主备URL平等切换(EQUAL) 约束限制: 非必填,如果是平等切换时,使用的是备URL,不会自动切换至主URL 取值范围: 默认取值: EQUAL |
参数 | 参数类型 | 描述 |
|---|---|---|
name | String | 参数解释: 音频选择器的名称 约束限制: 同一个频道中每个选择器的名称需要唯一 取值范围: 仅支持大小写字母、数字、中划线和下划线。且长度为[1~255]个字符。 默认取值: 不涉及 |
selector_settings | AudioSelectorSettings object | 参数解释: 设置音频选择器 约束限制: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
audio_language_selection | AudioSelectorLangSelection object | 参数解释: 设置语言选择器 约束限制: 不涉及 |
audio_pid_selection | AudioSelectorPidSelection object | 参数解释: 设置PID选择器 约束限制: 不涉及 |
audio_hls_selection | AudioSelectorHlsSelection object | 参数解释: 设置Hls选择器 约束限制: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
language_code | String | 参数解释: 语言简称 约束限制: 不涉及 取值范围: 输入2或3个小写字母的语言代码 默认取值: 不涉及 |
language_selection_policy | String | 参数解释: 语言输出策略 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
name | String | 参数解释: hls音频选择器名 约束限制: 不涉及 取值范围: 字符长度[1,255] 默认取值: 不涉及 |
group_id | String | 参数解释: hls音频选择器gid 约束限制: 不涉及 取值范围: 字符长度[1,255] 默认取值: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
template_id | String | 参数解释: 转码模板ID 约束限制: 不涉及 取值范围: 只能由英文字符与"-"、"_"组成,且长度为[1~255]个字符。 默认取值: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
rollingbuffer_duration | Integer | 参数解释: 最大回看录制时长。在此时间段内会连续不断地录制,为必选项 单位:秒。取值为“0”时,表示不支持录制;最大支持录制14天。 约束限制: 不涉及 默认取值: 不涉及 取值范围: 0~1209600 |
参数 | 参数类型 | 描述 |
|---|---|---|
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类型 取值范围: 默认取值: false |
allow_all_ip_access | Boolean | 参数解释: 是否放通所有的IP访问 约束限制: 频道类型mode是ONLY_OS类型 取值范围: 默认取值: 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" 取值范围: 默认取值: 不涉及 |
suggested_presentation_delay | Integer | 参数解释: 建议播放延迟,单位:秒 约束限制: 不涉及 默认取值: 不涉及 取值范围: 1~120 |
minimum_update_period | Integer | 参数解释: 索引最短更新周期,单位:秒 约束限制: 不涉及 默认取值: 不涉及 取值范围: 1~120 |
min_buffer_time | Integer | 参数解释: 最小缓冲时间,单位:秒 约束限制: 不涉及 默认取值: 不涉及 取值范围: 1~120 |
enable_access | Boolean | 参数解释: 允许本输出可以直接从源站拉流。 约束限制: 频道类型mode是ONLY_OS类型 取值范围: 默认取值: false |
allow_all_ip_access | Boolean | 参数解释: 是否放通所有的IP访问 约束限制: 频道类型mode是ONLY_OS类型 取值范围: 默认取值: 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类型 取值范围: 默认取值: false |
allow_all_ip_access | Boolean | 参数解释: 是否放通所有的IP访问 约束限制: 频道类型mode是ONLY_OS类型 取值范围: 默认取值: 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 |
level | String | 参数解释: 加密等级。 约束限制: 不涉及 取值范围: 默认取值: content |
resource_id | String | 参数解释: 客户生成的DRM内容ID。 约束限制: 不涉及 取值范围: 支持英文字符与“-”、“_”,且长度限制[1~128]个字符 默认取值: 不涉及 |
system_ids | Array of strings | 参数解释: system_id枚举值。 约束限制: 不涉及 |
url | String | 参数解释: 获取密钥的DRM地址 约束限制: 不涉及 取值范围: 长度限制[1~2048]个字符 默认取值: 不涉及 |
speke_version | String | 参数解释: drm speke版本号 约束限制: 当前仅支持1.0版本 取值范围: 默认取值: 不涉及 |
request_mode | String | 参数解释: 请求模式。 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
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 |
min_video_bandwidth | Integer | 参数解释: 视频码率过滤的最小码率 约束限制: 单位:bit/s;取值必须比max_video_bandwidth小 取值范围: 0~2147483647 默认取值: 0 |
max_video_bandwidth | Integer | 参数解释: 视频码率过滤的最大码率 约束限制: 单位:bit/s;取值必须比min_video_bandwidth大 取值范围: 0~2147483647 默认取值: 2147483647 |
参数 | 参数类型 | 描述 |
|---|---|---|
audio_descriptions | Array of audio_descriptions objects | 参数解释: 音频输出配置的描述信息 约束限制: 不涉及 取值范围: 最大支持8个 默认取值: 不涉及 |
video_descriptions | VideoDescriptions object | 参数解释: 视频输出配置的描述信息 约束限制: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
name | String | 参数解释: 音频输出配置的名称 约束限制: 同一个频道不同的音频输出配置名称,不允许重复 取值范围: 仅支持大小写字母,数字,中划线(-),下划线(_),且字符长度[1,255]。 默认取值: 不涉及 |
audio_selector_name | String | 参数解释: 音频选择器名称 约束限制: 不涉及 取值范围: 仅支持大小写字母,数字,中划线(-),下划线(_),且字符长度[1,255]。 默认取值: 不涉及 |
language_code_control | String | 参数解释: 语言代码控制。这里的设置不会修改音频实际的语言,只会修改音频对外展示的语言 约束限制: 同一个频道不同的音频输出配置名称,不允许重复 取值范围: 默认取值: 不涉及 |
language_code | String | 参数解释: 语言代码 约束限制: 不涉及 取值范围: 输入2或3个小写字母 默认取值: 不涉及 |
stream_name | String | 参数解释: 流名称 约束限制: 不涉及 取值范围: 字符长度[0,255] 默认取值: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
gop_duration_seconds | Integer | 参数解释: 自定义gop时长,单位秒 约束限制: 默认值0,表示跟随源流,不支持7和9,值无效时按默认值处理 取值范围: 0~10 默认取值: 0 |
状态码:400
请求示例
GET https://{endpoint}/v1/{project_id}/ott/channels?app_name=ott&domain=push.testott.hls.com&id=test 响应示例
状态码:200
Demo Information
{
"total" : 1,
"channels" : [ {
"domain" : "push.testott.hls.com",
"app_name" : "ott",
"id" : "test",
"name" : "testname",
"input" : {
"input_protocol" : "RTMP_PUSH",
"sources" : [ {
"url" : "rtmp://push.testott.hls.com/ott/test_1024?request_source=ott&channel_id=test",
"bitrate" : 1024,
"width" : 100,
"height" : 100
} ],
"failover_conditions" : {
"input_loss_threshold_msec" : 100,
"input_preference" : "EQUAL"
}
},
"record_settings" : {
"rollingbuffer_duration" : 86400
},
"endpoints" : [ {
"hls_package" : [ {
"url" : "pull.testott.hls.com/ott/test/index.m3u8",
"stream_selection" : [ {
"key" : "sss",
"max_bandwidth" : 0,
"min_bandwidth" : 0
} ],
"segment_duration_seconds" : 4,
"playlist_window_seconds" : 3600,
"request_args" : {
"record" : [ {
"start_time" : "begin",
"end_time" : "end",
"format" : "timestamp",
"unit" : "second"
} ],
"timeshift" : [ {
"back_time" : "begin",
"unit" : "second"
} ],
"live" : null
},
"hls_version" : "1"
} ],
"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,
"request_args" : {
"record" : [ {
"start_time" : "begin",
"end_time" : "end",
"format" : "timestamp",
"unit" : "second"
} ],
"timeshift" : [ {
"back_time" : "begin",
"unit" : "second"
} ],
"live" : null
}
} ],
"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,
"request_args" : {
"record" : [ {
"start_time" : "begin",
"end_time" : "end",
"format" : "timestamp",
"unit" : "second"
} ],
"timeshift" : [ {
"back_time" : "begin",
"unit" : "second"
} ],
"live" : null
}
} ]
} ],
"state" : "OFF"
} ]
} 状态码:400
Error response
{
"result_code" : "LIVE.103011019",
"result_msg" : "The resource to access is not exists",
"domain" : "push.testott.hls.com",
"app_name" : "ott",
"id" : "agbc"
} 状态码
状态码 | 描述 |
|---|---|
200 | Demo Information |
400 | Error response |
错误码
请参见错误码。

