枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "vpcOid":"XXXXXXXXXXXXX", "vpcName":"VPC示例名称", "subnetList":[{ "subnetOid":"xxxxxxx", "subnetName":"子网示例名称" }] }] } } 状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 删除NAT网关v3 接口约束 无 URI POST /v3/nat/delete 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 natOid 是 String NAT网关ID 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "natOid":"xxxxxxxxxxx" } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ } } 状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "resourcePackOid":"xxxxxxxxx", "name":"NAT网关示例名称", "vpcOid":"xxxxxxxxx", "subnetOid":"xxxxxxxxx", "spec":"LITTLE", "description":"NAT网关示例描述" } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "operationId":"joborder7211cb74fbb283e4280kf87lh1" } } 状态码 请参考 状态码 错误码 请参考 错误码

获取备份配置列表 getBackupConfigList 查询RDS实例备份设置 getBackupConfig 获取备份任务列表 getBackupList 删除数据备份文件 deleteBackupFile 创建备份集 createManualBackup 修改备份设置 updateBackupConfig 获取备份任务信息 getBackup 终止备份集 cancelBackup 获取对象存储下载链接 getZosObjDownloadLink 创建恢复任务 createNewRecoveryJob 获取可恢复时间点 getRecoverableTimeRange 获取实例所有非系统schema和对应table的集合 getSchemaTablesByProdId 获取恢复记录 getBrRecoveryRecordList 获取实例所有非系统schema getSchemaByProdId 获取可恢复的实例 getListToBeRecovery 获取恢复预检查详情 getBrRecoveryRecordDetail

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "diskType":"uhio", "description":"超高IO" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

指标名称 取值范围 说明 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

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":[{ "securityGroupOid":"sg41f5rni5zu4oufa85xwob", "securityGroupName":"securityapitestupdate", "osSecurityGroupName":null, "foreignGroupId":"75452c2f4ae549feb0975aed8a76117f", "isRelStrategy":null, "remark":"qqq", "strategynetworkDTOList":[{ "direction":15, "ipAddressField":"0.0.0.0/0", "protocolType":"10", "portRange":"ALL", "authPolicy":10, "securityGroupOid":"sg41f5rni5zu4oufa85xwob" }] }] } 状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 创建SNAT规则v3 接口约束 无 URI POST /v3/snat/create 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 natOid 是 String NAT网关ID fipOidList 是 Array of Strings 弹性IP ID列表 type 是 String SNAT规则类型（SUBNET子网; CIDR自定义网段） subnetOid 否 String 子网ID，只能在未设置SNAT规则的子网下创建SNAT规则，typeSUBNET时必传 cidr 否 String 网段，typeCIDR时必传 XXX.XXX.XXX.XXX/XX description 是 String SNAT规则描述（不能超过250个字符"） 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj

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

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

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

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

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

本页主要首先介绍备份恢复相关openAPIv1接口下线和旧版本的备份架构升级的原因、影响和建议。 原因 由于旧版本的备份恢复架构不能适应组件发展，且在功能使用方面有一定的局限性。天翼云决定于2024年8月5日起更新I 类型资源池的备份恢复列表接口，以v2接口替换具体的接口调用可参考"建议”。同时也将对旧的备份恢复架构进行升级。 影响 下线接口范围：下线旧的备份恢复openAPI接口（I 类型资源池备份v1的13个接口）。 恢复时间点功能：升级后，新的备份文件继续支持恢复到时间点功能，但不支持将升级前的备份文件恢复到时间点。 注意 备份策略：升级后，新的备份策略为默认保留3天，可能部分用户的备份文件会按照新的备份策略被清理掉，敬请谅解，如有问题可提单咨询。 涉及资源池：北京5、晋中、辽阳1、内蒙古6、石家庄20、雄安2、杭州2、合肥2、九江、南京3、上海7等I 类型资源池。 注：涉及的资源池将分批下线，届时可能存在部分资源池依然沿用旧接口，将会在8月底之前全部更新完毕，敬请谅解！ 建议 请用户确认升级后的备份策略保留天数是否符合业务预期，有问题可以提单咨询。 新版本的API接口地址可参见API使用说明，其中I 类型资源池备份恢复模块已替换为v2接口。

参数 是否必填 参数类型 说明 示例 下级对象 volumeOid 是 String 云硬盘ID

接口功能介绍 修改安全组规则v3 接口约束 无 URI POST /v3/securityGroup/rule/update 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 securityGroupOid 是 String 安全组ID securityGroupName 是 String 安全组名称 remark 否 String 安全组备注 strategynetworkDTOList 否 Array of Objects 该安全组下全量规则信息，需要传所有安全组规则参数 strategynetworkDTOList 表 strategynetworkDTOList 参数 是否必填 参数类型 说明 示例 下级对象 direction 是 Integer 规则方向。[入方向：15，出方向：10] ipAddressField 是 String IP地址 protocolType 是 String 端口协议。[10：自定义TCP，15：自定义UDP，20：全部ICMP，25：GRE，30：全部TCP非自定义，35：全部UDP非自定义，99：全部放通] portRange 是 String 端口范围，例如 20000,20006，如果是全部端口则填 ALL authPolicy 是 Integer 规则类型。[拒绝：15，允许：10]

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

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

