缓存失效明细表 列名 说明 示例数据 时间 操作发生精确时间 20250702 14:25:03 Redis节点 节点IP标识 {ip}:{port} 命令 引发Miss的Redis命令，筛出非缓存友好操作（如KEYS）。 GET 未命中Key名 未被命中的关键键值 k1 db Redis数据库编号 0 客户端地址 发起请求的客户端IP+端口，可关联到具体应用服务。 {ip}:{port}

参数 参数类型 说明 示例 下级对象 total Long 总记录数 list Array of Objects 数据列表 list 表 list

分布式缓存Redis提供了实例诊断功能，可针对实例指定Redis节点或所有节点的当前运行状况发起诊断，帮助您从负载状态、存储、网络、慢日志、命令耗时等多方面评估实例的健康状况，快速定位实例的异常情况。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例管理页面。 4. 左侧菜单点击CloudDBA>实例诊断，进入实例诊断界面。 5. 点击左上角诊断对象下拉框，可选择多个指定Redis节点或全部节点。 6. 点击【开始诊断】，即可立即对选中的Redis节点对象进行诊断分析。 7. 下方的列表展示实例诊断的记录，包括诊断状态、诊断结果、诊断对象、诊断时间等信息，操作列可查看报告、删除报告。 8. 等待诊断分析完成后（可刷新实例诊断列表查看分析进度），单击操作列的【查看报告】。 诊断报告 检测项​ 检测说明 节点基本信息 诊断对象列表、节点IP、节点类型、可用区、分片名等基本信息。 负载状态 展示cpu负载状态，如诊断结果异常则提供对应操作建议。 存储 包含内存使用量、存储持久化、内部内存碎片率、缓存命中率诊断分析结果，如诊断结果异常则提供对应操作建议。 网络 提供连接数诊断分析结果，如诊断结果异常则提供对应操作建议。 慢请求 获取最近时间产生的慢日志，展示慢请求时间、慢请求耗时、慢请求详细信息等。 命令耗时统计 展示执行命令的平均耗时、执行次数、总耗时等信息。

sectiona190c750eebc7061) access客户端连接数告警 010000 该指标用于统计代理节点的已连接的客户端数。 告警阈值:8000。 主处理：检查业务请求量是否为正常业务，如果业务请求正常可以持续观察一段时间；建议：应避免连接数超过最大上限，可以根据您的实际业务情况调整。检查业务是否当前连接数量是否正常。 access qps过高告警 0100000 该指标用于统计代理节点的qps。 告警阈值：10000。 处理：检查业务请求是否为正常业务，如果业务请求正常可以持续观察一段时间。

本节介绍分布式缓存Redis管理控制台命令监控，监控指标以节点维度统计。 前提条件 已成功开通分布式缓存服务Redis实例，且实例处于运行中状态。 操作步骤 1. 登录 []( 2. 在管理控制台右上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击性能监控。 5. 选择上方的【命令监控】Tab页，选择监控时间可过滤查询该时间段内实例监控数据，默认查询最近一小时数据。 指标说明 指标名称 单位 说明 命令平均时延 μs 统计Redis命令的平均时延 命令最小时延 μs 统计Redis命令的最小时延 命令最大时延 μs 统计Redis命令的最大时延 命令请求数 count 统计Redis命令的请求数

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"orgOid":"fooId","orgName":"fooName","cpu":2,"cpuRemaining":"2.00","memory":2,"memoryRemaining":"2.00","diskSize":2,"diskRemaining":"2.00"}} 状态码 请参考 状态码 错误码 请参考 错误码

温馨提示： API可进入API调试页面，进行在线调试。

接口功能介绍 重装云电脑 接口约束 无 URI POST /v3/desktop/batch/rebuild 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopList 是 Array of Objects 云电脑列表，可设置一个或多个，最多 10 个 desktopList 表 desktopList 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID D0023101301183998 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopList":[{"desktopOid":"XXXXXXXXXXXXX6925"}]} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }}

参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID D0023101301183998

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

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

本节主要介绍如何删除实例数据 Redis管理控制台支持删除实例数据。删除实例数据操作无法撤销，且实例数据被删除后将无法恢复，请谨慎操作。 前提条件 只有当Redis实例处于“运行中”状态，才能执行此操作。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情管理。 4. 左侧菜单点击CloudDBA>Redis节点管理，进入Redis节点管理界面。 5. 在Redis节点管理界面，点击上方按钮清空实例数据，可删除实例数据。

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

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"total":1,"list":[{"resourcePackOid":"fooId","resourcePackName":"fooName","createTime":"20190909T00:00:00Z","expireTime":"20990909T00:00:00Z","cpu":1024,"cpuRemaining":"1024.00","memory":1024,"memoryRemaining":"1024.00","diskSize":1024,"diskRemaining":"1024.00","bandwidth":10,"bandwidthRemaining":1,"status":"VALID"}]}} 状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "resourcePackOid":"rspxxx", "autoPay":false, "cpuCount":20, "memorySize":40 } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "orderNo":"2099XXXXXXXXXXXXXXXX" } } 状态码 请参考 状态码 错误码 请参考 错误码

