本文介绍Redis 4.0支持的新特性说明 模块 Redis 4.0.0最大的功能之一是期待已久的模块系统。模块系统提供了一个API，用于扩展Redis，主要在C中动态加载模块。模块API提供了多个级别的API，供开发人员为Redis添加新的特性和功能。 使用Redis模块，开发人员可以在现有数据类型中添加新的操作，引入新的数据类型，如JSON，或使用搜索或神经网络等新流程扩展Redis。 新的API使开发人员能够构建在使用Lua构建时不切实际或性能不足的扩展。正如Redis.io上的模块文档中所提到的，“Redis模块使使用外部模块扩展Redis功能成为可能，以与核心内部类似的速度和功能实现新的Redis命令。” 缓存优化 4.0.0版本增加了最不频繁使用（LFU）的最大内存策略，为用户提供了另一种在Redis达到最大内存阈值时驱逐KEY的算法。LFU缓存为许多应用程序提供了比最近最少使用（LRU）缓存更好的命中率。 Redis中LFU缓存的实现是通过近似算法完成的，以提供对KEY访问频率的准确估计，而不添加大量的内存开销来跟踪访问计数。与当前的LRU缓存策略一样，LFU缓存只能应用于易失性KEY（过期KEY）或所有KEY 内存相关命令 新增MEMORY命令向用户提供Redis实例的内存消耗信息。MEMORY USAGE命令为用户提供给定KEY使用的精确内存量，而MEMORY DOCTOR提供了一个框架（类似于LATENCY DOCTOR命令），用于观察实例的总体内存消耗。

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

参数 参数类型 说明 示例 下级对象 operationId String 添加计算增强型云电脑网卡操作ID，可用于查询操作状态（相关接口：异步操作查询操作详情）。

接口功能介绍 云硬盘功能请联系客户经理开通。 接口约束 无 URI GET /v3/cloudVolume/detail 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx volumeOid 是 String 云硬盘ID 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 volumeOid String 云硬盘ID XXXXXXXXXXXXX volumeName String 云硬盘名称 volumeSize Integer 云硬盘大小（单位：GB） diskType String 云硬盘类型（uhio超高IO;hio高IO;cio普通IO） forSysDisk Boolean 属性是否为系统盘，true表示为系统盘属性，false表示为数据盘属性 encryption Boolean 是否加密，true表示为加密，false表示为不加密 status String 云硬盘状态（CREATING创建中;AVAILABLE可用;INUSE使用中;MOUNTING挂载中;UNMOUNTING卸载中;EXTENDING扩容中;CREATESNAPSHOTING创建快照中;REVERTING回滚中;DELETING删除中） desktopOid String 云电脑ID resourcePackOid String 资源包ID createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。

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

参数 是否必填 参数类型 说明 示例 下级对象 desktopOidList 是 Array of Strings 云电脑ID列表，可设置一个或多个，最多10个 imageOid 是 String 镜像ID

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

接口功能介绍 幂等接口，重复解绑会忽略并视为成功。 计算增强型云电脑功能请联系客户经理开通。 接口约束 无 URI POST /v3/ecs/unbindUser 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "desktopOid":"XXXXXXXXXXXXX6925" } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ } } 状态码 请参考 状态码 错误码 请参考 错误码

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

参数 参数类型 说明 示例 下级对象 securityGroupOid String 安全组id securityGroupName String 安全组名称 表 portSgList

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

参数 参数类型 说明 示例 下级对象 operationId String 使用云硬盘快照还原云硬盘操作ID，可用于查询操作状态（相关接口：异步操作查询操作详情）。

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "operationId":"foo", "type":"Common", "status":"Succeeded", "startTime":"20990909T00:00:00Z", "endTime":"20990909T00:00:00Z", "properties":{ "resourceId":"XXXXXXXXXXXXX6925" } },{ "operationId":"bar", "type":"Common", "status":"Succeeded", "startTime":"20990909T00:00:00Z", "endTime":"20990909T00:00:00Z", "properties":{ "resourceId":"XXXXXXXXXXXXX6926" } }] } } 状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "natOid":"XXXXXXXXXXXXX", "name":"NAT网关示例名称", "vpcOid":"xxxxx", "vpcName":"VPC示例名称", "subnetName":"子网示例名称", "subnetCidr":"XXX.XXX.XXX.XXX/XX", "spec":"LITTLE", "description":"NAT网关描述", "source":"RESOURCEPACK", "status":"ACTIVE", "createTime":"20990909T00:00:00Z" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 natOid 是 String NAT网关ID name 是 String NAT网关名称（不能超过64个字符） spec 是 String 规格（LITTLE小型;LARGE大型） description 是 String NAT网关描述（不能超过250个字符"）

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

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

