响应参数 参数名 类型 说明 ::: code int 状态码，成功时为100000 message string 描述信息，成功时为success TaskID string 任务id 示例 请求路径： 请求示例 { "App":"test", "DomainName":"ctyun.cn1", "Params":{ "XOSBucket":"test", "RecordNotifyUrl":"test", "XOSSecretKey":"test", "XOSRegion":"test", "Output":[ { "Format":"hls", "ResetTimestamps":0, "SegmentTime":"10" } ], "XOSEndpoint":"test", "XOSAccessKey":"test", "OutTimeLink":"100" }, "Stream":"test" } 正确响应示例 { "code":100000, "message":"success", "taskID":"123" } 错误码请参考: 参数code和message含义

本文通过图文说明新增证书的操作。 功能介绍 HTTPS为CDN的网络内容传输提供了更好的保障，客户端在极速访问内容的同时，可以更安全有效地浏览网站内容。HTTPS功能的具体介绍，详情请参见：HTTPS配置。本文主要指导客户如何新增证书。 配置说明 新增证书时，客户需要填写证书备注名、证书公钥以及证书私钥。其中公钥和私钥支持PEM格式。具体操作步骤如下： 1. 登录直播控制台。 2. 在【证书管理】页面，找到右上角的添加自有证书按键。 3. 单击【添加自有证书】。 4. 输入【证书备注名】、【证书公钥】和【证书私钥】。 注意 证书备注名，是指在添加自有证书时，为了方便识别和记忆，可以支持客户自定义所上传证书的名称，方便在域名配置关联证书选择时，选定正确的证书与域名进行关联。 5. 填写完成后，单击【确定】。 注意事项 请确保上传的证书还在有效期范围内。 目前只支持PEM格式，如果是其他格式，请先转换成PEM格式。

请求示例 正常响应示例 { "code": 100000, "message": "success", "perpage": 2, "totalrecords": 159, "totalpage": 80, "page": 2, "result": [ { "id": 7034, "expires": 1914562170, "issue": 1599202170, "sans": [ "ctyun.cn", "ctyun.cn1" ], "created": 1600877997, "name": "aa", "cn": "ctyun.cn2", "issuer": "Internet Widgits Pty Ltd" }, { "id": 7038, "expires": 1914487041, "issue": 1599127041, "sans": [ "ctyun.cn3", "ctyun.cn4" ], "created": 1602558244, "name": "bb", "cn": "ctyun.cn5", "issuer": "Default Company Ltd" } ] } 错误码请参考：参数code和message含义

参数 类型 名称 是否必填 说明 name string 证书备注名 是 key string 证书私钥 是 仅支持PEM格式 certs string 证书公钥 是 仅支持PEM格式 email string 用户邮箱 否

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

运营商 运营商编码（string型） 运营商编码（int型） 中国电信 001 1 中国联通 002 2 中国移动 003 3 中国铁通 004 4 教育网 005 5 鹏博士 006 6

code code含义 message示例 100000 正确返回 success 100001 认证失败 用户认证失败 100002 找不到指定路径的API 当前调用的api不存在:$ 100003 无请求指定API的权限 当前用户对api:${api}无权限 100004 调用超限 超过调用频率限制，请稍后重试 100005 请求类型错误 当前调用的api请求方式错误 100012 底层错误 请求错误，（底层返回结果）, RequestId是 100013 系统错误 系统错误, RequestId是 100014 底层超时 请求底层超时, RequestId是 200001 资源没有权限 请求参数域名校验失败，当前用户对域名%s无权限 200002 参数校验失败 请求参数校验失败，参数为必填 200003 域名和产品不匹配 域名和产品类型校验失败，产品类型{}下域名{}不存在 200003 操作失败域名 域名状态为已停用，无法进行修改 200004 未开通CDN相关产品服务调用统计分析类接口，查询失败 无法获取您已开通CDN相关产品的账号，请开通产品后再调用 200005 产品有效性校验 操作失败，当前用户未开通产品类型{}的服务 200005 操作失败非域名 操作失败，taggroup “xxx”在productcode“xxx”时，不存在 200006 查询失败 查询ark不存在，配置存在时返回