本节介绍分布式缓存服务Redis Proxy集群主备 分布式缓存Redis Proxy集群主备在使用方式上实现了简化，采用与标准主备一致的连接模式。通过代理节点实现请求的智能路由转发，自动将客户端访问分发至对应的数据分片，同时支持热点数据缓存等增强功能，帮助用户构建更高效、稳定的业务系统。 说明 Proxy集群主备目前为白名单特性，如需要使用该特性，请联系技术支持开通后使用。 架构示意图 说明 负载均衡器：采用主备高可用方式，用于接收客户端请求，Redis集群实例提供访问的IP地址和域名，即为负载均衡器地址。 Proxy：Redis集群代理服务器，负责执行路由转发、故障转移等关键任务，从而保障集群内部高可用性，简化客户端的逻辑处理。 Redis数据分片：每个数据分片均为主备双节点架构，当主节点发生故障不可用，系统将自动进行秒级切换至备节点，以保证服务的连续性。 特点 兼容标准访问模式 采用与标准主备架构一致的连接方式，具备良好的兼容性。当业务规模扩大、超出标准架构承载能力时，可便捷地将数据迁移至 Proxy 集群，显著降低业务改造成本，保障系统平滑演进与业务的持续扩展。 路由转发 Proxy维护与后端数据分片的持久连接，承担着请求的均衡分配与路由的关键角色，确保请求的高效处理和系统的稳定运行。

实例概览页面可以帮助用户直观的查看实例资源的使用情况。 包括租户的实例数和实例状态，并提供便利的统计信息，包括当前资源池的实例的内存使用量、使用率、KEY总数、QPS等。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择需要概览所在的区域 3. 点击左侧菜单的“实例概览” 4. 页面分为两个部分: 包含全局的“我的资源” 以及只有当前资源池实例的信息。

参数名称 取值范围 说明 appendfsync no,always,everysec 操作系统的fsync函数刷新缓冲区数据到磁盘。 Redis支持三种不同的调用fsync的方式： no：不调用fsync，由操作系统决定何时刷新数据到磁盘，性能最高。 always：每次写AOF文件都调用fsync，性能最差，但数据最安全。 everysec：每秒调用一次fsync。兼具数据安全和性能。 appendonly yes,no 指定是否在每次更新操作后进行日志记录（即持久化功能），Redis在默认情况下是异步的把数据写入磁盘，如果不开启，可能会在断电时导致一段时间内的数据丢失。 有以下取值供选择： yes: 开启。 no: 关闭。 hashmaxziplistentries 1~10000 当hash表中只有少量记录时，使用有利于节约内存的的数据结构来对hashes进行编码。 hashmaxziplistvalue 1~10000 当hash表中最大的取值不超过预设阈值时，使用有利于节约内存的的数据结构来对hashes进行编码。 latencymonitorthreshold 0~86400000 延时监控的采样时间阀值（最小值），单位为毫秒。 阀值设置为0：不做监控，也不采样； 阀值设置为大于0：将记录执行耗时大于阀值的操作。 可以通过LATENCY等命令获取统计数据和配置、执行采样监控 luatimelimit 100~60000 Lua脚本的最长执行时间，单位为毫秒。 maxclients 1000~50000 最大同时连接的客户端个数。 maxmemorypolicy volatilelru,allkeyslru,volatilelfu,allkeyslfu,volatilerandom,allkeysrandom,volatilettl,noeviction 在达到内存上限（maxmemory）时实例将如何选择要删除的内容。有8个取值供选择： volatilelru：根据LRU算法删除设置了过期时间的键值。 allkeyslru：根据LRU算法删除任一键值。 volatilerandom：删除设置了过期时间的随机键值。 allkeysrandom：删除一个随机键值。 volatilettl：删除即将过期的键值，即TTL值最小的键值。 noeviction：不删除任何键值，只是返回一个写错误。 volatilelfu: 根据LFU算法删除设置了过期时间的键值。 allkeyslfu: 根据LFU算法删除任一键值。 protomaxbulklen 1048576~536870912 Redis协议中的最大的请求大小，单位为字节。 listcompressdepth 0~65535 列表中两端不被压缩的节点个数，取值范围0~65535。 0：默认值，表示都不压缩。 1~65535：表示list两端各有1~65535个节点不压缩，中间的节点压缩。 replbacklogsize 16384~1073741824 用于增量同步的复制积压缓冲区大小（单位为字节）。这是一个用来在从节点断开连接时，存放从节点数据的缓冲区，当从节点重新连接时，如果丢失的数据少于缓冲区的大小，可以用缓冲区中的数据开始增量同步。 replbacklogttl 0~604800 从节点断开后，主节点释放复制积压缓冲区内存的秒数。值为0时表示永不释放复制积压缓冲区内存。 repltimeout 30~3600 主从同步超时时间，单位为秒 setmaxintsetentries 1~10000 当一个集合仅包含字符串且字符串为在64位有符号整数范围内的十进制整数时，使用有利于节约内存的的数据结构对集合进行编码。 slowloglogslowerthan 0~1000000 用于设置Redis慢查询日志的阈值，单位是微秒。 slowlogmaxlen 100~10000 慢查询记录的条数。注意慢查询记录会消耗额外的内存。可以通过执行SLOWLOG RESET命令清除慢查询记录。 timeout 0~7200 客户端空闲N秒（timeout参数的取值）后将关闭连接。当N0时，表示禁用该功能。 zsetmaxziplistentries 1~10000 有序集合中只有少量记录时，使用有利于节约内存的的数据结构对有序序列进行编码。 zsetmaxziplistvalue 1~10000 当有序集合中的最大取值不超过预设阈值时，使用有利于节约内存的的数据结构对有序集合进行编码。 isopenflashback yes,no 是否开启闪回 isopendangercmdswitch yes,no 危险命令开关 hz 1~500 设置Redis后台任务执行频率，例如清除过期键任务。取值范围为1~500，默认值为10，即每秒执行10次。 aoftimestampenabled yes,no aof记录时间戳开关 activedefrag yes,no 自动清理内存碎片开关 activedefragignorebytes 104857600~10737418240 内存碎片占用空间达到设定值的时候开始清理 activedefragthresholdlower 10~100 内存碎片率大于设定值的时候开始清理 activedefragcyclemin 1~25 内存碎片清理所占用CPU时间的比例不低于设定值(%) activedefragcyclemax 1~25 内存碎片清理所占用CPU时间的比例不高于设定值(%) autoaofrewriteminsize 67108864~34359738368 设置自动重写AOF文件的最小值。注，当前运行值随规格变化，可不用关注默认值。

