本节主要介绍如何查询Redis慢日志 Redis的慢日志是一种用于记录执行时间超过指定阈值的命令的功能。当Redis执行的命令的执行时间超过预设的时间限制时，慢日志会将这些命令的相关信息记录下来，以便后续分析和性能优化。管理控制台提供查询Redis慢日志功能，可查询当前慢日志与历史慢日志。 查询结果中涉及到的慢语句命令详情，请前往Redis官方网站查看。 说明 可通过修改slowloglogslowerthan参数来修改慢日志阈值，参考 前提条件 已成功开通分布式缓存Redis缓存实例，且实例处于运行中状态。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击CloudDBA>慢查询，进入慢日志查询页面。 5. 点击慢日志，选择具体Redis节点，即可查看慢日志记录。 6. 点击 清除日志 可清除当前慢日志记录。 7. 点击下载日志，选择Redis节点，可下载慢日志到本地。 8. 点击历史慢日志，选择Redis节点，选择时间段，可查询历史慢日志。 9. 点击下载日志，选择日期和Redis节点，可下载历史慢日志到本地。下载日志仅支持下载最近7天中的其中1天。

分布式缓存支持分析实例中的占用空间较大的大key和访问频率较高的热key。 说明 大key和热key分析需要消耗CPU资源，建议在业务低峰时段执行大Key和热Key分析。 前提条件 已成功开通分布式缓存服务Redis实例，且实例处于运行中状态。 进行热key分析时，需 在实例配置中，将maxmemorypolicy修改成volatilelfu，参考修改修改实例配置参数。 大key和热key的定义 参数 说明 大Key Redis中存储的value可以分为两类，一类是String类型的元素，一类是集合元素，根据这两类，通过大Key可分为以下两种情况： String类型的value，值超过1 MB 集合类型的value，成员数超过3000 热Key 热Key是指在一段时间内，某个Key的访问量显著高于其他Key，形成访问热点。 例如：实例每秒处理请求10000次，而其中某一个Key的访问量达到每秒3000次。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击CloudDBA>TOP KEY分析，进入TOP KEY分析界面。 5. 点击实时Tab页，点击立即分析，即可立即分析展示大key和热key的分析结果。 6. 点击历史Tab页，勾选TOP KEY自动扫描，可搜索历史的大key和热key。 注意 勾选TOP KEY自动扫描对业务量大的场景可能会有性能影响。

SDK使用规范 规范 规范说明 等级 备注 使用连接池+长连接 短连接性能差，建议使用连接池+长连接，可以有效控制连接，同时提高效率 建议 推荐使用JedisPool或者JedisCluster连接实例。 避免使用Lettuce客户端 Jedis客户端在面对连接异常，网络抖动等场景下的异常处理和检测能力明显强于Lettuce，可靠性更强 建议 建议使用Jedis 客户端需要对可能的故障和慢请求做容错处理 由于Redis服务可能因网络波动或基础设置故障的影响，引发主备切换、命令超时或慢请求等现象，需要在客户端内设计合理的容错重试机制 强制 合理设置重试时间和次数 根据业务要求合理设置容错处理的重试时间和次数，避免不合适的设置导致对服务的可用性收到影响 强制 如果超时重试时间设置的非常短，可能引发重试风暴，极易引发业务层雪崩 如果重试时间设置得较长或者重试次数设置得较大，则可能导致在主备倒换情况下业务恢复较慢 运维管理规范 规范 规范说明 等级 备注 开启密码登录 生产环境需要开启Redis密码登录验证 强制 验证业务的故障处理能力或容灾逻辑 在测试环境或者预生产环境中组织演练，验证在Redis主备切换、宕机或者扩缩容场景下业务的可靠性 建议 监控实践 关注Redis负载，在过载前提前扩容 强制 根据告警基线配置告警：配置节点cpu、内存、带宽等告警 检查各个节点的内存使用率 例行检查各个节点的内存使用率，查看主节点内存使用率是否有不均衡的状态 建议 内存使用率不均衡说明存在大Key问题，需要进行大Key拆分及优化 开启热Key分析 开启热Key例行分析，并分析是否有Key频繁调用 建议 Redis慢日志 例行巡检Redis慢日志命令 建议 分析慢日志，并尽快从业务上进行修复