参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 type String 操作类型。枚举值范围：Common通用型;Task任务型。

对比项 单机/主备 Proxy集群 Cluster集群 兼容Redis版本 100%兼容开源Redis 2.8、4.0、5.0、6.0、7.0。可在购买实例时选择版本号。 兼容开源Redis2.8、4.0、5.0版本，有部分命令限制，请参考命令限制。 100%兼容开源RedisCluster 6.0/7.0版本。可在购买实例时选择版本号。 特性支持与限制 完全支持开源单机主备使用特性 Proxy集群实现架构转换，基本支持开源单机主备使用特性，但在特殊命令使用上有限制，请参考 Cluster集群完全支持开源社区RedisCluster的使用特性。业务使用RedisCluster的key需要在统一slot槽段范围内，且在使用event notify，scan、keys等命令时需要与每一分片建立连接获取请求结果。 客户端协议 使用传统Jedis客户端即可。 使用传统Jedis客户端即可，不需要支持Redis Cluster协议。 需要客户端支持Redis Cluster协议。 命令限制 不支持的Redis命令，请参考 不支持的Redis命令，请参考 Cluster集群实例100%支持开源社区集群的命令。 副本数 单机实例为单副本，只有一个节点。单副本表示实例只有主节点，无法保障数据高可靠。主备默认为双副本，默认为一主一从的架构。双副本支持高可用切换 Proxy集群单机实例为单副本，只有一个节点。Proxy集群主备默认为双副本，默认为一主一从的架构。 Cluster集群单机实例为单副本，只有一个节点。Cluster集群主备默认为双副本，默认为一主一从的架构。

本文介绍缓存实例的数据被删除找回问题 如果缓存实例执行了备份操作，实例的数据被删除后，可通过备份文件对数据进行恢复，但是恢复会覆盖备份时间到恢复这段时间的写入数据。 实例通过控制台的“备份与恢复”功能将已备份的数据恢复到缓存实例中，参考备份还原 另外，如果缓存实例被删除，实例中原有的数据将被删除，实例的备份数据也会删除，请谨慎操作。

本文介绍创建Redis自定义策略。 如果系统预置的Redis权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项请参考主子账号和IAM权限管理。 目前天翼云支持可视化视图和JSON视图两种方式设置策略内容，详细介绍请查看统一身份认证用户指南权限管理自定义策略 创建自定义策略。 可视化视图：通过可视化视图创建自定义策略，无需了解JSON语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。 JSON视图：通过JSON视图创建自定义策略，可以在选择策略模板后，根据具体需求编辑策略内容；也可以直接在编辑框内编写JSON格式的策略内容。 Redis自定义策略样例 以下策略样例表示：仅允许IAM用户使用redis启动、停止功能。 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "DCS2:inst:redisstart", "DCS2:inst:redisstop" ] } ] }

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

