参数 是否必填 参数类型 说明 示例 下级对象 cycleType 是 String 周期类型（仅创建单独付费计算增强型云电脑有效）。取值范围： Month：按月。（仅订购类型为包周期类型有效） cycleCnt 是 Integer 周期数（仅创建单独付费计算增强型云电脑有效）。取值范围： 136。（仅订购类型为包周期类型有效） autoPay 是 Boolean 是否自动支付（仅创建单独付费计算增强型云电脑有效），默认false。取值范围： true:是。（仅订购类型为包周期类型有效，需账号有足够金额） false:否。（仅订购类型为包周期类型有效） desktopOidList 是 Array of Strings 计算增强型云电脑ID列表，可设置一个或多个，最多10个。

接口功能介绍 查询SNAT规则或DNAT规则可用的弹性IP列表v3 接口约束 无 URI GET /v3/nat/availableFip 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx natOid 是 String NAT网关ID type 是 String 规则类型（SNATSNAT规则; DNATDNAT规则） 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 参数 参数类型 说明 示例 下级对象 fipOid String 弹性IP ID floatingIpAddress String 弹性IP地址

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

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

本文介绍Redis key丢失原因 通常情况下Redis不会主动丢失数据，若出现key丢失的情况，请按照以下步骤排查 1. 查看key是否过期。过期key自动清理。 2. 查看监控，确认是否会触发键逐出机制。 3. 去服务端分析info查看是否有删除key的操作。

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

响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj String 返回数据结构体。 sg41f5rni5zu4oufa85xwob 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "securityGroupOid":"sg41f5rni5zu4oufa85xwob", "securityGroupName":"securityapitest", "remark":"qqq", "strategynetworkDTOList":[{ "direction":15, "ipAddressField":"192.168.0.25/24", "protocolType":"10", "portRange":"20000,20006", "authPolicy":10 }] } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":"sg41f5rni5zu4oufa85xwob" } 状态码 请参考 状态码 错误码 请参考 错误码

对比项 Cluster集群 Proxy集群 原生兼容性 高 中 客户端兼容性 中 高 性价比 高 中 时延 低时延 中等时延 性能 高 中

参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 快照名称，只能包含汉字、数字、英文字母、中划线和下划线，长度限制116个字符 APIKZ desktopOid 是 String 云电脑ID D0023092701181644 resourcePackOid 是 String 资源包ID rsp8qvf6t33j2yh97s3t8drc type 是 String 快照类型，枚举值范围：[sys,data,all]（sys系统盘;data数据盘;all系统盘和数据盘），其中data和all是数据盘相关的快照类型，请联系客户经理开通 sys dataDiskOidList 否 Array of Strings 数据盘ID列表，长度上限是5，type为data或all时必传 null description 是 String 描述，字符数限制[0,250] API测试

本文介绍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

业务背景 在web应用中，为了应对大规模访问，必须实现应用的集群部署.要实现集群部署主要需要实现session共享机制，使得多台应用服务器之间会话统一，weblogic tomcat等多数主流web服务器都采用了session复制以及实现session的共享. 但问题是很明显的：在节点持续增多的情况下，session复制带来的性能损失会快速增加。特别是当session中保存了较大的对象，而且对象变化较快时，性能下降更加显著。这种特性使得web应用的水平扩展受到了限制。session共享的另一种思路就是把session集中起来管理，首先想到的是采用数据库来集中存储session，但数据库是文件存储相对内存慢了一个数量级，同时这势必加大数据库库系统的负担。并且session里面的数据结构是MAP类型，和分布式缓存的MAP数据结构天然匹配。 业务要求 良好的扩展性，100个节点以上web服务器； Session操作的性能能横向扩展，容量横向扩展； 共享session数据支持超时机制 需求分析 天翼云分布式缓存单分组支持1000个web服务器100个线程以上的连接池连接、后端redis存储节点支持1000个redis节点水平扩展，存储容量最大可支持500TB、支持按key设置超时时间 实现思路：通用实现思路，与web容器选型无关 1. 使用filter拦截cookie中的sessionId，通过sessionId构造新的HttpServletRequestWrapper对象，传给后面的应用； 2. 继承重构HttpServletRequestWrapper，HttpSessionWrapper类，覆盖原来和session存取相关的方法，都通过SessionService类来实现； 3. 使用HttpSessionSidWrapper实现httpsession接口，对容器的session的属性存取操作进行包装； 4. Session对象 map ，缓存中是 map ，需要把session中的object序列化成byte[] 。

参数 参数类型 说明 示例 下级对象 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 可根据业务需求设置。