类型 描述 域名管理 包含了域名增删改查等API。 证书管理 包含了证书增删查等API。 回调配置 包含了录制截图审核等信息回调API。 直播媒体处理 包含了转码录制截图审核增删改查等API。 统计分析 包含了带宽、流量、状态码、在线人数、转码用量、录制用量、截图用量等统计分析数据查询API。 直播流管控 包含了禁播、解禁和断流等相关操作API。 预拉取服务 包含了预拉取增删改查等API。 日志下载 包含了查询下载离线日志的API。 账单服务 包含了账单、用量查询等API。

编号 字段示例 字段含义 1 36.111.140.140 用户IP 2 ctyun.cn 加速域名 3 video/xflv 文件类型 4 [20240402135946] 日志生成时间 5 GET 请求方式 6 请求URL 7 HTTP/1.1 HTTP协议 8 200 HTTP响应状态码 9 16776379 CDN节点响应大小，单位byte 10 请求头Referer的值 11 curl/7.86.0 请求头UserAgent的值

本文简述直播控制台支持对转码、录制、截图和高性能网络带宽使用量进行查询，从不同角度快速获悉业务的发展态势。 客户直播控制台支持查看直播转码、直播录制、直播截图和高性能网络的使用量。 转码 支持展示客户维度和域名维度的不同档位的转码时长。 录制 支持展示客户维度和域名维度的录制峰值。 截图 支持展示客户维度和域名维度的累计截图张数。 高性能网络 支持展示客户维度和域名维度的高性能网络带宽或流量。

统计指标 说明 热门URL 支持以流量或访问次数为展示维度，查询热门URL。 域名排行 支持以流量或访问次数为展示维度，查询TOP域名。 热门Referer 支持以流量或访问次数为展示维度，查询热门Referer。 TOP客户端IP 支持以流量或访问次数为展示维度，查询TOP的客户端IP。

批量解禁多个域名中的某个IP 1. 登录直播控制台。 2. 单击【功能配置】下方的【批量域名IP封禁】，进入【批量域名IP封禁】页面。 3. 单击页面右上方的【查询封禁IP的域名列表】，在输入框中输入要解禁的IP，并单击【查询】。 4. 勾选需要解禁的域名，并单击【解禁】，如下图所示。实现该IP在对应域名中进行解禁。 批量解禁单域名中多个IP 1. 登录直播控制台。 2. 单击【功能配置】下方的【批量域名IP封禁】，进入【批量域名IP封禁】页面。 3. 单击对应域名的IP封禁列表，如下图所示。 4. 勾选该域名中要解禁的IP，并单击【解禁】，如下图所示。对该域名中需要解禁的IP进行解禁。 查询封禁IP 直播控制台支持查询某IP在哪些域名中进行封禁。查询步骤如下： 1. 登录直播控制台。 2. 单击【功能配置】下方的【批量域名IP封禁】，进入【批量域名IP封禁】页面。 3. 单击页面右上方的【查询封禁IP的域名列表】，在输入框中输入要查询的IP，并单击【查询】。即可查询出封禁该IP的域名。

本文简述如何退订资源包。 退订说明 用户可根据需要，在符合天翼云退订规则的前提下，灵活退订资源。只要流量包用量未用尽或者有效期未到期，均可按照天翼云的退订规则完成退订操作。 退订步骤 1. 登录天翼云官网，单击右上角【我的】，进入【费用中心】。 2. 单击左侧导航栏中的【订单管理】，进入【退订管理】。 3. 勾选要退订的资源，单击【退订】，进入退订详情页面。 4. 退订前，建议查阅【退订须知】，再次确认要退订的资源信息。确认无误后，选择退订原因并勾选【我已确认本次退订金额和相关费用】，单击【退订】完成退订操作。 5. 退订后资金退回账户余额，可以通过“余额提现”进行提现，提现操作详情请参见余额提现。更多退款说明，详情请参见退款说明。 说明 天翼云同时支持批量退订资源，详情请见如下操作步骤。 勾选要批量退订的资源，单击【批量退订】，进入退订详情页面。 再次确认已选资源，确认无误后，单击【退订】完成退订操作。

标准转码规格 H264标准资费（元/分钟） H265标准资费（元/分钟） 480P（含）及以下 0.0184 0.1085 480P~720P（含） 0.0327 0.1628 720P~1080P（含） 0.0627 0.3255 1080P~2K（含） 0.13 0.7 2K~4K（含） 0.26 1.4 纯音频 0.0184 0.0184

