本文介绍直播录制的保持路径。 在配置直播录制模板时，您可以选择存储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配置】中，【证书备注名】，【点击上传】，上传新证书后，选择新证书备注名，单击【提交保存】即可。

本文介绍播放URL中AppName和StreamName格式要求。 AppName 播放URL中的AppName支持大小写字母、数字、下划线和中划线。 StreamName 播放URL中的StreamName支持大小写字母、数字、下划线和中划线。 说明 播放URL中的AppName和StreamName通常与推流中的AppName和StreamName保持一致。

本文介绍直播流禁推的方法。 您可以通过以下两种方式实现直播流禁推： 通过直播控制台自助下发禁推任务，详细操作请参见：流管理。 通过OpenAPI接口自助下发禁推任务，详细操作请参见：直播流禁推和解禁。 注意 自助操作禁推前，需

本文介绍推流失败可能的原因和解决方案。 推流失败可能有多种原因导致，以下是一些常见的原因： 推流地址配置错误：请您确保提供并配置正确的推流地址。检查推流地址的协议、域名、端口和路径是否正确。 网络连接问题：推流过程中可能会出现网络连接问题，例如网络延迟、丢包等。请确保您的网络连接稳定，并尝试使用其他网络环境进行重推。 推流设备或软件问题：推流设备或软件可能存在问题，例如摄像头故障、编码设置错误、推流软件版本过旧等。请检查设备和软件的设置，并确保它们能够正常工作。 直播配置问题：直播配置可能存在问题，例如域名解析错误。请检查直播配置、域名解析是否正确，或通过提交工单联系天翼云客服，他们可以帮助您进一步诊断和解决问题。 直播服务异常：直播的流媒体服务器可能存在问题，例如服务器故障、负载过高等。请通过提交工单联系天翼云客服，他们可以帮助您进一步诊断和解决问题。 流在禁推列表中：如果流在禁推列表中，则也会导致推流失败。 鉴权失败：如果配置了鉴权逻辑，请确认是否由于鉴权不通过导致的推流失败。 如果您遇到推流失败的问题，建议您逐步排查以上可能的原因。如果问题依然无法解决，建议通过提交工单联系天翼云客服，他们可以帮助您进一步诊断和解决问题。

本文介绍如何查看历史推过的和正在推的流。 您可以通过两种方式查看历史推流和正在推的流。 直播控制台 可通过直播控制台的流管理模块查看，详细信息请参见：流管理。 OpenAPI 可通过OpenAPI获取对应流信息，详细信息请参见：直播实时在线流查询【新】和直播历史流查询。

参数名 类型 名称 是否必填 说明 taskid string 任务id 是 要删除的任务。

本文介绍查看消费金额的步骤。 您可以通过如下步骤查看消费金额。 1. 登录天翼云官网，单击右上角【我的】，再单击【费用中心】。 2. 单击【账单管理】下方的【流水账单】，并根据【计费模式】查看对应的消费金额。

省份 省份编码 安徽 340000 浙江 330000 上海 310000 江苏 320000 福建 350000 山东 370000 广东 440000 广西 450000 海南 460000 江西 360000 河南 410000 湖南 430000 湖北 420000 辽宁 210000 吉林 220000 黑龙江 230000 陕西 610000 甘肃 620000 青海 630000 宁夏 640000 新疆 650000 北京 110000 天津 120000 河北 130000 山西 140000 内蒙古 150000 重庆 500000 四川 510000 贵州 520000 云南 530000 西藏 540000 香港 810000 澳门 820000 台湾 710000 中国其他 0

参数 类型 名称 是否必填 说明 domain string 域名 是 app string 发布点 否 不传或传空默认返回所有 stream string 流名 否 不传或传空默认返回所有

调用示例 返回结果： { "code":100000, "TaskList":[ { "App":"test", "TaskID":"b055ff106fd64074ae43a3e99212bc33", "DomainName":"ctyun.cn", "ErrMsg":"Task scheduling exception", "CreateTime":"20220224 15:21:30", "ExtParam":{ "PullRetryTimeOut":"300", "PullRetryType":"1" }, "TaskStatus":"failed", "Template":"None", "Referrer":"openapi", "UniqName":"123", "TaskType":"liveextredirect", "UpdateTime":"20220224 15:21:30", "Worker":"unknown", "Stream":"test", "SrcUrl":"['ctyun.cn1', 'ctyun.cn2']", "DstUrl":"ctyun.cn3;ctyun.cn4" } ], "message":"success" }

