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

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

参数 参数类型 说明 示例 下级对象 vpcOid String VPC ID vpcName String VPC名称 subnetList Array of Objects 子网列表 subnetList 表 subnetList

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

接口功能介绍 创建NAT网关v3 接口约束 无 URI POST /v3/nat/create 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 resourcePackOid 是 String 资源包ID name 是 String NAT网关名称（不能超过64个字符） vpcOid 是 String VPC ID subnetOid 是 String 子网ID spec 是 String 规格（LITTLE小型;LARGE大型） description 是 String NAT网关描述（不能超过250个字符"） 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 operationId String 创建NAT网关操作ID，可用于查询操作状态（相关接口：异步操作查询操作详情）。

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

本页主要介绍备份恢复相关openAPIv1接口下线的原因、影响和建议。 原因 由于旧版本的备份恢复架构不能适应组件发展，且在功能使用方面有一定的局限性。天翼云决定于2024年1月17日起更新II类型资源池的备份恢复列表接口。以v2接口替换具体的接口调用可参考"建议”。 影响 下线接口范围：下线旧的备份恢复openAPI接口（II类型资源池备份v1的13个接口）。 涉及资源池：西南1、南宁23、长沙42、华北2、南昌5、青岛20、上海36、湖南永州一城一池1、华南2、华东1、太原4等II类型资源池。 建议 为满足用户业务适配需求，目前西南1资源池已是最新版的备份恢复接口，请提前适配并安排好业务切换。 新版本的API接口地址：< （II类型资源池备份v2） 获取备份配置列表 getBackupConfigList 查询RDS实例备份设置 getBackupConfig 获取备份任务列表 getBackupList 删除数据备份文件 deleteBackupFile 创建备份集 createManualBackup 修改备份设置 updateBackupConfig 获取备份任务信息 getBackup 终止备份集 cancelBackup 获取对象存储下载链接 getZosObjDownloadLink 创建恢复任务 createNewRecoveryJob 获取可恢复时间点 getRecoverableTimeRange 获取实例所有非系统schema和对应table的集合 getSchemaTablesByProdId 获取恢复记录 getBrRecoveryRecordList 获取实例所有非系统schema getSchemaByProdId 获取可恢复的实例 getListToBeRecovery 获取恢复预检查详情 getBrRecoveryRecordDetail

本文介绍Redis如何配置安全组 客户端只能部署在与Redis缓存实例处于相同虚拟私有云（VPC）和相同子网的弹性云主机（CTECS）上。 除了CTECS、Redis缓存实例必须处于相同VPC之外，还需要他们的安全组分别配置了正确的规则，客户端才能访问Redis缓存实例。 如果CTECS、Redis缓存实例配置相同的安全组，安全组创建后，默认包含组内网络访问不受限制的规则。 如果CTECS、Redis缓存实例配置了不同安全组，可参考如下配置方式： 说明： 假设CTECS、Redis缓存实例分别配置了安全组：sgsCTECS、sgsDCS。 以Redis访问端口33016为例，其它实例请以实际情况为准。 以下规则，远端可使用安全组，也可以使用具体的IP地址。 配置CTECS所在安全组。CTECS所在安全组需要增加如下出方向规则，以保证客户端能正常访问Redis缓存实例。如果出方向规则不受限，则不用添加。 配置Redis缓存实例所在安全组。Redis实例所在安全组需要增加如下入方向规则，以保证能被客户端访问。

本文介绍如何使用telnet命令检测Redis端口连通性 ECS实例中已经安装了Telnet（Linux）或开启了Telnet客户端（Windows）。如果Redis服务出现了连接问题，并且参见上述问题中如何检测弹性云主机与Redis之间的网络连接。发现连接成功时，您需要进一步使用telnet命令检测服务端口是否可用。 查看Redis实例的连接地址，详情请参见查看连接地址。 登录ECS实例，执行telnet命令。 telnet {IP} {Redis PORT} 说明 windows系统和Linux系统中都可以使用该命令。 返回信息分析： 如果Redis连接存在问题，但可以在ECS上使用telnet连接到Redis实例，则ECS本身与Redis之间的连接无异常，请排查其它因素，例如客户端、业务代码，以及业务环境导致的Redis服务阻塞等问题。 如果telnet连接失败，但使用ping命令检测ECS与Redis之间的连接成功，可能是由于ECS存在异常行为（例如受恶意程序影响而攻击其它Redis的33016端口等）被系统禁止了部分服务，此时建议您监控ECS的数据找到异常流量并加以处理。

参数 参数类型 说明 示例 下级对象 diskType String 磁盘类型。枚举值范围：hio高IO;uhio超高IO。 uhio description String 磁盘类型描述。

如何监控是否存在内存碎片？ Redis是内存数据库，内存利用率的高低关系到redis运行效率，为了能监控到实时的内存使用情况，redis提供了info memory命令，可以查询内存的使用情况，其中memfragmentationratio指标展示的就是内存碎片率，这个内存碎片率是usedmemoryrss和usedmemory相除的结果，其中一个用户实际使用的内存大小，另一个是已经分配的内存大小。 您还可以在控制台的指标监控中查询内存碎片率指标，可以支持查询历史内存碎片率，并设置针对内存碎片率的告警，具体请查看告警配置。 如何进行告警配置？ 分布式缓存Redis管理控制台支持监控告警功能，您需要登录控制台，在实例管理告警管理页面设置通知组、通知策略以及配置对应的告警规则，具体请查看告警配置。 告警是否支持短信、邮件通知？ 分布式缓存Redis支持告警信息以短信、邮件的形式通知，您需要登录控制台实例管理告警管理页面设置通知组、通知策略以及配置对应的告警规则。具体请查看告警配置。 当前支持哪些告警指标？ 目前支持以下告警指标阈值设置： 指标名称 取值范围 说明 redis客户端连接数过高告警 010000 该指标用于统计redis的已连接的客户端数 redis缓存命中率低 0100% 该指标用于统计Redis的缓存命中率，其命中率算法为：keyspacehits/(keyspacehits+keyspacemisses)单位：%。 redis等待阻塞命令的客户端数告警 010000 该指标用于被阻塞操作挂起的客户端的数量。阻塞操作如BLPOP，BRPOP，BRPOPLPUSH。 redis内存使用率告警 0100% 该指标用于统计redis实例当前分片的内存使用情况。 redis cpu使用率告警 0100% 该指标用于统计redis实例当前分片的cpu使用情况。 access客户端连接数告警 010000 该指标用于统计代理节点的已连接的客户端数 access qps过高告警 0100000（单个代理节点） 该指标用于统计代理节点的qps

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

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "natOid":"xxxxxxxxx", "fipOidList":["xxxxxxxxx"], "type":"SUBNET", "subnetOid":"xxxxxxx", "description":"SNAT规则示例描述" } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 natOid 是 String NAT网关ID dnatOid 是 String DNAT规则ID

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx natOid 是 String NAT网关ID floatingIpAddress 否 String 弹性IP privateIpAddress 否 String 私网IP pageNum 否 Integer 页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认10

参数 是否必填 参数类型 说明 示例 下级对象 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":{ } } 状态码 请参考 状态码 错误码 请参考 错误码