分布式缓存Redis管理控制台支持用户自定义实例参数模板信息，您可以根据业务需求创建不同参数配置的自定义参数模板，并应用到目标实例。 目前已提供以下系统默认模板，您可在系统模板的基础上自定义参数模板内容： DefaultRedisOriginal4Template：适用于Redis 4.0。 DefaultRedisOriginal5Template：适用于Redis 5.0。 DefaultRedisOriginal67Template：适用于Redis 6.0 和 Redis 7.0。 操作步骤 1. 登录 Redis管理控制台。 2. 选择左侧菜单栏的“参数模板”，进入“参数模板”页面 3. 在“参数模板”>"系统默认"页面，根据引擎版本选择系统默认模板并创建为自定义模板，即可打开参数配置界面。 4. 配置好参数后，点击保存按钮，生成自定义模板参数。 5. 在“参数模板”>"自定义"页面，可查询自定义模板，如需将自定义模板应用到目标实例，可单击“应用”，选择目标实例，并保存。 模板中的配置参数说明见参数配置

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

安全使用实例密码 建议在使用rediscli 连接实例时不要在命令行中直接指定密码，因为这样会导致密码信息出现在系统日志和历史记录中，存在一定的安全隐患。相比之下，更加安全的做法是在 rediscli 连接上 Redis 实例之后，再使用 auth 命令进行身份验证。如下示例： ./rediscli p {yourport} > auth yourpassword OK 脚本建议使用交互式输入密码鉴权，或使用不同权限的用户管理与执行；脚本涉及到缓存实例连接，则采用交互式输入密码；需要自动化执行脚本，可使用其他用户管理脚本，以sudo方式授权执行。 应用程序中使用加密模块对redis密码加密配置。

参数 参数类型 说明 示例 下级对象 externalIpListString String 外网IP地址 ipListString String 客户端IP地址 macListString String MAC地址 hardwareCodeListString String 设备唯一码 routerMacListString String 限制路由器MAC地址

参数 参数类型 说明 示例 下级对象 operation Object 创建云电脑数据盘操作。可用于查询操作状态与新建数据盘ID（相关接口：查询操作列表）。 operation 表 operation

状态码 请参考 状态码 错误码 请参考 错误码