本文简要说明如何在地址生成器页面生成播放/推流URL示例。 通过地址生成器页面，您可以自定义流名和发布点并生成URL示例；如果您有配置URL鉴权，还可以生成鉴权URL示例。 注意事项 如果要生成鉴权URL示例，请先配置【URL鉴权】，如何配置请参见URL鉴权。 通过地址生成器生成的鉴权URL示例，使用的MD5规则为MD5(uri&time&key)【其中"&"仅用于区分标识演示用途，实际不加入鉴权组合内】。 如果配置多个key，生成鉴权URL示例时，以第一个鉴权key为例。 如果URL鉴权设置的“时间戳类型”为“过期时间”，则地址生成器生成的鉴权URL中的time，以当前时间+1h为例。 操作步骤 1. 登录直播控制台。 2. 单击左侧菜单栏中的【地址生成器】。 3. 选择“域名类型”，并在“域名”下拉列表框中选择域名，在“AppName”和“StreamName”中分别设置发布点和流名。如下图所示。 说明 若需要生成转码后的URL，请选择“转码模板名称”。“转码模板名称”是从【功能配置】>【直播转码】处获取，例如：sd265。 若需要生成鉴权URL，请先对选择的域名配置鉴权URL。如何配置请参见 4. 单击“生成地址”，生成URL示例，如下图所示。 说明 拉流域名中，如果有配置URL鉴权，地址生成器默认对RTMP/FLV/HLS都生成鉴权URL示例。实际拉流过程中，请依据【URL鉴权】中的“鉴权范围”确定鉴权生效范围。

本文介绍HTTPS证书的管理规则，包括新增、查看、删除和替换过期证书。 概述 在证书管理模块，您可以进行新增证书、查看证书、删除证书和替换过期证书等操作，方便客户按业务的实际需求，查看对应的操作指南。 功能简介 功能 说明 新增证书 开启HTTPS协议主要涉及两个步骤：一是上传Https证书，二是打开【Https开关】。第二步客户可参考新增证书的指引完成证书上传。 查看证书 客户新增证书后，可通过直播控制台界面查看已添加的证书及其详细信息，包括：证书备注名、证书通用名称、证书品牌、颁发时间、到期时间、创建时间等。 删除证书 当证书过期或者不再使用时，可通过直播控制台删除证书。 替换过期证书 如果证书临近过期，客户需要在过期前替换证书，以避免影响域名的正常访问。

本文简要介绍如何配置HLS切片。 功能介绍 推拉流场景中进行HLS播放；或者回源拉流场景中，回客户源站协议为FLV或RTMP，但播放协议为HLS时，需配置HLS切片，实现HLS协议的直播加速。 注意事项 仅支持拉流域名配置HLS切片。 推拉流场景下，如果一个推流域名对应多个拉流域名时，则不支持自助配置。请通过提交工单联系天翼云客服。 前提条件 已添加拉流域名，详细操作请参见：添加加速域名。 操作步骤 以回源拉流场景下配置HLS切片为例，具体操作步骤如下： 1. 登录直播控制台。 2. 在【域名列表】页面，单击目标域名操作列中的【编辑】。 3. 单击【HLS切片配置】，如下图所示。 4. 单击【是否开启hls切片】开关进行启用，并配置【hls切片时长】。 5. 单击页面右下方的【提交保存】，完成配置。

本产品终端节点为：cdnapiglobal.ctapi.ctyun.cn