Jedis的连接方式 Java 客户端Jedis支持基于Senitnel的方式连接， 本示例以Jedis的5.2.0版本为例： plaintext String url ""; String password ""; try (JedisSentinelPool pool new JedisSentinelPool("test", Collections.singleton(url), password, password)) { try (Jedis jedis pool.getResource()) { jedis.set("1", "example"); } } catch (Exception e) { e.printStackTrace(); }

Redis实例是否支持版本升级，如Redis 4.0升级到Redis 5.0？ 目前暂不支持跨版本升级 实例规格变更是否需要关闭或重启实例？ 当实例处于运行中的状态，即可进行规格变更，不会进行实例资源的关闭、重启操作。 Redis实例类型变更失败的原因 当Redis实例处于运行中状态才可执行实例类型变更操作，请检查是否有其他任务正在执行，如扩容、删除、重启等操作。如有其他任务执行，请稍后重试。 Redis集群实例如何内存不变，只扩分片数？ 目前仅cluster单机、cluster主备可支持只扩分片数，不变更内存；其余架构暂不支持只修改分片数量。 集群实例是否支持单分片扩容？ 目前仅cluster单机、cluster主备可支持对单分片容量扩容；其余架构暂不支持针对单分片容量扩容，仅支持对整个集群进行扩容，如需对集群进行扩容，请参考实例生命周期管理扩容 在维护时间窗内对实例进行扩容或类型变更是否有业务中断？ 若在维护时间内进行扩容，可能会造成短时间的业务中断。 Cluster集群实例进行规格扩容后，Lettuce客户端连接异常问题 在实例扩容后分片数有变化，槽位（Slot）会发生变化，部分槽位迁移到新分片上， 使用lettuce客户端连接Cluster实例，客户端访问新分片时会出现 Connection to xxx not allowed. 问题 详情可参考Lettuce社区。 解决方案：开启Cluster集群自动刷新拓扑配置。 ClusterTopologyRefreshOptions topologyRefreshOptions ClusterTopologyRefreshOptions.builder() // 每隔time毫秒周期性刷新 .enablePeriodicRefresh(Duration.ofMillis(time)) // MOVED重定向, ASK重定向, 重连, 未知节点(since 5.1), 槽位不在当前所有分片中(since 5.2),当出现这五种情况时会触发自适应刷新 .enableAllAdaptiveRefreshTriggers() .build();

本文介绍Cluster集群分片容量或性能已过载原因 这种情况的发生是由于Cluster集群采用分片设计理念，每个具体的Key只能分布到某一个特定的分片节点上。Key的分布过程包含以下两个步骤： CRC16算法计算槽位（Slot）： 针对Key值进行CRC16算法计算，然后对16384取模，得到对应的槽位（Slot）值。 映射到具体分片： 根据槽位（Slot）和分片的映射关系，找到Key应该属于的具体分片，然后进行存取操作。 因此，Key并不是均匀分布在实例的各个分片上，而是根据计算结果进行存取的。当存在大Key和热Key时，可能会导致某个分片的容量或性能过载，而其他分片的内存负载仍然很低，未达到容量和性能的瓶颈。这是Cluster集群中分片设计的特性，需要针对具体的分片进行优化或调整，以解决性能瓶颈问题。

本文介绍Redis实例支持的单个Key和Value数据大小限制 Key的大小上限为512M。建议key的大小不超过1KB，这样既节约存储空间，也利于Redis进行检索。 String类型的value值上限为512M。 集合、链表、哈希等key类型，单个元素的value上限为512M。事实上，集合、链表、哈希都可以看成由String类型的key按照一定的映射关系组合而成。 同时，请注意避免对大Value进行长时间高并发写入，这样会影响网络传输效率，也会增加redisserver的内部处理耗时，从而导致请求时延较大。