在Redis管理控制台支持缩减实例的容量，通过该操作可缩减实例的规格，以满足不同的容量需求。 说明 缩容功能目前为白名单特性，如需要使用该特性，请联系技术支持开通后使用。 前提条件 只有当分布式缓存Redis缓存实例处于“运行中”状态，才能执行此操作。 影响须知 实例执行缩容时会出现1~2次30秒内的连接闪断。 为保障缩容后的新实例能快速追平原实例的增量数据，同时规避因DNS缓存引起的数据双写，在缩容过程中，实例每个分片节点会出现1分钟内的只读状态。 缩容完成后，实例的实例ID、连接地址、数据、白名单配置以及已创建的账号密码配置等均不会改变。 操作步骤 1.登录 Redis管理控制台。 2.在管理控制台左上角选择实例所在的区域。 3.在实例列表页面选择实例，点击”更多>缩容“按钮，进入实例缩容页面。 页面参数介绍： 参数 说明 实例ID Redis实例ID。 实例名称 Redis实例名称。 实例规格 实例规格类型。 运行状态 实例的运行状态 开通时间 Redis实例开通的时间。 计费模式 包年包月或按需计费。 过期时间 包年/包月实例的到期时间，按需计费实例无到期时间。 缩容类型 支持降低规格、减少分片、减少副本数。 新分片规格 缩容后的分片容量。 分片数 缩容后的分片数（Cluster版本支持）。 变更风险检查 检查项参见下表，手动停止检查或检查结果提示异常时，如需继续执行规格变更，需要勾选“我已知晓风险”。 费用 包年包月：缩容前后价格差值；按需计费：缩容后新实例价格。 变更风险检查项： 参数 说明 非标配置 如 实例appendonly参数未设置成yes，变更有数据丢失风险等。 节点状态 实例节点状态检查，任意节点不可用 异常。 内存使用率 内存利用率检查（>90%）异常。 带宽使用率 主机带宽使用率超过100% 异常。 CPU使用率 五分钟内的节点CPU利用率检查（>90%）异常。 4.选择目标缩容规格，点击确定按钮提交订单，即可开始实例缩容。 5.缩容一般需要几分钟，缩容成功后可以在控制台看到实例规格的变更。

状态码 请参考 状态码 错误码 请参考 错误码

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

参数 是否必填 参数类型 说明 示例 下级对象 desktopList 是 Array of Objects 云电脑列表，可设置一个或多个，最多 10 个 desktopList 表 desktopList

接口功能介绍 续订资源包v3 接口约束 无 URI POST /v3/resourcePack/renew 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 resourcePackOid 是 String 资源包ID period 是 Integer 续订资源的时长（单位：月），范围限制：[1,36] autoPay 是 Boolean 是否自动支付。取值范围： false：只产生订单，不扣费。您可以登录门户，根据返回的订单号进行支付。 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 orderNo String 订单号 枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "resourcePackOid":"rspxxx", "period":1, "autoPay":false }

在创建天翼云分布式缓存Redis实例之前，您需要做一些准备工作。首先，您需要设置一个虚拟私有云（VPC），这是一个隔离的网络环境，用于托管Redis实例。接下来，您需要创建一个子网，它是VPC内部的一个子网络，用于划分不同的部分和区域。最后，您需要配置一个安全组，用于控制入站和出站的流量规则，以保证Redis实例的安全性。 每个分布式缓存Redis实例都会被部署在特定的VPC中，并与特定的子网和安全组相关联。这种方式可以让您自主配置和管理Redis实例的网络环境，并提供安全保护策略。如果您已经有了现成的VPC、子网和安全组，可以重复使用它们，无需重复创建。这样可以节省时间和资源，并确保一致性和可靠性。 所需依赖资源准备 购买分布式缓存Redis实例前需要准备以下依赖资源 VPC和子网 VPC和子网可重复使用，您也可以使用不同的VPC和子网来配置Redis实例，您可根据实际需要进行配置。在创建VPC和子网时应注意如下要求： VPC与使用的天翼云分布式缓存Redis服务应在相同的区域。 如无特殊需求，创建VPC和子网的配置参数使用默认配置即可。 创建VPC和子网的操作请参考虚拟私有云创建VPC、子网搭建私有网络 若需要在已有VPC上创建和使用新的子网，请参考虚拟私有云子网管理创建子网

接口功能介绍 退订资源包 接口约束 无 URI POST /v3/resourcePack/refund 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 100054c0416811e9a6690242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 resourcePackOid 是 String 资源包ID resourcePackOid':'rsp8qvf6t33j2yh97s3t8drc 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 orderNo String 订单号 20230928121536530480 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"resourcePackOid":"rspxx"} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"orderNo":"2099XXXXXXXXXXXXXXXX"}} 状态码 请参考 状态码

响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 orderNo String 订单号 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "name":"fooResPack", "period":1, "autoPay":false, "cpuCount":10, "memorySize":20, "diskSize":0, "diskType":"hio", "bandwidthSize":null } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "orderNo":"2099XXXXXXXXXXXXXXXX" } } 状态码 请参考 状态码 错误码 请参考 错误码