接口功能介绍

支持直播推流、拉流域名配置的修改。

使用说明

• 修改域名之前，您需要先开通对应产品类型的服务，且保证资源包/按需服务有效；
• 需通过创建域名接口完成域名的创建后，才可进行域名配置的修改；
• 该域名没有在途工单；
• 调用接口成功仅代表成功进入配置下发流程，配置部署需要一些时间，请等待10分钟后通过查询域名配置信息查看配置是否下发完成；
• 单个用户一分钟限制调用10次；
• 视频直播产品的域名修改分3种场景，①修改推流域名；②修改拉流域名，且拉流模式为推拉流；③修改拉流域名，且拉流模式为回源拉流；
• 接口的 一级功能为增量更新，二级功能为全量更新 ，如可选择只更新ip_access_control，但ip_access_control下的配置项需全量更新。

接口详情

请求方式：POST

请求路径：/live/domain/update-domain

请求参数

场景1：推流域名配置修改

场景2：拉流域名配置修改（推拉流场景）

场景3：拉流域名配置修改（拉流回源场景）

响应参数

示例

请求路径：https://cdnapi-global.ctapi.ctyun.cn/live/domain/update-domain

请求示例

场景1：更新推流域名配置

{
"product_code":"005",
"domain":"push.ctyun.cn",
"ip_access_control": {
"switch": "on",
"type":0,
"list": ["1.1.1.1","2.2.2.2"]
},
"self_notice ": {
"switch": "on",
"notify_address":"ctyun.cn1",
"notify_port": 80,
"notify_host": "ctyun.cn1",
"notify_start_url_path": "/pushstart",
"notify_stop_url_path":"/pushend"
},
"time_shift": {
"switch": "on",
"max_playback_time":"30d",
"module_id": "123"
},
"third_push": {
"switch": "on",
"push_list":[{
"origin":"ctyun.cn2",
"port":"1935",
"host":"ctyun.cn2"}]
}
}

场景2：拉流域名配置修改（推拉流场景）

{
        "product_code": "005",
        "domain": "pull.ctyun.cn",
        "push_stream_domain": "push.ctyun.cn",
        "ip_access_control": {
                "switch": "on",
                "type": 0,
                "list": [
                        "1.2.3.4",
                        "5.6.7.8"
                ]
        },
        "referer_control": {
                "switch": "on",
                "type": 1,
                "allow_empty": "on",
                "list": [
                        "1.2.3.4",
                        "5.6.7.8"
                ]
        },
        "https_switch": 1,
        "cert_name": "test0308"
}

场景3：拉流域名配置修改（回源拉流场景）

{
        "product_code": "005",
        "domain": "ctyun.cn2",
        "rtmp_origin": [{
                "origin": "ctyun.cn2"
        }],
        "ip_access_control": {
                "switch": "on",
                "type": 0,
                "list": [
                        "1.2.3.4",
                        "5.6.7.8"
                ]
        },
        "referer_control": {
                "switch": "on",
                "type": 1,
                "allow_empty": "on",
                "list": [
                        "1.2.3.4",
                        "5.6.7.8"
                ]},
        "https_switch": 1,
        "cert_name": "test0308"
}

正常响应示例

{
"code": 100000,
"message": "success"
}

错误码请参考：参数code和message含义