分布式缓存服务提供会话管理功能,支持查询当前实例的客户端连接信息,并允许主动终止(Kill)指定会话连接。 前提条件 已成功开通分布式缓存服务Redis实例，且实例处于运行中状态。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击CloudDBA>客户端会话，进入客户端会话界面，即可展示实例的客户端会话。 勾选自动刷新可自动刷新实例的客户端会话信息。 会话列表中勾选会话，然后点击kill选中会话可kill掉该会话。

参数 类型 描述 是否必须 qosName String 指定QoS策略名称。 是 list Array of string 指定存储池名称，解除该存储池内卷的默认QoS策略。 是

本节主要介绍如何使用API解除存储池关联的QoS策略。 此操作用来解除存储池关联的QoS策略。 请求语法 plaintext PUT /rest/v1/system/qos/qosName/storagepool/disass HTTP/1.1 Date: date ContentType: application/json; charsetutf8 ContentLength: length Host: ip:port Authorization: authorization { "list": [ storagepool1,storagepool2… ], } 请求参数 参数 类型 描述 是否必须 qosName String 指定QoS策略名称。 是 list Array of string 指定解除QoS策略关联的存储池名称。 是 请求示例 解除存储池关联的QoS策略。 plaintext PUT /rest/v1/system/qos/QoS6/storagepool/disass HTTP/1.1 Date: Wed, 02 Jul 2025 05:59:09 GMT ContentType: application/json; charsetutf8 Authorization: HBlock userName:signature ContentLength: 37 Host: 192.168.0.64:1443 { "list": ["default","pool1"] } 响应示例 plaintext HTTP/1.1 204 No Content xhblockrequestid: 163fc68155bc4d40bb40f0bb2f6d9a92 Connection: keepalive Date: Wed, 02 Jul 2025 05:59:09 GMT Server: HBlock

天翼AI云电脑服务协议生效，详情请参见++这里++。

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj String 返回安全组id sgdes9ihmdrpas8pdge4e4l

本文介绍Aiuse云电脑功能的常见问题 Q：如果我的企业希望体验 Aiuse 云电脑功能，应该如何开通使用？ A：感谢您对 Aiuse 云电脑的关注！目前，您可以通过发送申请邮件至 zhangyh65@chinatelecom.cn 进行开通申请，我们的专属客服人员将在收到邮件后尽快与您联系，协助完成使用资格开通。后续也将提供自助开通渠道方便使用。 开通使用后，如何获取云电脑调用工具包及开发接入指引？ 开通使用后，您可参阅++SDK 接入指南++，其中涵盖工具包下载、环境配置及完整的开发接入说明，帮助您快速完成集成。如在接入过程中遇到问题，欢迎随时联系我们的技术支持团队。 Q：目前 AccessKey 最多可以创建多少个？绑定的云电脑数量是否有上限？ A：当前每个租户最多可创建 10 个 AccessKey，每个 AccessKey 所绑定的云电脑数量不设上限。为便于统一管理及实现数据隔离，建议为不同业务场景或团队分配独立的 AccessKey，并分别绑定对应的云电脑资源。 Q：如何将 Accesskey 绑定到桌面？ A：Accesskey 的绑定操作请前往++桌面管理++页面进行配置，页面中提供了详细的操作步骤说明。如需进一步帮助，请参阅相关操作文档或联系客服人员。 Q：SDK 中输入的 desktopCode 是指什么？ A：desktopCode 是指桌面编码，用于唯一标识您的云电脑桌面实例。请注意，desktopCode 与桌面 ID 是两个不同的概念，请勿混淆，务必确认填写的是正确的桌面编码。