参数 说明 默认值 建议 maxTotal 连接池的最大连接数 8 参考下面的参数设置建议 maxIdle 连接池的最大空闲连接数 8 参考下面的参数设置建议 minIdle 连接池确保的最少空闲连接，不足的会新建连接 0 参考下面的参数设置建议 blockWhenExhausted 当连接池的连接用尽后，获取新连接是否会阻塞等待。 true: 会阻塞直到获取新连接或maxWaitMillis时间到了， 抛出异常. false: 会直接抛出异常 true 建议使用默认值 maxWaitMillis 当连接池的连接用尽后，获取连接的最大等待时间（单位毫秒），1表示一直阻塞 1 建议设置一个合理的超时时间，避免出现当连接池用尽后，应用阻塞不响应的情况 testOnBorrow 每次向连接池获取连接时是否做连接有效性检测（发送PING请求）。无效连接会被释放 false 建议使用默认值。设为true相当于在每个命令执行完前先发一个PING命令，对高并发请求大应用的性能有影响。 对于业务可用性要求比较高的场景，可以设为true，可以保证连接有效的。 testOnReturn 每次向连接池归还连接时是否做连接有效性检测（发送PING请求），无效连接会被释放 false 建议使用默认值。设为true相当于在每个命令执行完后再发一个PING命令，对高并发请求大应用的性能有影响。 lifo 连接池管理连接的方式是否使用LIFO方式 true使用LIFO（后进先出）方式 false使用FIFO（先进先出）方式 true 建议使用默认值。 fairness 并发获取连接时，是否按并发的先后顺序从连接池获取 false 建议使用默认值。 false的情况，性能更佳a jmxEnabled 是否开启jmx监控 true 建议使用默认值，同时应用也需要开启 testWhileIdle 是否检测空闲连接的有效性，无效连接会被释放 只在timeBetweenEvictionRunsMillis > 0时有效 false 建议使用true。也可使用JedisPoolConfig。 timeBetweenEvictionRunsMillis 空闲连接的检测周期（单位毫秒），1表示不开启空闲连接检测 1 建议建议设置，周期自行选择。也可使用JedisPoolConfig minEvictableIdleTimeMillis 最小空闲时间（单位毫秒）。空闲连接检测时，如果连接在最小空闲时间内都没有被获取使用,则会被释放。1表示不释放， 只在timeBetweenEvictionRunsMillis > 0有效 1800000（30分钟） 根据业务决定，一般使用默认值即可。也可使用JedisPoolConfig的配置 numTestsPerEvictionRun 检测空闲连接时，每次检测的连接数，如果为负数n，则表示检测1/n个连接 3 可根据业务需求设置。

本节介绍如何在分布式缓存管理控制台查看和管理接入机节点。 说明 读写分离，Proxy集群及经典集群实例支持接入机节点管理。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角单击，选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情管理。 4. 左侧菜单点击CloudDBA>接入机节点管理，进入接入机节点管理页面。 5. 点击节点右侧接入机配置进入配置修改页面。可修改客户端最大连接数与Redis连接数。 6. 点击批量接入机配置可修改所有接入机节点的配置。

本节主要介绍如何进行主从切换 分布式缓存Redis管理控制台支持手动切换Redis实例的主从节点，该操作用于特殊场景，例如，释放所有业务连接或终止当前正在执行的业务操作。 主从切换须知 在主备节点切换间，业务会发生少于10秒的连接闪断，因此在操作前请确保应用具备断连重建能力。 当执行主备切换时，新的主备关系同步需要消耗较多资源，因此请在业务量空闲时间段执行操作。 主备之间数据同步采用半同步机制，理论上不丢失数据。 前提条件 只有当分布式缓存Redis缓存实例处于“运行中”状态，才能执行此操作。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情管理。 4. 左侧菜单点击CloudDBA>Redis节点管理，进入Redis节点管理界面。 5. 在Redis节点管理界面，点击上方按钮“批量主从切换”，可完成所有节点的主从切换。或选择某一分片节点，单击操作栏下主从切换，点击确定后对该节点执行主从切换。

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

新建Key 在应用数据管理详情页，左侧列表上方点击【新建Key】按钮，将在右侧打开新的Table页，输入键名，选择数据类型，根据不同的类型编辑键值或新增集合元素。 删除Key 在应用数据管理详情页，左侧列表展示当前DB分组下所有key名、key类型。鼠标选中key所在行，点击表格上方【删除Key】按钮将会删除选中的key。 编辑Key 左侧列表双击选中的key后，将在右侧打开新的Table页展示所选中key的键名、数据类型、TTL （超时时间）以及键值等信息。 下方点击开始编辑后，即可对集合类型键值对数据进行新增、删除、修改等操作。

响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "operationId":"jobtask7211cb74fbb283e4280kf87dhb" } } 状态码 请参考 状态码 错误码 请参考 错误码