本文简述如何查看流粒度带宽以及推流域名的平均码率和帧率，实时感知业务运营状态。 功能说明 您可以在【统计分析】下方【流数据】中查看流粒度的带宽，以及推流的平均码率和帧率。 注意事项 支持查看的是推流域名维度的平均码率和平均帧率。 单次支持查询3小时内的数据。 查询流带宽 直播控制台支持查询流粒度的带宽数据。 1. 登录直播控制台。 2. 单击【统计分析】下方的【流数据】。 3. 单击【流带宽】，可查询流粒度的带宽数据。 查询推流码率和帧率 直播控制台支持查询推流的码率和帧率。 1. 登录直播控制台。 2. 单击【统计分析】下方的【流数据】。 3. 单击【推流码率和帧率】，可查询推流的码率和帧率信息。

统计指标 说明 带宽流量 支持按域名、加速区域、运营商、省份等维度查询流量和带宽。支持数据对比，您可以选择长度相同的任意两天的时间进行对比。 回源统计 支持按域名、加速区域等维度查询回客户源的流量和带宽。 请求数 支持按域名、加速区域、运营商、省份等维度查询用户请求数。 状态码 支持查询边缘响应状态码和回源状态码。可通过切换【所有状态码】、【2XX】、【3XX】、【4XX】、【5XX】的按钮查看不同状态码的图表。 地区运营商 支持查看区域运营商维度的峰值带宽、流量等。默认按照峰值带宽降序排列，也可单击流量、请求数后面的箭头更改为使用流量或请求数排行。 在线人数 针对直播流为FLV或者RTMP业务时，支持自助查询域名粒度或流粒度的在线人数。

功能 说明 支持在直播控制台配置转码模板并绑定到对应域名上，实现对直播流的转码及播放。 支持在直播控制台配置录制模板并绑定到对应域名上，实现对推流进行录制并将录制文件存储到媒体存储中。 支持在直播控制台配置截图模板并绑定到对应域名上，实现对直播流进行截图并将截图文件存储到媒体存储中。 支持配置录制和截图的回调地址。 支持在直播控制台批量配置封禁IP，并支持配置封禁IP时长。

本文介绍快启功能使用场景和使用方法。 功能介绍 在直播场景下，为了降低卡顿，一般会要求响应一定量的快启数据（即缓存中的部分数据）。 注意事项 配置快启后，针对直播流会有一定的延时。所以快启有效缓存时长不宜过长。 配置说明 该功能暂不支持客户自助配置，如需使用，请通过提交工单联系天翼云客服，由客服人员后台操作开启。 提交工单时，请填写快启有效缓存时长，如快启有效缓存时长6s。

本文介绍资源包退订。 如果流量包在有效期内未用尽，您可按照退款说明和资源包退订完成退订操作。

注意事项 1. 如果预付费业务退款金额计算结果<0，则不进行退款。 2. 支持多个订单同时退订，每退订一个资源计算一次退订次数。 3. 更多退订规则，详情请见：退订规则说明。

