参数 类型 是否必填 名称及描述 code int 是 状态码 message string 是 描述信息 result list 否 返回结果列表 result[].domain string 否 域名 result[].logs list 否 下载日志地址列表 result[ ].logs[ ].timepoint string 否 日志文件包含的时间点，北京时间，格式为： YYYYMMDD HH:MM result[ ].logs[ ].size int 否 日志文件大小，单位：B result[ ].logs[ ].url string 否 日志文件下载路径 result[ ].logs[ ].md5 string 否 日志文件md5值

参数 类型 名称 是否必传 说明 domain list 域名列表 是 最多支持５个

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list 是 每个时间间隔的结果 result[].timestamp int 是 时间片开始时间戳 result[].uvcount int 是 uv

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list 是 每个时间间隔的结果 result[].timestamp int 是 时间片开始时间戳 result[].pvcount int 是 pv

接口功能介绍 更新直播拉流配置信息。 使用说明 更新直播拉流配置。单个用户一分钟限制调用100次。 接口详情 请求方式：POST 请求路径：/live/preload/updatepreload 请求参数 参数名 类型 名称 是否必填 说明 ::::: type string 任务类型 是 可选参数为 hls或flv。 hls: http hls直播流；flv：http/flv直播流。 taskid string 任务id 是 需要修改的任务id url string 拉流URL 是 支持hls，http/flv请求url。需要带协议头(例如 starttime string 预拉取的起始时间 是 时间格式："20190521 18:03:48"，开始时间不能小于当前时间。 endtime string 预拉取的结束时间 是 预拉取的结束时间，时间格式："20190521 18:03:48" 。endtime<当前时间或者endtimestarttime<10分钟 会返回失败。 如果有起始时间没有结束时间，一直拉取，直到任务被停止，或者超时范围内没有拉到流,回调任务停止或者任务失败 响应参数 字段名称 类型 说明 ::: code int 当code100000则提交成功，其他失败 taskid string message string 当code ! 100000时，显示错误信息 示例 请求路径： 请求示例 { "type":"flv", "taskid":"598832427460198400", "url":"ctyun.cn", "starttime":"20221117 18:13:00", "endtime":"20221117 19:50:00" }

相关概念 根据《非经营性互联网信息服务备案管理办法（中华人民共和国信息产业部令第33号）》和《互联网信息服务管理办法（中华人民共和国国务院令第292号）》规定，国家对经营性互联网信息服务实行许可制度，对非经营性互联网信息服务实行备案制度。未获取许可或者未履行备案手续的，不得从事互联网信息服务，否则属于违法行为。 在中国大陆地区注册的域名需要已完成ICP备案且备案信息准确有效。如果域名未备案或备案信息不完整，可能会出现备案阻断的情况，即无法在中国大陆地区正常访问该域名对应的网站。 更多相关法律法规请参阅工业和信息化部ICP/IP地址/域名信息备案管理系统。

参数 类型 名称 是否必传 描述 domain string 域名 是 加速域名，多个以英文逗号,分隔。

接口功能介绍 调用本接口查询所有的地区信息。 使用说明 单个用户一分钟限制调用10000次，并发不超过100 接口详情 请求方式：get 请求路径：/liveapi/notifytemplate/list 请求参数 无 响应参数 参数 类型 说明 ::: code int 状态码 message string 描述信息 result list 返回结果数组 result[].areacode int 地区编码 result[].areacnname string 中文名称 result[].level int 区域级别 示例 请求路径： 请求示例 正常响应示例 json { "code": 100000, "message": "success", "result": [ { "level": 1, "areacode": 340000, "areacnname": "安徽" }, { "level": 1, "areacode": 330000, "areacnname": "浙江" }, { "level": 1, "areacode": 310000, "areacnname": "上海" }, { "level": 1, "areacode": 320000, "areacnname": "江苏" }, { "level": 1, "areacode": 360000, "areacnname": "江西" }, { "level": 1, "areacode": 350000, "areacnname": "福建" }, { "level": 1, "areacode": 440000, "areacnname": "广东" }, { "level": 1, "areacode": 450000, "areacnname": "广西" }, { "level": 1, "areacode": 460000, "areacnname": "海南" }, { "level": 1, "areacode": 410000, "areacnname": "河南" }, { "level": 1, "areacode": 430000, "areacnname": "湖南" }, { "level": 1, "areacode": 420000, "areacnname": "湖北" }, { "level": 1, "areacode": 210000, "areacnname": "辽宁" }, { "level": 1, "areacode": 220000, "areacnname": "吉林" }, { "level": 1, "areacode": 230000, "areacnname": "黑龙江" }, { "level": 1, "areacode": 610000, "areacnname": "陕西" }, { "level": 1, "areacode": 620000, "areacnname": "甘肃" }, { "level": 1, "areacode": 630000, "areacnname": "青海" }, { "level": 1, "areacode": 640000, "areacnname": "宁夏" }, { "level": 1, "areacode": 650000, "areacnname": "新疆" }, { "level": 1, "areacode": 110000, "areacnname": "北京" }, { "level": 1, "areacode": 120000, "areacnname": "天津" }, { "level": 1, "areacode": 130000, "areacnname": "河北" }, { "level": 1, "areacode": 140000, "areacnname": "山西" }, { "level": 1, "areacode": 150000, "areacnname": "内蒙古" }, { "level": 1, "areacode": 370000, "areacnname": "山东" }, { "level": 1, "areacode": 500000, "areacnname": "重庆" }, { "level": 1, "areacode": 510000, "areacnname": "四川" }, { "level": 1, "areacode": 520000, "areacnname": "贵州" }, { "level": 1, "areacode": 530000, "areacnname": "云南" }, { "level": 1, "areacode": 540000, "areacnname": "西藏" }, { "level": 0, "areacode": 0, "areacnname": "中国" }, { "level": 1, "areacode": 820000, "areacnname": "澳门特别行政区" }, { "level": 1, "areacode": 810000, "areacnname": "香港特别行政区" }, { "level": 1, "areacode": 710000, "areacnname": "台湾省" } ] }

本文通过图文介绍删除证书的操作步骤。 功能介绍 当证书过期或者不再使用时，可通过直播控制台删除证书。 注意事项 证书删除的前提是未绑定域名，因此如果需要删除证书，则需先解除证书与域名的绑定关系。 操作步骤 1. 登录直播控制台。 2. 在【证书管理】页面，选定目标证书，在操作列单击【删除】。 3. 直播控制台会弹窗（如下图），客户进行二次确认后，单击【确认】即可删除。

参数名 类型 说明 code int 状态码 message string 描述信息 starttime int 开始时间戳 endtime int 结束时间戳 interval string 时间粒度 reqonlinenuminterval list 每个时间间隔的在线人数 reqonlinenuminterval[].timestamp int 时间片开始时间戳 reqonlinenuminterval[].domain string 域名 reqonlinenuminterval[].app string 应用名 reqonlinenuminterval[].stream string 流名 reqonlinenuminterval[].province int 省编码 reqonlinenuminterval[].isp string 运营商编码 reqonlinenuminterval[].protocol string 应用层协议 reqonlinenuminterval[].livetype string 直播协议类型 reqonlinenuminterval[].online long 在线人数

接口功能介绍 查询直播录制路数。 使用说明 单个用户一分钟限制调用10000次，并发不超过100。 接口详情 请求方式：post 请求路径：/live/statistics/queryrecorddata 请求参数 参数名 类型 名称 是否必填 说明 ::::: starttime int 开始时间戳 是 起始时间，时间戳(秒) endtime int 结束时间戳 是 结束时间，时间戳(秒) interval string 时间粒度 否 时间间隔粒度，单位为s，只支持2种，5分钟（300）和一天（86400），默认300。 domain list 域名列表 否 域名列表，不传默认名下所有域名，且域名的个数不超过100个 响应参数 参数名 类型 说明 ::: code int 状态码 message string 描述信息 starttime int 开始时间戳 endtime int 结束时间戳 interval string 时间粒度 reqtranscodingdatainterval list 每个时间间隔的录制路数 reqtranscodingdatainterval[].timestamp long 时间片开始时间戳 reqtranscodingdatainterval[].taskcount int 录制路数 示例 请求路径： 请求示例 { "starttime": 1655704800, "endtime": 1655712000, "interval": 300, "domain": [ "ctyun.cn" ] } 正确响应示例 { "code": 100000, "message": "success", "starttime": 1655704800, "endtime": 1655712000, "interval": 300, "reqrecorddatainterval": [ { "timestamp": 1655709000, "taskcount": 100 } ] } 错误码请参考：参数code和message含义

参数名 类型 说明 code int 状态码 message string 描述信息 starttime int 开始时间戳 endtime int 结束时间戳 interval string 时间粒度 reqscreenshotdatainterval list 每个时间间隔的截图张数 reqscreenshotdatainterval[].timestamp int 时间片开始时间戳 reqscreenshotdatainterval[].taskcount int 图片张数

参数名 类型 名称 是否必填 说明 DomainName string 域名 是 拉流域名 App string 频道名 是 Stream string 流名 是 Params object 截图参数配置 是 Params.Output object array 输出参数 是 目前只支持配置一个 Params.Output[].Format string 输出图片的封装格式 是 支持jpg、png，格式名统一小写 Params.Output[].Interval string 截图间隔时长，单位秒 否 取值范围为5至86400，默认10秒 Params.XOSAccessKey string XOS存储的访问密钥 是 长度限制为1至255个字符 Params.XOSSecretKey string XOS存储的访问密钥 是 长度限制为1至255个字符 Params.XOSBucket string XOS存储的Bucket名称 是 长度限制为1至255个字符 Params.XOSRegion string XOS存储的Region名称 是 长度限制为1至255个字符 Params.XOSEndpoint string XOS存储的服务地址，例如： 备注：完整的上传地址url由worker依据上传接口拼接合成 是 长度限制为1至255个字符 Params.SnapshotNotifyUrl string 截图文件回调通知URL 否 长度限制为1至255个字符

本文介绍鉴权的与或逻辑。 功能介绍 客户配置多种鉴权规则后，可在直播控制台自助配置多种鉴权之间的与或逻辑。其中： 与关系：配置开启多种鉴权时，如果选择【与关系】，则需要所有的鉴权功能都通过才算通过。 或关系：配置开启多种鉴权时，如果选择【或关系】，只需要其中一种鉴权功能通过就算通过。 如果客户未配置与或关系，系统默认按照【与关系】处理。 前提条件 已自助配置开启Referer防盗链、IP黑/白名单、URL鉴权、UA鉴权中的一种或多种。 操作步骤 1. 登录直播控制台。 2. 在【域名列表】页面，单击目标域名操作列中的【编辑】。 3. 单击【访问控制】。 4. 假设已开启Referer防盗链和URL鉴权。单击【鉴权逻辑】页面，选择【鉴权逻辑】。 5. 配置完成后，单击页面右下方【提交保存】。

接口功能介绍 调用本接口查询IP可用状态。 使用说明 单个用户一分钟限制调用10000次，并发不超过100 接口详情 请求方式：get 请求路径：/ip/queryipstatus 请求参数 参数 类型 名称 是否必填 说明 : vips string vip列表 是 最多支持10个ip查询，多IP使用逗号分隔。若超过限制，则只返回最前面的10个。 响应参数 参数 类型 说明 下级对象 :: code int 状态码，成功100000 message string 信息描述，成功返回success，其他返回异常信息描述 result list 节点IP地址状态列表 resultsingle 表resultsingle 参数 类型 说明 : ip string 节点ip地址 status string ip状态，normal（正常），abnormal（非正常），noctyun（非天翼云ip） 示例 请求路径： 请求示例 正常响应示例 json { "result": [ { "ip": "1.1.1.1", "status": "noctyun" }, { "ip": "2.2.2.2", "status": "noctyun" } ], "code": 100000, "message": "success" }

接口功能介绍 调用本接口查询所有的运营商信息。 使用说明 单个用户一分钟限制调用10000次，并发不超过100。 接口详情 请求方式：get 请求路径：/auxiliarytools/queryisplist 请求参数 无 响应参数 参数 类型 说明 ::: code int 状态码 message string 描述信息 result list 返回结果数组 result[].ispid int 运营商ID result[].ispcode int 运营商编码 result[].ispcnname string 运营商中文名称 result[].ispenname string 运营商英文名称 result[].ispabbr string 运营商缩写 示例 请求路径： 请求示例 正常响应示例 { "code": 100000, "message": "success", "result": [ { "ispid": 10000, "ispabbr": "CTC", "ispcode": 1, "ispenname": "DianXin", "ispcnname": "中国电信" }, { "ispid": 10001, "ispabbr": "CUC", "ispcode": 2, "ispenname": "LianTong", "ispcnname": "中国联通" }, { "ispid": 10002, "ispabbr": "CMC", "ispcode": 3, "ispenname": "YiDong", "ispcnname": "中国移动" }, { "ispid": 10003, "ispabbr": "CRC", "ispcode": 4, "ispenname": "TieTong", "ispcnname": "中国铁通" }, { "ispid": 10004, "ispabbr": "EDU", "ispcode": 5, "ispenname": "JiaoYuWang", "ispcnname": "教育网" }, { "ispid": 10005, "ispabbr": "PBS", "ispcode": 6, "ispenname": "PengBoShi", "ispcnname": "鹏博士" }, { "ispid": 10006, "ispabbr": "other", "ispcode": 100, "ispenname": "other", "ispcnname": "其他" }, { "ispid": 10007, "ispabbr": "DX", "ispcode": 7, "ispenname": "DuoXian", "ispcnname": "多线" }, { "ispid": 10008, "ispabbr": "BGP", "ispcode": 8, "ispenname": "BGP", "ispcnname": "BGP" }, { "ispid": 10009, "ispabbr": "gwbn", "ispcode": 9, "ispenname": "GreatWallBroadbandNetwork", "ispcnname": "长城宽带" }, { "ispid": 10010, "ispabbr": "cbn", "ispcode": 10, "ispenname": "ChinaBroadcastNetwork", "ispcnname": "广电网络" } ] }

请求示例 { "starttime": "1662413100", "endtime": "1662413700", "isp": [ "001" ] } 正确响应示例 { "code": 100000, "message": "success", "result": { "domains": [ "ctyun.cn;ctyun.cn1" ], "top95bandwidth": { "bandwidth": 146228751259.23, "timestamp": 1662413700 }, "topbandwidth": { "bandwidth": 146228751259.23, "timestamp": 1662413700 } } } 错误码请参考：参数code和message含义

参数名 类型 名称 是否必填 说明 TaskID string 任务ID 是 任务ID，对应任务创建时返回的ID，目前只支持单个任务

本文简述替换过期证书的操作步骤。 如果您的证书临近过期，需要您在过期前替换证书，以避免影响域名的正常访问。这时您需要参考新增证书上传新证书，并在域名列表中找到需要关联证书的域名，将新证书关联域名。等域名变为启用状态时，新证书即可生效。此时如果旧证书没有关联域名，建议您进行删除操作。

字段名称 类型 说明 code int 标识。当code100000则提交成功，其他失败 message string 当code ! 100000则查询成功，显示错误信息 data list 查询失败则空数组 data.createtime string 创建时间。时间格式："20221128 18:03:48" data.duration string 预拉取的时长，范围为分钟。取值范围 10分钟600分钟。 data.status int 状态。 1：下发成功；2：部署成功；3：执行成功；4：执行停止；1：下发失败；2：部署失败；3: 执行失败 data.taskid string 任务id data.url string url total long 总数

参数名 类型 名称 是否必填 说明 Option int 操作 是 取值说明: 1：绑定 0：解绑 domain string 域名 是 一次只能提交1个域名 appname string 频道名 否 即发布点 支持精确匹配和模糊匹配（支持字母、数字、，但不能直接传） 长度限制为128个字符 示例： 1、精确匹配频道名，示例：live 2、模糊匹配频道名，示例：live 不传或传空则绑定到域名粒度。 streamname string 流名 否 流名 支持精确匹配和模糊匹配（支持字母、数字、 ，但不能直接传 ） 长度限制为128个字符 示例： 1、精确匹配流名，示例：StreamA 2、模糊匹配，示例：StreamA 如果请求入参中有streamname时，则appname为必填。 不传或者传空则绑定到域名或者发布点粒度。 media list media:type string 模板类型 是 livetran: 直播转码 liverecord: 直播录制 livesnapshot: 直播截图 liveidentify：直播审核 media:id string 模板ID 是 已创建的回调模板ID，多个模板ID使用英文逗号分隔

接口功能介绍 支持直播转码、直播录制、直播截图和直播审核等媒体处理模板删除。 使用说明 （1）模板需在没有绑定域名的情况下才可删除。可通过“绑定/解绑媒体处理模板”接口进行模板解绑后，再进行媒体处理模板的删除。 （2）可通过“查询域名媒体处理配置”接口查询域名已绑定的模板ID或通过“查询媒体处理模板列表”接口查询账号下的模板列表。 接口详情 请求方式：POST 请求路径：/live/mediatemplate/deletemediatemplate 请求JSON参数 参数名 类型 名称 是否必填 说明 TemplateType string 模板类型 是 livetran：直播转码 liverecord：直播录制 livesnapshot：直播截图 liveidentify：直播审核 TemplateID string 模板ID 是 已创建成功的媒体处理模板ID 响应JSON参数 参数名 类型 名称 code int 状态码 message string 描述信息 示例 请求路径： 请求JSON示例 { "TemplateID": "65shhklue975easaa457", "TemplateType": "livetran" } 正常返回JSON示例 { "code": 100000, "message": "success" }

查询直播拉流配置信息。 接口功能介绍 查询直播拉流配置信息。 使用说明 本接口目前适用于设定拉流。调用本接口查询域名下设定拉流的配置信息。单个用户一分钟限制调用100次。 接口详情 请求方式：POST 请求路径：/live/preload/querypreload 请求参数 参数名 类型 名称 是否必填 说明 ::::: domain string 域名 否 querystarttime string 查询起始时间 否 时间格式："20221128 18:03:48"。对应任务的创建时间 queryendtime string 查询结束时间 否 时间格式："20221128 20:03:48"。结束时间要大于开始时间 status int 状态 否 根据状态过滤。 1：下发成功；2：部署成功；3：执行成功；4：执行停止；1：下发失败；2：部署失败；3: 执行失败 page int 页码 否 默认1 pagesize int 页长 否 默认50。最长200 taskid string 任务ID 否 当taskid有传时，其他参数不生效。taskid与querystarttime & queryendtime 需要有一个必填。 响应参数 字段名称 类型 说明 ::: code int 标识。当code100000则提交成功，其他失败 message string 当code ! 100000则查询成功，显示错误信息 data list 查询失败则空数组 data.createtime string 创建时间。时间格式："20221128 18:03:48" data.endtime string 结束时间。时间格式："20221128 20:03:48" data.starttime string 开始时间。时间格式："20221128 18:30:00" data.status int 状态。 1：下发成功；2：部署成功；3：执行成功；4：执行停止；1：下发失败；2：部署失败；3: 执行失败 data.taskid string 任务id data.url string url total long 总数 示例 请求路径：

接口功能介绍 添加直播拉流配置信息。 使用说明 拉流是将第三方直播流地址拉取到天翼云直播中心进行加速分发的过程。 本接口支持提前设定时间拉流，即指定拉流的起始时间和结束时间，在指定时间进行拉流直播。 单个用户一分钟限制调用100次。 接口详情 请求方式：POST 请求路径：/live/preload/createpreload 请求参数 参数名 类型 名称 是否必填 说明 ::::: type string 任务类型 是 可选参数为 hls或flv。 hls: http hls直播流；flv：http/flv直播流。 url string 拉流URL 是 支持hls，http/flv请求url。需要带协议头(例如 starttime string 预拉取的起始时间 是 时间格式："20190521 18:03:48"，开始时间不能小于当前时间。 endtime string 预拉取的结束时间 是 预拉取的结束时间，时间格式："20190521 18:03:48" 。endtime<当前时间或者endtimestarttime<10分钟 会返回失败。 如果有起始时间没有结束时间，一直拉取，直到任务被停止，或者超时范围内没有拉到流,回调任务停止或者任务失败 响应参数 字段名称 类型 说明 ::: code int 当code100000则提交成功，其他失败 taskid string message string 当code ! 100000时，显示错误信息 示例 请求路径：

代码 类型 名称 是否必须 说明

参数 类型 名称 是否必填 说明 name string 证书备注名 是

本文通过图文说明证书查看路径和证书详情。 功能介绍 客户完成证书新增后，可通过直播控制台界面查看已添加的证书及其详细信息，包括：证书备注名、证书通用名称、证书品牌、颁发时间、到期时间、创建时间等。 操作步骤 1. 登录直播控制台。 2. 在【证书管理】页面，可以看到证书列表，含历史添加过的所有证书。 3. 选定目标证书，在操作列单击【详情】，即可查看证书详情信息。

接口功能介绍 调用本接口查询证书详情信息。 使用说明 支持按照证书备用名或证书ID查询，若两个参数都传，以证书备用名为准 由于证书平台经历过迁移，旧平台没有证书ID的字段，因此返回参数id可能不存在 单个用户一分钟限制调用10000次，并发不超过100。 接口详情 请求方式：get 请求路径：/cert/querycertdetail 请求参数 参数 类型 名称 是否必填 说明 ::::: name string 证书备注名 否 name和id必填其中一个，若都填返回name查询结果 id Integer 证书id 否 name和id必填其中一个，若都填返回name查询结果 usagemode Integer 证书用途 否 取值范围：0（加速域名的证书和私钥），1（客户端CA链证书），2（源站CA链证书），3（CDN回源节点证书和私钥），4（加速域名的证书和私钥（国密）），其中1、2、3是双向认证场景使用的证书 响应参数 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码 100000 message String 结果简述 正确返回 returnObj Object 返回对象 returnObj error String 错误码 CDN200002 errorMessage String 错误详情 请求参数校验失败，XXX 表 returnObj 参数 参数类型 说明 示例 下级对象 result Object 证书信息 result 表 result 参数 参数类型 说明 示例 下级对象 id Integer 证书id 7034 expires Integer 证书过期时间 1914562170 issue Integer 证书颁发时间 1599202170 issuer String 证书颁发机构 Internet Widgits Pty Ltd created Integer 证书创建时间 1600877997 name String 证书备注名称 aa cn String 证书通用名称 ctyun.cn certs String 证书公钥信息 xxx key String 证书私钥信息 xxx sans Array of Strings 证书授权域名，即证书可以被哪些域名使用 ctyun.cn1 usagemode Integer 证书用途，0:加速域名的证书和私钥 1:客户端CA链证书 2:源站CA链证书 3:CDN回源节点证书和私钥 4:加速域名的证书和私钥（国密）；其中1、2、3是双向认证场景使用的证书 0

接口功能介绍 调用本接口查询某一段时间内直播推流并发数。 使用说明 单个用户一分钟限制调用10000次，并发不超过100。 可查询历史数据时间范围为最近14天。 单次可查询的时间跨度为3小时。 单次查询输入域名的个数不能超过100个。 最大返回记录50000条记录。 接口详情 请求方式：post 请求路径：/live/statistics/queryconcurrencydata 请求参数 参数 类型 名称 是否必填 说明 ::: starttime int 开始时间戳 是 起始时间，时间戳(秒) endtime int 结束时间戳 是 结束时间，时间戳(秒) interval string 时间粒度 否 时间粒度，只支持1m，默认1m domain list 域名列表 是 域名，可多个域名 app list 应用名列表 否 应用名，默认名下所有应用名，可多个应用名 stream list 流名列表 否 流名，默认名下所有流名，可多个流名 province list 省编码列表 否 省编码，默认所有省份，可多个省编码，省份及对应的省编码点击查看 isp list 运营商编码列表 否 运营商编码，默认所有运营商，可多个运营商编码，运营商及对应的运营商编码点击查看

代码 类型 名称 是否必须 说明 domain list 域名 是 appname list 应用名称 否 streamname list 流名称 否 starttime int 开始时间 是 单位：秒 endtime int 结束时间 是 单位：秒

参数名 类型 名称 是否必填 说明 domain string 域名 是 域名 TemplateType string 模板类型 是 取值：notify Page int 分页页码 否 取值范围≥1, 分页的页数,不传默认为1 PageSize int 分页大小 否 每页模板数值，不传默认为100， NotifyType string 回调类型 是 取值，可设置多个，用英文逗号（,）分隔。 0：录制回调；1：截图回调；2：审核回调；3：回调鉴权

参数名 类型 名称 code int 状态码 message string 描述信息 TotalCount int 总记录数 Result list 模板详情信息