异步删除命令 新增UNLINK命令，功能与DEL命令一样，但是异步而非阻塞命令。 同时 ‘FLUSHDB’ and ‘FLUSHALL’ 命令也增加了‘ASYNC’的参数，可以达到异步非阻塞的效果。 交换数据库命令 新增SWAPDB命令，可以让不同数据库的编号交换，比如执行SWAP 0 1 , 即让原来的数据库0变成1， 1变成0

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

本文介绍解决Lettuce 6.x版本客户端鉴权错误问题 使用Lettuce 6.x版本客户端，连接redis 2.8/4.0/5.0集群实例时，会报错"NOAUTH Authentication required"。 原因是Lettuce 6.x版本开始，使用RESP3（Redis 6.x引入）的HELLO命令进行版本自适应判断，但是对于不支持HELLO命令的低版本实例，兼容性存在一定问题。所以对于低版本的实例，建议直接在Lettuce中指定使用RESP2协议（兼容Redis 4/5）的版本来使用。 在客户端连接代码添加指定RESP2协议访问Redis即可解决： @Configuration public class SpringConfig implements LettuceClientConfigurationBuilderCustomizer { @Override public void customize(LettuceClientConfiguration.LettuceClientConfigurationBuilder clientConfigurationBuilder) { // manually specifying RESP2 clientConfigurationBuilder.clientOptions(ClientOptions.builder() .protocolVersion(ProtocolVersion.RESP2) .build()); } }

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "desktopOid":"xxxxxxxxxxxxxxxx6529", "subnetOid":"snxxx", "portNickname":"portNicknameTest", "privateIpAddress":"xxx.xxx.xxx.xxx" } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "operationId":"jobtaskabc7211cb74fbb283e42809d2c" } } 状态码 请参考 状态码 错误码 请参考 错误码

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

参数 是否必填 参数类型 说明 示例 下级对象 portOid 是 String 网卡ID

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

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

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

参数 参数类型 说明 示例 下级对象 securityGroupInfoList Array of Objects 桌面已绑定安全组信息 securityGroupInfoList 表 securityGroupInfoList

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "portList":[{ "portOid":"portggpgxz5n5nhmro3fw34jg", "portName":"portvpcId17265vm13213951745480811629master", "portNickName":"portvpcId17265vm13213951745480811629master", "ipAddress":"192.168.0.43", "subnetName":"子网1" }], "securityGroupList":[{ "securityGroupOid":"sg774amh5cwx61fw8rfv7c1", "securityGroupName":"securityapitest" }], "portSgList":[{ "portOid":"portggpgxz5n5nhmro3fw34jg", "securityGroupOid":"sgdes9ihmdrpas8pdge4e4l" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "snatOid":"XXXXXXXXXXXXX", "fipOidList":["XXXXXXXXXXXXX"], "floatingIpAddressList":["XXX.XXX.XXX.XXX"], "subnetOid":"XXXXXXXXXXXXX", "subnetName":"子网示例名称", "cidr":"XXX.XXX.XXX.XXX/XX", "description":"SNAT规则示例描述", "status":"ACTIVE", "createTime":"20990909T00:00:00Z" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

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

接口功能介绍 可用于查询异步操作执行状态及其他相关属性。 用例：使用创建云电脑接口返回的操作ID，查询创建操作的执行状态，以及新创建云电脑的ID。 接口约束 无 URI GET /v3/operation/describe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx version 否 String 操作ID版本。默认值：v1。可能值： v1 v2 区分版本方式：有关联操作类型的是v1，没有关联操作类型的是v2。 v2 type 否 String 操作类型。当version是v1时必须指定。可能值： Common：通用型。 Task：任务型。 Task operationIds 是 String 操作ID。取值由至少1个操作ID组成一个JSON数组ID之间用半角逗号（,）隔开。version是v1时，最多支持指定50个操作ID；version是v2时，最多支持1个操作ID。 [fooId1, fooId2] 请求参数 请求头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 参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 fooId type String 操作类型。仅当version是v1时有意义。可能值： Common：通用型。 Task：任务型。 Task status String 操作状态。可能值： Succeeded：成功。 Failed：失败。 Canceled：已取消。 InProgress：进行中。 Succeeded startTime String 操作开始时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20990909T00:00:00Z endTime String 操作结束时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20990909T00:00:00Z properties Object 附加属性。仅当操作成功时返回。 properties 表 properties 参数 参数类型 说明 示例 下级对象 resourceId String 资源ID。操作关联的资源ID。例如，创建云电脑的操作成功时，为新创建云电脑的ID。 fooId