接口功能介绍
支持视频直播产品的发布点/流名粒度配置修改。
使用说明
- 新增发布点/流名粒度配置之前，保证域名已创建过，且没有在途工单；
- 本接口新增分2种场景，①修改发布点配置；②修改流名配置
- 可通过查询发布点/流名粒度配置接口查询新增的发布点配置ID和流名配置ID
- 单个用户一分钟限制调用10次
接口详情
请求方式：POST
请求路径：/live/app-and-stream/update-app-and-stream
请求参数
| 参数 | 类型 | 名称 | 是否必填 | 说明 | 下级对象 |
|---|---|---|---|---|---|
| product_code | string | 产品类型 | 是 | 支持：“005”（视频直播） | |
| domain | string | 域名 | 是 | 加速域名 | |
| apps_conf | list | 发布点配置 | 否 | 发布点配置集合 | apps_conf_single |
| streams_conf | list | 流名配置 | 否 | 流名配置集合 | streams_conf_single |
apps_conf_single
| 参数 | 类型 | 名称 | 是否必填 | 说明 | 下级对象 |
|---|---|---|---|---|---|
| id | string | 发布点配置ID | 是 | 发布点配置ID | |
| third_push | object | 转推任务 | 否 | 只支持配置一个转推任务，当前只支持绑定推流域名 | third_push |
| time_shift | object | 时移任务 | 否 | 只支持配置一个时移任务，当前只支持绑定推流域名 | time_shift |
streams_conf_single
| 参数 | 类型 | 名称 | 是否必填 | 说明 | 下级对象 |
|---|---|---|---|---|---|
| id | string | 流名配置ID | 是 | 流名配置ID | |
| third_push | object | 转推任务 | 否 | 转推任务，只支持配置一个转推任务，当前只支持绑定推流域名 | third_push |
| time_shift | object | 时移任务 | 否 | 时移任务，只支持配置一个时移任务，当前只支持绑定推流域名 | time_shift |
third_push
| 参数 | 类型 | 名称 | 是否必填 | 说明 | 下级对象 |
|---|---|---|---|---|---|
| switch | string | 转推开关 | 是 | 取值：on（开启）、off（关闭） | |
| push_list | list | 转推列表 | 否 | 开关开启时必填 | push_list_single |
push_list_single
| 参数 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| origin | string | 转推目标 | 是 | 支持ipv4、ipv6和域名 |
| port | string | 转推目标端口 | 否 | 不填，默认1935 |
| host | string | 转推host | 否 | 转推使用的请求头host |
time_shift
| 参数 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| switch | string | 时移开关 | 是 | 取值：on（开启）、off（关闭） |
| max_playback_time | string | 时移任务回看时长 | 否 | 取值：30s~30d（time格式，30s到30天）； 默认一小时,支持的单位： s、m、 h、d |
| module_id | string | 模板id | 是 | 时移需要绑定的录制模板id |
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| message | string | 描述信息 |
示例
请求路径：https://cdnapi-global.ctapi.ctyun.cn/live/app-and-stream/update-app-and-stream
请求示例
{
"product_code": "005",
"domain": "ctyun.cn",
"apps_conf": [
{
"id": "xxxxxwe2e2",
"time_shift": {
"switch": "on",
"max_playback_time": "32s",
"module_id": "d65cd5"
},
"third_push": {
"switch": "on",
"push_list": [
{
"origin": "1.1.1.1",
"host": "ctyun.cn1"
}
]
}
}
],
"streams_conf": [
{
"id": "stream_xxxxxwe2e2",
"time_shift": {
"switch": "on",
"max_playback_time": "32s",
"module_id": "d6acd5"
},
"third_push": {
"switch": "on",
"push_list": [
{
"origin": "1.1.1.1",
"host": "ctyun.cn2"
}
]
}
}
]
}
正常响应示例
{
"code": 100000,
"message": "success"
}
错误码请参考：参数code和message含义