业务场景 在一个社交媒体平台中，我们需要实时统计用户的点赞数和在线人数。为了满足实时性和高并发的需求，我们决定使用 Redis 来实现一个实时计数器。 业务需求 实时统计用户的点赞数，以便在用户界面上显示点赞数的实时更新。 实时统计在线用户人数，以便在管理后台实时监控在线用户的数量。 需求分析 计数器需要能够实时更新，并能够处理高并发的请求。 计数器的数据需要持久化，以防止数据丢失。 实现方案 使用 Redis 的计数器功能来存储和更新点赞数和在线用户数。 使用 Redis 的键过期功能来自动清除超时的在线用户。 使用 Redis 的持久化功能，如 AOF 或 RDB，来保证数据的持久性。 使用 Redis 的事务功能来确保计数器的原子性更新。 示例代码 以下是一个简化的示例代码，展示了如何使用 Redis 实现实时计数器的关键部分： // 用户点赞操作 public void likePost(String postId, String userId) { Jedis jedis new Jedis("localhost"); jedis.incr("postlikes:" + postId); // 增加点赞数 jedis.sadd("postlikedusers:" + postId, userId); // 添加点赞用户 jedis.close(); } // 获取帖子的点赞数 public long getPostLikes(String postId) { Jedis jedis new Jedis("localhost"); long likes Long.parseLong(jedis.get("postlikes:" + postId)); jedis.close(); return likes; } // 用户上线操作 public void userOnline(String userId) { Jedis jedis new Jedis("localhost"); jedis.setex("useronline:" + userId, 300, "true"); // 设置用户在线标志，并设置过期时间为 300 秒 jedis.close(); } // 获取在线用户数 public long getOnlineUserCount() { Jedis jedis new Jedis("localhost"); long count jedis.keys("useronline:").size(); jedis.close(); return count; } 在上述示例代码中，我们使用 Redis 的计数器功能来存储点赞数，并使用 Redis 的集合数据类型来存储点赞的用户。对于在线用户数的统计，我们使用 Redis 的键过期功能来设置用户在线标志的过期时间，并使用 Redis 的键查询功能来获取在线用户数。

接口功能介绍 适用于不属于池化桌面池的云电脑。 每次切换，云电脑的系统类型、规格类型必须相同。 新旧镜像适用的系统类型与规格类型必须相同。 接口约束 无 URI POST /v3/desktop/batch/changeImage 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOidList 是 Array of Strings 云电脑ID列表，可设置一个或多个，最多10个 D0023092101180485 imageOid 是 String 镜像ID miyr404205jf6br4f1dyb03 includeDataDisk 否 Boolean 切换整机镜像时，是否包括数据盘，默认为否。 includeDataDisk 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopOidList":["D0023092101180485"],"imageOid":"miyr404205jf6br4f1dyb03","includeDataDisk":null}

本文介绍如何使用Redisdesktopmanager访问Redis实例 通过VPC子网访问 Redis。 填写连接信息： 打开 Redis Desktop Manager 并选择连接类型为 Redis。 在连接配置中，填写 DCS 实例的子网地址、端口，以及相应的密码。 测试连接： 在填写完连接信息后，单击界面左下角的“测试连接”按钮。 确认连接正常： 如果提示连接成功，说明连接已经建立成功。 操作完成。

在Redis管理控制台支持对客户端与Redis实例进行连接状态诊断。 前提条件 只有当分布式缓存Redis缓存实例处于“运行中”状态，才能执行此操作。 功能说明： 当IP地址为公网IP时，则检测是否绑定弹性IP。若IP地址在VPC网段内或为公网IP且已绑定弹性IP，并且已经配置白名单，则检测该IP地址是否已正确配置在Redis实例的白名单中。若当前IP地址检查通过，但仍无法成功连接Redis实例，可能存在如下问题： 1.网络异常:请通过PING命令测试客户端机器与Redis实例间的网络是否正常，若异常，请检查客户端所在网络环境。 2.客户端IP地址发生变化:若客户端IP地址发生变更，需要将客户端当前IP地址添加至白名单中建议对客户端设置固定IP地址，或在实例白名单中添加0.0.0.0/0，设置此白名单后，所有IP地址均可访问该实例。 3.密码错误:请检查Redis实例密码。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 在连接信息区域，点击“IPv4连接地址”右侧的连接诊断按钮即弹出连接诊断对话框。 5. 在打开的连接诊断对话框，输入需要诊断的客户端IP地址即可诊断该IP地址与Redis实例的网络连通性。