计费说明 如果您对极速直播服务有突发带宽使用需求，您需提前至少3个工作日（重大节日或重大赛事直播的突发，包括但不限于春晚，双十一等，需要提前至少1个月）联系天翼云申请突发带宽用量。若申请成功，在双方约定的突发量级内，可确保您的服务不受影响；若申请不成功或未申请的，天翼云有权采取限流等措施来保障全网用户的稳定性，由此导致的可用性问题，天翼云不承担责任 。符合以下情况之一的都属于“突发带宽”： a.带宽计费客户：本自然月（日）带宽增量超过100Gbp，或本自然月（日）的带宽增量超出上月（日）计费带宽的30%（另有约定的，从其约定）； b.流量计费客户：本自然月带宽峰值超过10Gbps。 极速直播计费的流量比日志中记录的流量多。因为极速直播日志中记录的流量数据是应用层日志统计出的流量，但是实际网络请求中存在TCP/IP包头的消耗和TCP重传消耗，要比应用层统计到的流量高出7%~15%，因此按照业界标准，应用于账单的计费数据会比基于访客日志计算得出的计费值上浮10%。 极速直播计费按照1000进制，例如：1Gbps1000Mbps，1GB1000MB。

本文介绍HTTPS定义及配置方法。 功能介绍 HTTP协议以明文方式发送内容，不提供任何方式的数据加密。HTTPS协议是以安全为目标的HTTP通道，简单来说，HTTPS是HTTP的安全版，即将HTTP用SSL/TLS协议进行封装，HTTPS的安全基础是SSL/TLS协议。 在天翼云直播控制台开启HTTPS协议，将实现客户端和天翼云直播加速节点之间请求的HTTPS加密。如果想要实现全链路HTTPS传输，则需要在直播加速节点配置HTTPS协议回源（源站服务器需支持HTTPS协议）。 HTTPS请求的基本流程： 1. 客户端以HTTPS协议请求直播加速节点。 2. 直播加速节点将相应的SSL证书公钥发送给客户端。 3. 客户端验证对应证书公钥是否正确，如果正确则生成一个密钥，并使用公钥进行加密，再发送给直播加速节点。 4. 直播加速节点使用对应私钥进行解密，得到密钥。 5. 直播加速节点使用对应密钥对传输的数据加密。 6. 客户端使用对应密钥对直播加速节点传输的加密数据进行解密，从而获取相应数据。 注意事项 域名进行HTTPS配置前，需已在直播控制台上传域名对应的SSL证书。证书上传路径请参见：新增证书。 只有拉流域名支持配置HTTPS。 配置说明 以推拉流场景下的拉流域名为例，操作步骤如下。 1. 登录直播控制台。 2. 在域名列表页面，单击域名操作列表中的【编辑】。 3. 单击【HTTPS配置】。 4. 开启【Https开关】。 5. 选择域名对应的有效证书，并单击页面右下方的【提交保存】。 参数 说明 Https开关 停用：即关闭HTTPS。启用：即开启HTTPS，需要上传HTTPS证书。 证书备注名 选定正确的证书与所配置的域名进行关联。说明：需要先上传相关证书。 HTTPS证书上传 可单击【证书备注名】下拉框下方的【点击上传】按钮，自助添加证书。 支持的tls协议 支持自助配置tls协议。如果未配置，则默认支持所有选项中的协议。

删除加速域名 1. 域名停用后，单击【操作】列下的【更多】，可看到【删除】按钮。 2. 单击【删除】后，跳出【删除确认】框，输入需删除的域名，单击【确认删除】，即可删除域名。

本文简述消费账单支持查询的维度和查询方法。 简要说明 天翼云支持用户查询账单概览、流水账单、账单详情及导出记录，详情请见：账单概览。 账单概览 账单概览可以展示不同汇总维度下的应付金额、扣费明细等数据，每个产品只展示一条汇总数据。 流水账单 流水账单可以展示按照不同计费模式下的每一笔订单和每个计费周期维度构成的数据，根据此账单进行扣费和结算，并可导出两种格式（xlsx、csv）的账单，在“导出记录”下载。 账单详情 自定义账单可以通过多维度展示客户账单的详细信息，并可导出两种格式（xlsx、csv）的账单，在“导出记录”下载。 导出记录 用户选择导出后，可以在“导出记录”页面点击下载，也可查看已导出的全部文件记录。 查询步骤 1. 登录天翼云官网，单击右上角【我的】，再单击【费用中心】。 2. 选择左侧导航栏中【账单管理】，分别单击【账单概览】、【流水账单】、【账单详情】、【导出记录】查询不同维度的账单。