生产者 c @Service public class KafkaProducerService { private final KafkaTemplate kafkaTemplate; public KafkaProducerService(KafkaTemplate kafkaTemplate) { this.kafkaTemplate kafkaTemplate; } / 发送简单消息 / public void sendMessage(String topic, String message) { kafkaTemplate.send(topic, message); } } 消费者 监听者模式 若使用Spring kafka 的监听者模式，需要加上启动参数 c Dotel.instrumentation.springkafka.enabledfalse subscribe 模式 c @Component public class KafkaConsumerDemo { @Value("${spring.kafka.bootstrapservers:127.0.0.1:9092}") private String bootstrapServers; @Value("${demo.topic:demotopic}") private String topic; @Value("${demo.group:demogroup}") private String group; @PostConstruct public void init(){ new Thread(()>{ Properties props new Properties(); props.put(ConsumerConfig.BOOTSTRAPSERVERSCONFIG, bootstrapServers); props.put(ConsumerConfig.KEYDESERIALIZERCLASSCONFIG, StringDeserializer.class.getName()); props.put(ConsumerConfig.VALUEDESERIALIZERCLASSCONFIG, StringDeserializer.class.getName()); props.put(ConsumerConfig.GROUPIDCONFIG, group); // 消费者组ID props.put(ConsumerConfig.AUTOOFFSETRESETCONFIG, "earliest"); // 如果没有偏移量，从最早开始消费 props.put(ConsumerConfig.ENABLEAUTOCOMMITCONFIG, "true"); // 自动提交偏移量 props.put(ConsumerConfig.AUTOCOMMITINTERVALMSCONFIG, "1000"); // 自动提交间隔 // 2. 创建消费者对象 try (KafkaConsumer consumer new KafkaConsumer<>(props)) { // 3. 订阅主题 consumer.subscribe(Collections.singletonList(topic)); // 4. 持续拉取消息 while (true) { ConsumerRecords records consumer.poll(Duration.ofMillis(1000)); for (ConsumerRecord record : records) { System.out.printf("消费到消息: topic%s, partition%d, offset%d, key%s, value%s%n", record.topic(), record.partition(), record.offset(), record.key(), record.value()); } } } catch (Exception e) { e.printStackTrace(); } }).start(); } }

本章节介绍如何进行日志查看 概述 云原生网关对接天翼云日志服务（LTS）实现了访问日志采集、上报和查询能力；使用此功能前需要先开通云日志服务，同时在云原生网关控制台开启日志功能。 每个云原生网关实例在云日志服务中会创建一个日志项目，项目名称为MSEGW${网关实例名称}，项目内有一个日志单元对应访问日志，单元名称为网关实例名称，您可以在云原生网关控制台 观测分析 > 日志中心 菜单 或者在云日志服务控制台查看网关访问日志。 访问日志格式说明 网关访问日志示例 {"starttime":1725411921254,"request":{"size":335,"method":"POST","uri":"/foo/bar","headers":{"accept":"text/plain, application/json, application/+json, /","contentlength":"0","ubertraceid":"b32bce4ff1f00f7b:899a1fd65c39be02:1c3372663d9eae03:0","connection":"keepalive","useragent":"Java/1.8.0212","host":"foo.ctyun.com","contenttype":"application/json"},"url":" alb/v3.4.5","contentlength":"427","date":"Wed, 04 Sep 2024 01:05:21 GMT","connection":"close","server":"MSEGW/3.2.2","contenttype":"application/json;charsetUTF8"},"status":400},"upstream":{"upstreamaddr":"10.121.x.x:80","upstreamstatus":"400","upstreamlatency":25,"upstreamname":"fooservice"},"routeid":"ddd342a2a3f34405bb8650ad4e","routename":"testroute"} 访问日志字段说明如下 字段 说明 starttime 请求开始时间 request 请求信息 serviceid 服务id server 网关节点信息 apisixlatency 网关自身处理耗时（不包括上游服务耗时） latency 总请求耗时（网关处理耗时和上游服务耗时之和） clientip 客户端IP response 应答信息 upstream 上游信息，包括上游地址，上游返回的HTTP状态码，上游耗时；当服务访问异常时可以重点关注此字段，确认是否时上游服务出了问题。 routeid 路由id routename 路由名称

本文帮助您了解对象存储日志管理相关的概念、作用及Log文件格式。 概述 出于分析或审计等目的，用户可以开启日志管理功能。通过访问日志记录，桶的拥有者可以深入分析访问该桶的用户请求性质、类型或趋势。 当用户开启一个桶的日志记录功能后，ZOS会自动对该桶的访问请求记录日志，并生成日志文件写入用户指定的桶中，可作为桶中的对象被长期保存。同时，日志文件保存在存储桶中也会占用存储空间，即意味着将产生相应的存储费用。默认情况下，ZOS不会为用户开启日志管理功能。 日志文件信息说明 开启日志管理后生成的访问日志包含以下信息： 名称 例子 含义 ownerid testuser 源存储桶ownerid bucket sbucket 源存储桶名字 time [23/Aug/2020:10:00:42+0800] 访问时间 remoteaddr 192.168.56.xxx 请求发起的IP地址 user testuser 执行用户 requestid tx00000000000000000001c005f41cdcaa222fdefault 用于唯一标识该请求的id operation REST.GET.ACL 请求类型 oname objname 对象名字 uri GET/sbucket?aclHTTP/1.1 用户请求的uri httpstatus 200 返回的http状态码 errorcode 返回的错误码 bytessent 441 用户下载的流量 objsize 0 对象大小（bytes） totaltime 1 处理本次请求所花的时间（毫秒） referrer 请求的httpreferer useragent Boto3/1.4.6Python/2.7.5Linux/3.10.01062.el7.x8664Botocore/1.8.35 http的useragent头 oversionid 版本id 注意 Log文件的格式组成：名称从左至右，以空格分隔。 Log中的任何一个字段都可能出现“”，用于表示未知数据或对于当前请求该字段无效。

告警渠道 限额 说明 邮件 每个天翼云账号每天20封邮件通知，超出限额后停止发送 如有需求，请提交工单反馈 短信 每个天翼云账号每天20封短信通知，超出限额后停止发送 如有需求，请提交工单反馈

本文介绍日志管理的使用场景及使用方式。 使用场景 出于分析或审计等目的，用户可以开启日志管理功能。通过访问日志记录，桶的拥有者可以深入分析访问该桶的用户请求性质、类型或趋势。当用户开启一个桶的日志记录功能后，对象存储（简称ZOS）会自动对这个桶的访问请求记录日志，并生成日志文件写入用户指定的桶中。 使用方式 使用方式 参考文档 控制台 详情请参见日志管理。 API 详情请参见设置桶日志转存。

操作步骤 1. 开通云审计服务。 参见开通云审计服务云审计。 2. 查看云审计事件。 参见查看审计事件云审计。 更多云审计相关使用说明和常见问题请参考用户指南、常见问题。

参数 说明 云间高速 请选择云专线关联的云间高速实例。 云专线（CDA） 请选择需要探测的云专线实例。 云侧IP 云侧IP地址可以是任意一个没有被使用的IP地址，但不能与云间高速中要互通的IP地址冲突，也不能和云专线实例的云侧、客户侧IP地址冲突。 客户侧IP 客户侧IP地址为云专线实例中客户侧IP地址。 发包时间间隔 指定健康检查发送连续探测报文的时间间隔。单位：秒。取值范围：2~3。默认值：2。 探测报文数 指定健康检查发送连续探测报文的个数。单位：个。取值范围：3~8。默认值：8。 切换路由 是否开启健康检查的路由切换功能。默认选择开启。健康检查在探测到云专线链路故障时，如果云间高速实例中存在冗余链路，健康检查则会立即切换使用可用链路。若关闭本功能，请确保已设置其他冗余方案。否则，若物理专线链路发生故障，可能导致网络中断。

本文将为您介绍什么是弹性伸缩健康检查。 弹性伸缩服务支持健康检查功能，可保障业务由运行状态健康的云主机承载。 弹性伸缩健康检查主要包含三种健康检查方式：云主机健康检查、弹性负载均衡健康检查和不启用健康检查，使用前两种检查方式自动替换不健康实例，避免业务中断，降低服务抖动。 云主机健康检查：此类检查指的是通过对云主机实例的健康检查，将处于“异常”状态的云主机移出伸缩组，例如处于“错误”等状态的云主机将会被移出，同时伸缩组将会创建新的健康实例来替代被移出伸缩组的实例，确保满足伸缩组实例数量配置要求。此方式为弹性伸缩默认检查方式。 弹性负载均衡健康检查：此类检查方式仅当您启用负载均衡器时才可启用。当您开启负载均衡健康检查时，您可以根据弹性负载均衡对伸缩组内云主机实例内服务的端口的状态进行检查。如果您在一个伸缩组内启用了多台负载均衡器，则只有在所有负载均衡器均检测到云主机实例状态为健康的情况下，才会认为该云主机实例正常。只要有一个负载均衡器检测出云主机端口的服务状态是异常的，伸缩组都会将其移出。 不启用健康检查：关闭伸缩组健康检查，伸缩组不会获取实例健康状态信息。 云主机健康检查、弹性负载均衡健康检查两种检查方式在检测出异常云主机实例后，都会将其进行移出，但是移出之后是否删除取决于此云主机实例的加入方式与付费方式： 若此云主机实例是按需计费，则自动添加的实例在移出后会被释放，而手动添加进来的云主机实例在移出后将会继续保留。 若此云主机实例是包年包月的周期计费，则在移出后将不会被释放。 注意 若伸缩组处于停用状态，健康检查将会继续执行，但不会触发任何伸缩活动，即不会将云主机实例进行移出。