Q：SDK 中输入的 desktopCode 是指什么？ A：desktopCode 是指桌面编码，用于唯一标识您的云电脑桌面实例。请注意，desktopCode 与桌面 ID 是两个不同的概念，请勿混淆，务必确认填写的是正确的桌面编码。 Q：如果我的云电脑桌面处于离线状态，是否仍然可以正常使用？ A：很抱歉，桌面处于离线状态时将无法正常接收和执行指令。请您先通过云电脑客户端或官网控制台将桌面开机并确认其处于在线运行状态后，再进行相关操作。 Q：通过 SDK 发送指令后，桌面没有任何响应，应如何排查？ A：建议您按以下步骤逐一排查： 1. 确认 SDK 指令格式是否正确，参数是否完整； 2. 检查接口返回的消息体中，是否包含成功标志（successtrue）； 3. 若上述检查均无异常，请进入目标桌面，打开「应用市场」，找到并重新安装以下两个插件：clinkagent 和 AiClientTool，安装完成后再重新发送指令。 如问题仍未解决，请联系我们的技术支持团队，并提供相关日志信息以便进一步协助排查。

参数名 类型 必需 说明 apiKey string 是 控制台上的AccessKey ID apiSecret string 是 控制台上的AccessKey Secret desktopCode string 是 桌面编码，控制台可查看 serviceURL string 否 服务地址，默认

产品服务协议请查看： 产品服务协议 产品服务等级协议请查看： 产品服务等级协议

关联云电脑 AccessKey需要关联指定的云电脑范围才可使用。 1. 进入服务管理页面； 2. 在操作列点击关联云电脑； 3. 在弹窗中搜索和选择需要关联的云电脑； 4. 点击确认操作，完成绑定。 注意 目前仅支持Windows操作系统云电脑。 查看AccessKey 1. 进入服务管理页面，在列表中即可查看名称、ID、Secret和关联云电脑数量等信息； 2. 在AccessKey Secret信息列，可点击对应的按钮显示完整信息和复制信息。 禁用或启用 AccessKey 1. 进入服务管理页面； 2. 在操作列，点击禁用或启用按钮即可完成生效。 删除 AccessKey 仅在您不需要使用某个AccessKey时，才进行Key删除操作。删除操作前，请先完成禁用操作，否则删除操作按钮不可点击。 1. 进入服务管理页面； 2. 在操作列，点击删除按钮，在弹窗中二次确认完成删除操作。 注意 删除操作生效后，原AccessKey将无法恢复，请谨慎操作！ 常见问题 如果我的企业希望体验Aiuse云电脑功能，应该如何申请试用？ 当前可以向xxxx@xxx.com邮箱发发送申请，稍后将有专门的客服人员进行联系和开通试用 开通试用后，如何获取调用云电脑工具包和开发指引？

独立安全算力空间,多智能高效协同,任务一键交付 本次更新包含AIuse云电脑与Cospace，共同构成了天翼云AI云电脑的核心能力矩阵，为用户带来全新的智能办公体验。 Cospace智协空间：面向普通用户，通过自然语言交互实现跨终端远程智控。让你通过一句话命令即可跨终端远程智控云电脑，无论使用手机、平板还是电脑，都能随时随地完成文件查找、软件操作、任务执行等复杂办公需求。 AIuse云电脑：面向开发者，为开发者提供标准化SDK，支持程序化远程控制，助力AI自动化任务的高效落地。 两大功能依托天翼云强大的独立安全算力空间，构建企业级安全防护体系，让智能与安全兼得。现在就体验，开启云端智能办公新纪元! Cospace智协空间功能介绍 云电脑的桌面级智能体 CoSpace是云智助手新增的AI云电脑桌面智能体功能，作为办公场景下的全天候AI工作伙伴，主打"一句话命令、跨终端远程智控云电脑"核心能力。 对话式交互，实现系统级的桌面控制 用户无需额外下载，通过简单对话即可完成文件查找、办公软件操作、任务执行等复杂办公需求。