本文简述直播录制的计费规则和注意事项。 直播录制包含录制服务费和存储空间费用。直播录制费用以当月直播录制并发路数峰值为结算标准。 注意事项 录制功能默认关闭，可通过直播控制台或API开启。 开通直播录制功能前，需先开通云存储。如何开通请参见媒体存储的订购指引。 存储计费规则，请参见：媒体存储的计费项。 计费价格 计费类型 标准资费 录制路数峰值 30元/路/月。录制费用一个自然月录制并发路数峰值 x录制路数单价。 说明：一种录制格式计为一路录制流，例如：同一个流 ID 录制了 MP4 和 HLS 两种格式文件，则计为两路录制流。 计费示例 8月1日和8月2日使用了直播录制服务。8月1日将3路直播流录制成MP4格式，直播时长为300分钟；8月2日将4路直播流同时录制成MP4和FLV格式，直播时长为600分钟。 结果：8月产生的月录制服务费账单为8 × 30元/路/月240元。 计费说明 计费方式：按需计费。 计费周期：按月计费。

能否实时查询转码进度? 能否实时查询转码进度？ 用户可以通过SDK/API或者接收回调两种方式查询当前转码的进度，建议用户优先使用回调方式接收进度。 SDK/API方式，可查阅文档取得任务状态。请注意，由于频繁轮询查阅接口进度会给后台增加很大的压力，建议用户合理设置轮询时间间隔（推荐60s以上）。该接口的查询QPS限制为20次/s。 接收回调方式，可查询文档事件通知类。

一个转码作业需要多长时间? 一个转码作业需要多长时间？ 影响转码速度的原因有很多，例如输入文件的时长、分辨率以及比特率、转码模板设置等。一般的转码任务时长为输入文件时长的0.5倍到2倍之间。如果云点播后台同时收到大量转码任务，它们将按照一定的调度策略排序处理，相应的等待时间会延长，敬请谅解。您也可以通过调用查询接口的方式，了解当前转码任务的进度。详情可以查看能否实时查询转码进度。

本文介绍查看在线人数的方式。 您可以通过如下两种方式查看在线人数： 通过直播控制台查看：针对直播流为FLV或者RTMP业务时，支持在直播控制台查询域名粒度或流粒度的在线人数。 说明 一次只能查询三小时内的在线人数。 通过OpenAPI接口查询直播在线人数进行自助查看。 注意 目前只支持直播流为FLV或RTMP的在线人数统计，暂不支持HLS协议的在线人数统计。

本文简述推流失败时的可能原因及解决方案。 问题描述 添加推流域名后进行推流，但提示推流失败。 可能原因及解决方案 当直播推流失败时，可以尝试以下步骤进行排查： 1. 检查推流端。 确保推流端的网络连接正常，没有断开或丢包的情况。 检查推流端的推流设置，确保推流地址、码率、分辨率等参数正确配置。 使用其他推流工具或设备进行推流，看是否能够正常播放。 2. 检查域名解析情况。 检查推流域名是否有正确解析到天翼云提供的解析域名上。详细信息请参见：配置CNAME。 3. 检查鉴权规则。 查看推流是否存在防盗链鉴权，是否符合鉴权规则要求。 4. 检查对应推流URL是否在禁推中。 如果您有使用禁推功能，可以登录直播控制台，查询对应URL是否在禁推中。

本文介绍如何验证IP地址是否属于天翼云节点IP。 问题概述 本文主要介绍针对指定的IP，如何验证该IP是否为天翼云节点的IP地址。 验证说明 当前天翼云支持采用调用API接口方式，验证IP是否属于天翼云IP，详情请参见：查询IP地址归属详情。 示例： 请求： 返回结果：参数cdnip：返回"true"表示属于天翼云IP；"false"表示不属于天翼云IP。

本文解释增值服务计费项是否包含URL鉴权。 增值服务计费包含直播转码、直播录制、直播截图、直播审核，不包含URL鉴权。所以URL鉴权功能不计费。 URL鉴权适用场景：为保障直播资源不被非法盗用，避免产生不必要的带宽浪费，可以在主播推流或播放URL中加上鉴权信息。在主播请求直播推流或观众请求播放时，CDN会对其URL带的加密信息进行合法性判断，仅校验通过的请求会予以响应，其它非法的访问将予以拒绝，从而有效地保护直播资源。URL鉴权详细介绍请参见URL鉴权。 建议您配置URL鉴权，否则域名将存在资源被恶意下载或者非法盗用风险，您需要承担因盗用产生的相关服务费用。

