接口功能介绍

支持批量修改视频直播产品的域名配置。

使用说明

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

接口详情

请求方式：POST

请求路径：/live/domain/batch-update-configuration-information

请求参数

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

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

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

响应参数

示例

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

请求示例

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

{
    "product_code": "005",
    "domain": [
        "ctyun.cn",
        "ctyun.cn1",
        "ctyun.cn2"
    ],
    "ip_access_control": {
        "switch": "on",
        "list": [
            "1.2.3.4",
            "5.6.7.8"
        ],
        "type": 1
    },
    "self_notice": {
        "switch": "on",
        "notify_address": "1.1.1.1",
        "notify_host": "2.2.2.2",
        "notify_port": 81,
        "notify_start_url_path": "/pushStart",
        "notify_stop_url_path": "/pushStop"
    },
    "time_shift": {
        "switch": "on",
        "max_playback_time": "32s",
        "module_id": "d6aaaa5"
    },
    "third_push": {
        "switch": "on",
        "push_list": [
            {
                "origin": "1.1.1.1",
                "host": "ctyun.cn3",
                "port": "1935"
            }
        ]
    }
}

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

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

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

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

正常响应示例

{
    "code": 100000,
    "message": "success",
    "success_number": 3,
    "domain_details": [
        {
            "code": 100000,
            "message": "success",
            "domain": "ctyun.cn"
        },
        {
            "code": 100000,
            "message": "success",
            "domain": "ctyun.cn1"
        },
        {
            "code": 100000,
            "message": "success",
            "domain": "ctyun.cn2"
        }
    ]
}