方式二：已有云电脑用户切换镜像 1. 登录云电脑客户端，进入云电脑桌面； 2. 进入云电脑顶部工具栏控制中心设置系统重装更换系统界面； 3. 点击“基础镜像”或“分享镜像”中，找到“CoSpace智协空间“关键词的专属镜像进行切换； 4. 完成镜像重装后即可使用。 注意 系统重装将清除安装在系统盘(C盘)的程序、数据及专线网络配置信息，请注意提前备份重要数据。 使用指引 桌面端使用 功能入口 1. 在专属镜像桌面中代开云智助手客户端，在侧边栏找到「CoSpace智协空间」入口； 2. 点击该入口后，将在当前页面内直接跳转至CoSpace功能主页面。 对话交互 1. 点击功能页面内的对话区域，可直接输入问题或指令进行问答交互； 2. 对话输入框下方默认显示三条高频预设任务，点击任意一条即可快速执行； 3. 支持手动输入自定义对话内容和智控指令。

参数 是否必填 参数类型 说明 示例 下级对象 bandwidthOid 是 String 带宽ID bwsya8ts02mjfxfxf2i000t subnetOidList 是 Array of Strings 子网ID列表，长度至少为1 snddlkbe3d868wblg7r4wx7

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"total":1,"list":[{"subnetOid":"fooId","subnetName":"fooName"}]}} 状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 查询带宽列表 接口约束 无 URI GET /v3/bandwidth/describe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 name 否 String 带宽名称 APITest pageNum 否 Integer 页码，至少1，默认1 1 pageSize 否 Integer 每页数量，最大100，默认10 10 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 total Long 总记录数 list Array of Objects 数据列表 list 表 list 参数 参数类型 说明 示例 下级对象 bandwidthOid String 带宽ID bws9561sofpjk7kh52i0038 name String 带宽名称 bandwidthaukc8xb status String 状态状态（Creating创建中;Normal正常;Deleted已删除;Changing变更中;Unhealthy异常;Frozen冻结;Deleting删除中） Creating size Integer 带宽大小（单位：Mbps） 1 vpcOid String VPC ID vpcxxdwpyq2jgc62h8fjd2e4 vpcName String VPC名称 vpcu9ck elasticIpAddress String 弹性IP地址 createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20231020T07:23:52Z expireTime String 到期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20231119T09:31:38Z

参数 是否必填 参数类型 说明 示例 下级对象 bandwidthOid 是 String 带宽ID bwlkh1f0xbikbe0tufj2tl2

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj

接口功能介绍 幂等接口，重复添加会忽略并视为添加成功。 接口约束 无 URI POST /v3/commonDesktopPool/addUsers 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 池化桌面池ID dpucod37vk0gca50kur44j4 pubUserOidList 是 Array of Strings 用户ID列表，长度限制[1,30] upglm1215fkk6v0hf8eo4il1 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxxx","pubUserOidList":["puoxxx","puoyyy"]} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }}

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

接口功能介绍 查询策略列表 接口约束 无 URI GET /v3/strategy/pageDesktopStrategy 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx orgOid 是 String 部门Oid strategyName 否 String 策略名称 isQuerySubOrg 否 Boolean 是否查询子部门策略 qosName 否 String qos名称 securityGroupName 否 String 安全组名称 pageNum 否 Integer 页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认10 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 total Long 总记录数 list Array of Objects 数据列表 list 表 list 参数 参数类型 说明 示例 下级对象 strategyOid String 策略Oid strategyName String 策略名称 qosOid String qos Oid securityGroupOid String 安全组Oid orgOid String 部门Oid

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

枚举参数 无 请求示例 请求url 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "qosOid":"sqsxxx", "qosName":"xxxx", "upBandwidth":10, "downBandwidth":50, "maxburst":100, "remark":"xxxxx" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopOid":"XXXXXXXXXXXXX6925","diskOid":"fooId","diskSize":20} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"operation":{"operationId":"32f7211cb74fbb283e42809d2c9a274b","type":"Common"}}} 状态码 请参考 状态码 错误码 请参考 错误码