本文介绍对禁推中的流如何解禁。 您可以通过以下两种方式对禁推中的流进行解禁。 直播控制台 通过直播控制台自助下发解禁任务，详细操作请参见：流管理。 OpenAPI 通过OpenAPI接口自助下发解禁任务，详细操作请参见：直播流禁推和解禁。

本文介绍查看账号欠费的步骤。 当您账户中没有余额或已产生欠费，天翼云会通过短信通知您充值。 您也可以通过如下步骤查询欠费情况。 1. 登录天翼云官网，单击右上角【我的】，再单击【费用中心】 2. 在【总览】页中的【可用额度】模块查看欠费情况。更多信息请参见：欠费说明。 为避免欠费导致的资源冻结，请及时充值以确保服务能够正常使用。

本文介绍直播录制的保持路径。 在配置直播录制模板时，您可以选择存储bucket，并自定义录制文件的存储路径。自定义存储路径支持的变量有： ${appname}指录制流的发布点。 ${streamname}指录制流的流名。 ${taskstarttime}指任务开始录制的UTC时间戳。 如果未配置该参数，则默认存储路径为： record/${appname}/${streamname}/ 配置后，录制的文件保存到对应存储空间的路径下。

本文介绍直播转码播放地址的拼接规则。 如果您已配置好直播转码，则可通过如下规则拼接转码流播放地址。 生成规则 在原始播放地址的"StreamName"字段后加上"转码模板名称"即可，如下所示： RTMP格式：rtmp://拉流域名/AppName/StreamName转码模板名称 HLS格式：http(s)://拉流域名/AppName/StreamName转码模板名称.m3u8 FLV格式：http(s)://拉流域名/AppName/StreamName转码模板名称.flv 转码模板名称可登录直播控制台，单击【功能配置】下方的【直播转码】进行查看，如下图所示。 示例 以拉流域名为"pull.ctyun.cn"、AppName为"live"、StreamName为"ctyun1"、转码模板名称为"sd265"为例，转码的播放地址为： RTMP格式：rtmp://pull.ctyun.cn/live/ctyun1sd265 HLS格式：http(s)://pull.ctyun.cn/live/ctyun1sd265.m3u8 FLV格式：http(s)://pull.ctyun.cn/live/ctyun1sd265.flv

本文介绍直播截图支持的格式。 目前直播截图支持JPG和PNG格式。 说明 一个直播截图模板，只支持配置一种截图格式。

本文介绍验证Referer防盗链生效的方式。 按照以下步骤验证Referer防盗链是否生效： 1. 配置Referer防盗链：在直播控制台域名配置中，设置Referer防盗链规则，指定允许访问或不允许访问资源的Referer来源。如何配置请参见：Referer防盗链。 2. 使用其他网站测试：选择一个不在允许列表中的网站，将该网站上的资源链接引用到您的网站上。 3. 检查资源访问情况：在您的网站上访问包含引用链接的页面，并观察资源加载情况。如果Referer防盗链生效，资源应该无法加载或显示错误信息。 4. 查看请求头信息：使用开发者工具或网络抓包工具，查看请求头中的Referer字段。如果Referer防盗链生效，请求头中的Referer字段应该显示为您的网站地址或允许列表中的地址。

本文简要分析HTTPS播放不成功的可能原因。 背景说明 在天翼云直播控制台新增域名并切换到直播节点后，HTTP请求访问正常，HTTPS请求访问失败。本文介绍可能的原因及解决方案。 可能原因 1. 未在直播控制台开启HTTPS功能。 2. 在直播控制台配置的证书过期，或证书不匹配、证书错误。 解决方案 1. 登录直播控制台，单击左侧导航栏【域名管理】【域名列表】选择对应域名，查看【HTTPS配置】是否启用。如未启用，请开启HTTPS功能，相关操作说明，详情请见：HTTPS配置。 2. 如有启用HTTPS，则检查配置证书是否过期，或证书不匹配、证书错误。如为上述情况，则替换为新证书、正确证书即可。具体操作为：在【域名管理】【域名列表】选择对应域名，在【HTTPS配置】中，【证书备注名】，【点击上传】，上传新证书后，选择新证书备注名，单击【提交保存】即可。