查询频道信息 - ListOttChannelInfo
功能介绍
查询频道信息,支持批量查询。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号根用户具备所有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 |
错误码
请参见错误码。