参数 是否必填 说明 apiKey 是 控制台创建的 AccessKey ID apiSecret 是 控制台创建的 AccessKey Secret desktopCode 是 云电脑桌面编码 serviceURL 否 服务地址，不传时使用 SDK 默认值

工具调用示例 移动鼠标： plaintext { "name": "movemouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300 } } 输入文本： plaintext { "name": "typetext", "arguments": { "desktopCode": "xxx", "text": "Hello from AIuse MCP" } } 创建目录： plaintext { "name": "createdirectory", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest" } } 常见问题 如果 Qoder 中没有加载出工具列表，请优先检查： 本地是否已安装 Node.js，且 npx v 可正常输出版本号。 MCP 配置中的 command、args 和 env 是否填写正确。 CTGAPIKEY 和 CTGAPISECRET 是否正确。 AccessKey 是否已关联目标云电脑。 目标云电脑是否在线。 调用工具时是否明确传入或说明了 desktopCode。 安全建议 不要将包含 AccessKey Secret 的 MCP 配置提交到公开仓库。 多人共享开发环境时，建议使用个人或项目级 AccessKey。 如 Qoder 或 MCP Client 支持密钥管理，建议优先使用密钥管理能力。 AccessKey 泄露后，应立即在控制台禁用并更换。

本节介绍FileSystem功能操作能力。 FileSystem FileSystem 是 AIuse 云电脑面向 Agent 和自动化系统提供的文件操作能力，用于在云电脑环境中读取、写入、搜索、移动和管理文件。 能力概述 FileSystem 当前规划和技术方案覆盖以下能力： 能力 说明 读取文件 支持按路径读取文件内容，可按偏移量和长度读取片段 写入文件 支持覆盖写入、追加写入和新建写入模式 创建目录 支持创建目录，并可自动补齐父目录 移动文件 支持文件或目录移动，也可用于重命名 搜索文件 支持按通配符、正则或精确文件名搜索 获取文件信息 支持获取文件大小、类型、路径等元数据 下载文件 大文件或二进制文件可通过临时地址传输，具体能力以发布版本为准 设计目标 FileSystem 能力的目标是为 Agent 提供统一、可控的文件系统语义。 典型场景 读取应用生成的日志、报表或结果文件。 将 Agent 生成的内容写入云电脑工作目录。 查找指定目录下的文件。 将文件移动到指定目录，完成任务归档。 配合 Computer Use 完成“操作软件生成文件，再读取文件内容”的闭环任务。 示例流程 1. 通过 Computer Use 操作桌面软件生成文件。 2. 使用 FileSystem 搜索输出目录。 3. 读取目标文件内容。 4. 如果文件较大，则通过临时下载地址获取文件。 5. 将结果返回业务系统或 Agent。

项目 说明 租户权限 已开通 AIuse 云电脑服务 AccessKey 已创建 AccessKey ID 和 AccessKey Secret 云电脑资源 已准备可用云电脑，并获取桌面编码 desktopCode 运行环境 Node.js 18 或以上版本，建议使用维护期内 LTS 版本 网络访问 运行 SDK 的环境可访问 AIuse 云电脑服务地址

能力 说明 鼠标控制 支持移动、点击、双击、右键、按下、释放、拖拽和滚动 键盘控制 支持按键、组合键和文本输入 屏幕观察 支持截取当前桌面屏幕，用于 Agent 观察界面状态 坐标获取 支持获取当前鼠标位置 等待控制 支持在自动化流程中等待页面或应用响应

工具调用示例 移动鼠标： plaintext { "name": "movemouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300 } } 输入文本： plaintext { "name": "typetext", "arguments": { "desktopCode": "xxx", "text": "Hello from AIuse MCP" } } 创建目录： plaintext { "name": "createdirectory", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest" } } 常见问题 如果 Qoder 中没有加载出工具列表，请优先检查： 本地是否已安装 Node.js，且 npx v 可正常输出版本号。 MCP 配置中的 command、args 和 env 是否填写正确。 CTGAPIKEY 和 CTGAPISECRET 是否正确。 AccessKey 是否已关联目标云电脑。 目标云电脑是否在线。 调用工具时是否明确传入或说明了 desktopCode。 安全建议 不要将包含 AccessKey Secret 的 MCP 配置提交到公开仓库。 多人共享开发环境时，建议使用个人或项目级 AccessKey。 如 Qoder 或 MCP Client 支持密钥管理，建议优先使用密钥管理能力。 AccessKey 泄露后，应立即在控制台禁用并更换。

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID，您可以查看 获取： 查 bb9fdb42056f11eda1610242ac110002

接口功能介绍 调用该接口查询集群一小时内的事件列表。 接口约束 无 URI GET /v2/cce/clusters//apis/events.k8s.io//events 路径参数 参数 是否必填 参数类型 说明 示例 下级对象 clusterId 是 String 集群ID，获取方式请参见如何获取接口URI中参数。 47281b02f87757478f20b1827c97cadf apiVersion 是 String 资源api的版本，请选择当前所操作集群支持的资源api版本，可参见Kubernetes版本与资源API版本对应表。 v1 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 labelSelector 否 String Kubernetes labelSelector，可通过label过滤资源；label之间通过“,”分隔，特殊符号要转义为url编码，如“”写为“%3D” name%3Daaa fieldSelector 否 String Kubernetes fieldSelector，可通过field过滤资源；label之间通过“,”分隔，特殊符号要转义为url编码，如“”写为“%3D”，以下为过滤Event常用的key及其含义： type：事件等级，有Normal和Warning两种等级 regarding.kind：产生事件资源的类型，如Pod、Node等 regarding.name：产生事件资源的名称 regarding.namesapce：产生事件资源所在的命名空间 regarding.kind%3DPod,type%3DNormal

使用保密字典 方式1： 通过挂载数据卷使用配置项 1、登陆云容器引擎控制台， 点击左侧导航栏中的集群，进入集群列表页。 2、在集群列表中点击需要使用保密字典的集群，进入集群管理页面。 3、在集群管理页面导航栏中选择工作负载， 在列表中选择需要创建的工作负载，本文以无状态为例。 4、点击新建，进入新建Deployment页面。 5、根据实际需要设置工作负载的基本信息（名称、镜像等），并在数据卷中，点击添加数据卷，选择secret类型，填写卷名称，并选择添加已有secret选择已有的保密字典。 6、在实例内容器的挂载点中，选择挂载数据卷，并添加挂载的容器路径及权限。 7、点击提交，完成创建。 方式2：环境变量中使用配置项 1、登陆云容器引擎控制台， 点击左侧导航栏中的集群，进入集群列表页面。 2、在集群列表中点击需要使⽤保密字典的集群，进入集群管理页面。 3、在集群管理页面导航栏中选择工作负载， 在列表中选择需要创建的工作负载，本文以无状态为例。 4、点击新建，进入新建Deployment页面。 5、根据实际需要设置工作负载的基本信息（名称、镜像等），并在环境变量中，点击新增变量，类型选择secretKeyRef，并选择已有的保密字典，填写环境变量名。 6、点击提交，完成创建。

参数 参数说明 名称 新建的镜像拉取凭证名称，同⼀个命名空间里命名必须唯⼀ 仓库域名 需要使用凭证认证的仓库域名 用户名 仓库认证用户名 密码 仓库认证密码 serviceAccount 在指定serviceAccount中加入该镜像拉取凭证

资源 1.19 1.21 1.23 1.25 1.27 1.29 1.31 Deployment apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 StatefulSet apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 DaemonSet apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 ReplicaSet apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 Job batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 CronJob batch/v1beta1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1

资源 1.19 1.21 1.23 1.25 1.27 1.29 1.31 CustomResourceDefinition (CRD) apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 Event (events.k8s.io) events.k8s.io/v1 events.k8s.io/v1beta1 events.k8s.io/v1 events.k8s.io/v1beta1 events.k8s.io/v1 events.k8s.io/v1beta1 events.k8s.io/v1 events.k8s.io/v1 events.k8s.io/v1 events.k8s.io/v1

参数 是否必填 参数类型 说明 示例 下级对象 prodInstId 是 String 实例id 567078229420302954 nodeId 是 Long 节点id 25

响应示例 { "returnObj":{ "pgEventId":3469 }, "message":"SUCCESS", "error":"", "statusCode":800 } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 prodInstId 是 String 实例id 567078229420302954 nodeId 是 Long 节点id 25

参数 是否必填 参数类型 说明 示例 下级对象 ProjectId 否 String 企业项目id，若不传入则查询默认的企业项目，默认的企业项目id为0 0 regionId 是 String 资源池id，比如实例在资源池A，则需要填写A资源池的id。 81f7728662dd11ec810800155d307d5b

接口功能介绍 节点停止 接口约束 无 URI GET /PG/v1/node/stop 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 prodInstId 是 String 实例id 567078229420302954 nodeId 是 Long 节点id 25 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 ProjectId 否 String 企业项目id，若不传入则查询默认的企业项目，默认的企业项目id为0 0 regionId 是 String 资源池id，比如实例在资源池A，则需要填写A资源池的id 81f7728662dd11ec810800155d307d5b 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码 800 message String 消息提示 SUCCESS error String 错误码 returnObj Object 返回结果 NodeStopVO 表 NodeStopVO 参数 参数类型 说明 示例 下级对象 pgEventId Long 任务Id 1 枚举参数 无 请求示例 请求url 请求头header { "ProjectId":"0", "regionId":"81f7728662dd11ec810800155d307d5b" } 请求体body 无

接口功能介绍 用户查询实例绑定安全组列表 接口约束 需要提供数据库实例Id. URI GET /teledbdcp/v2/openapi/dcporderinfo/getInstanceSecurityGroups 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 instId 是 String 实例id 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 projectid 是 String 项目id 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 接口状态码，参考下方状态码 200 error String 错误码 TELEDBDCP1000 message String 描述信息 returnObj Object 返回对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 data Array of Objects 响应数据 data 表 data 参数 参数类型 说明 示例 下级对象 securityGroupName String 安全组名称 id String 安全组id description String 安全组描述信息 vpcId String 虚拟私有云网ID securityGroupRules Array of Objects 安全组规则信息 securityGroupRules 表 securityGroupRules 参数 参数类型 说明 示例 下级对象 direction String 出方向egress、入方向ingress etherType String IP类型:IPv4、IPv6 protocol String 协议: ANY、TCP、UDP、ICMP(v4) description String 安全组规则描述信息 id String 唯一标识ID securityGroupId String 安全组ID rangeMin String ICMP类型端口:最小值 rangMax String ICMP类型端口:最大值 action String 拒绝策略:允许accept 拒绝drop remoteIpCidr String 远端地址:0.0.0.0/0

参数 是否必填 参数类型 说明 示例 下级对象 ProjectId 否 String 企业项目id，若不传入则查询默认的企业项目，默认的企业项目id为0 0 regionId 是 String 资源池id，比如实例在资源池A，则需要填写A资源池的id。 81f7728662dd11ec810800155d307d5b

参数 是否必填 参数类型 说明 示例 下级对象 pageNum 是 Integer 当前页 1 pageSize 是 Integer 页大小，范围11000 10 prodInstName 否 String 实例名称，支持模糊匹配 pgtests3 labelName 否 String 标签名称（一级标签） test labelValue 否 String 标签值（二级标签） test prodInstId 否 String 实例id 169528973574900007 instanceType 否 String 实例类型，primary:主实例，readonly:只读实例，不传则查询全部实例 primary obtainStatus 否 Boolean 是否实时获取实例状态，true：实例状态，false：非实时获取 false

枚举参数 无 请求示例 请求url 请求头header { "ProjectId":"0", "regionId":"81f7728662dd11ec810800155d307d5b" } 请求体body 无 响应示例 { "statusCode": 800, "message": "SUCCESS", "returnObj": { "outerProdInstId": "4ac52d1ef0db40f8bb9516eb596fd231", "orderId": null, "vpcId": "vpc8ljsg4ndda", "subnetId": "subnet1hfzsz0upw", "securityGroupId": "sgwosbpdn9o1", "userId": 9145, "prodInstId": "4ac52d1ef0db40f8bb9516eb596fd231", "prodInstFlag": "PostgreSQL", "prodInstName": "pg637lz", "prodInstSetName": "pg637lz", "prodDbEngine": "12.20P2", "machineSpec": "2C4G", "diskType": "SSD", "diskSize": 100, "prodType": 1, "prodRunninStatus": 0, "prodOrderStatus": 0, "parameterGroupUsed": "", "createTime": "20241122 16:34:38", "expireTime": "20241222 16:36:31", "netName": "vpcdcp", "subnet": "subnetdcp", "securityGroup": "DefaultSecurityGroup", "alive": 0, "vip": "192.168.0.163", "vip6": "", "writePort": "6543", "readPort": 6543, "diskUsed": "SATA", "diskTotal": "100G", "diskRated": null, "spuCode": "10003012", "toolType": 2, "hostSeries": "鲲鹏通用型(一代机)", "backupDiskType": "SATA", "backupDiskSize": "100G", "backupUsageDiskSize": "0.00G", "backupFreeSpace": "0G", "billMode": 1 }, "error": "" }

接口功能介绍 查询RDS实例的详情信息 接口约束 实例必须存活 URI GET /PG/v1/product/getpaasproduct 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 prodInstId 是 String 实例id obtainStatus 否 Boolean 是否实时获取实例状态，true：实时获取，false：非实时获取 false 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 ProjectId 否 String 企业项目id，若不传入则查询默认的企业项目，默认的企业项目id为0 0 regionId 是 String 资源池id，比如实例在资源池A，则需要填写A资源池的id。 81f7728662dd11ec810800155d307d5b 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码 800 message String 消息提示 SUCCESS returnObj Object 分页展示的实例列表 PaaspProductDetailVO error String 错误码 表 PaaspProductDetailVO 参数 参数类型 说明 示例 下级对象 alive Integer 实例是否存活,0:存活，1:异常 0 createTime String 创建时间，格式为：yyyy:MM:dd HH:mm:ss 20230505 17:56:18 diskRated Integer 磁盘使用率 0 diskSize Integer 实例数据最大磁盘空间，单位G 0 diskTotal String 磁盘总大小 24G diskType String 磁盘类型，例如：SATA，SSD SATA diskUsed String 已使用磁盘 12G expireTime String 过期时间，格式：yyyyMMdd HH:mm:ss 20230505 17:56:18 machineSpec String 实例机器规格 netName String VPC名称 orderId Integer 订单id 1 outerProdInstId String 对外的实例ID，对应PaaS平台 prodDbEngine String 数据库实例引擎 prodInstFlag String 实例标识 prodInstId String 实例id prodInstName String 实例名称 prodInstSetName String 实例集群名称 prodOrderStatus Integer 订单状态，0：正常，1：冻结，2：删除，3：操作中，4：失败,2005:扩容中 0 prodRunninStatus Integer 实例状态： 0:运行中 1:重启中 2:备份中 3:恢复中 1001:已停止 1006:恢复失败 1007:VIP不可用 1008:GATEWAY不可用 1009:主库不可用 1010:备库不可用 1021:实例维护中 2000:开通中 2002:已退订 2005:扩容中 2011:冻结 0 prodType Integer 实例部署方式 0：单机，1：一主一备，2：一主两备，3：只读实例 1 readPort Integer 读端口 5432 securityGroup String 安全组名称 subnet String 子网名称 userId Long 用户ID 147 vip String 虚拟ip地址 vip6 String vip6 vpcId String VPCID writePort Integer 写端口 6543 parameterGroupUsed String 参数配置所使用的名称，对应PaaS平台 spuCode String 规格id 10003011 toolType Integer 备份工具类型，1：pgbaseback，2：pgbackrest，3：s3 1 subnetId String 子网id securityGroupId String 安全组id hostSeries String 性能类型 鲲鹏通用型(一代机) backupDiskType String 备份空间类型 backupDiskSize String 备份空间大小,当为对象存储时，不返回值 backupUsageDiskSize String 备份已使用空间 10G backupFreeSpace String 备份免费空间 100G billMode Integer 计费模式,1包周期,2按需

画质问题可能由以下原因导致： 1. 原始内容质量。如果原始视频本身分辨率较低，转换后也不够清晰，建议选择高清片源。 2.网络带宽不足：网络不稳定时系统会自动降低画质以保证流畅，建议检查网络。 3. 环境光线。周围环境太亮会影响3D效果，建议调暗室内灯光，或在较暗环境下使用。 4. 设备镜片：检查AR/VR眼镜镜片是否干净，有污渍会影响观看效果。 为什么进入3D模式后，不能调整画面分辨率了？ 这是正常现象。3D模式下，系统为了保证最佳的3D效果和流畅度，会自动选择最优的分辨率方案，因此不支持手动调整。如果您觉得画质不够清晰，可以： 1. 退出3D模式，在云电脑普通模式下调整分辨率后再重新进入3D模式。 2. 检查网络状况，确保带宽充足。 3. 选择更高清的原始视频内容。 怎么让3D模式使用更流畅？ 以下是网络优化建议： 1. 使用5GWiFi：如果路由器支持，连接5GHz频段的WiFi，速度更快、干扰更少。 2. 避开高峰期：晚上810点是网络使用高峰期，尽量避开这个时段使用。 3. 独占网络：使用时让其他设备暂时断开网络，避免带宽被占用。 4. 靠近路由器：WiFi信号强度会影响体验，尽量靠近路由器使用。 5. 使用有线网络：如果条件允许，使用网线连接会更稳定。

工具/命令/服务 特点 说明 DCS控制台界面一键式迁移 操作简单，同时支持在线迁移和离线迁移（备份文件导入）两种方式，其中在线迁移支持增量数据迁移。 离线迁移，适用于源Redis和目标Redis网络不连通、源Redis不支持SYNC/PSYNC命令的场景。需要将数据备份文件导入到OBS，DCS从OBS桶中读取数据，将数据迁移到DCS的Redis中。 在线迁移，涉及到SYNC/PSYNC命令，适用于源Redis放通了SYNC/PSYNC命令的场景。支持将源Redis中的数据全量迁移或增量迁移到目标Redis中。 Rediscli Redis自带命令行工具，支持导出RDB文件，也支持将持久化的AOF文件整库导入。 AOF文件为所有数据更改命令的全量集合，数据文件稍大。 Rump 支持在线迁移，支持在同一个实例的不同数据库之间，以及不同实例的数据库之间迁移。 不支持增量迁移。建议停业务后迁移，避免出现Key丢失。详情参考 RedisShake 在线迁移和离线迁移均支持的一款开源工具。 适用于Cluster集群的数据迁移。 自行开发迁移脚本 灵活，根据实际情况适配。

本节主要介绍使用在线迁移自建Redi 场景描述 在满足源端自建Redis和目标Redis的网络相通、源Redis放通SYNC和PSYNC命令这两个前提下，DCS支持通过在线迁移的方式，将源端的自建Redis数据全量或增量迁移到DCS目标Redis中。 约束与限制 如果源Redis禁用了SYNC和PSYNC命令，请务必放通后再执行在线迁移，否则会导致在线迁移失败。 在线迁移不支持公网方式直接迁移。 进行在线迁移时，建议将源端实例的参数repltimeout配置为300秒，clientoutputbufferlimit配置为源端实例最大内存的20%。 源端仅支持Redis 3.0及3.0以上的Redis版本。 较早建立的实例如果密码中包含单引号（'），则该实例不支持进行在线迁移，建议修改实例密码或使用其他迁移方式。 在线迁移，相当于临时给源端Redis增加一个从节点并且做一次全量同步到迁移机，建议在业务低峰期执行迁移，否则可能导致源端实例CPU瞬时冲高，时延增大。 前提条件 在迁移之前，请先阅读迁移方案概览，选择正确的迁移方案，了解当前DCS支持的在线迁移能力，选择适当的目标实例。 如果是单机/主备等多DB的源端实例迁移到Proxy集群实例，Proxy集群默认不开启多DB，仅有一个DB0，请先确保源端实例DB0以外的DB是否有数据，如果有，请先参考[开启多DB操作](

本节主要介绍使用备份文件迁移不同Region/Redis版本的实例 DCS支持通过备份文件导入的方式离线迁移DCS实例间的数据。 前提条件 源Redis实例已执行数据备份并备份成功。 − 如果是通过Redis实例离线迁移，无需下载备份文件到本地，备份数据请参考手动备份实例。 − 如果是通过OBS桶离线迁移，需要下载备份文件到本地，请参考下载实例备份文件。 已准备目标Redis实例。如果您还没有目标Redis实例，请先创建Redis，参考创建实例。 目前Redis高版本支持兼容低版本，因此，同版本或低版本可以迁移到高版本Redis，目标端创建的实例版本不要低于源端Redis版本。 请确保目标Redis有足够的存储空间，迁移实例前建议清空目标Redis中的数据，清空实例数据的操作请参考清空实例数据。如果没有清空实例数据，数据迁移后，目标Redis与源Redis实例重复的数据会被覆盖，源Redis没有、目标Redis有的数据会保留。 使用备份文件离线迁移DCS Redis实例 如果您需要迁移的源Redis与目标Redis为DCS相同账号下相同Region的实例，且源Redis实例非单机实例时，离线迁移请参考通过Redis实例离线迁移。 如果您需要迁移的源Redis与目标Redis为DCS不同账号或不同Region的实例，或源Redis实例为单机实例时，离线迁移请参考通过OBS桶离线迁移。

前提条件 在迁移之前，请先阅读迁移方案概览，选择正确的迁移方案，了解当前DCS支持的在线迁移能力，选择适当的目标实例。 如果您还没有目标Redis，请先创建，创建操作，请参考创建实例。 如果您已有目标Redis，则不需要重复创建，为了对比迁移前后数据及预留足够的内存空间，建议在数据迁移之前清空目标实例数据，清空操作请参考清空实例数据。 如果没有清空实例数据，数据迁移后，目标Redis与源Redis实例重复的数据会被覆盖，源Redis没有、目标Redis有的数据会保留。 创建在线迁移任务 注意 仅当在线迁移任务与源Redis为相同账号下相同区域时，在线迁移时选择的源端Redis会自动放通源Redis的SYNC和PSYNC命令。因此需要在源Redis相同账号和区域下创建在线迁移任务。否则无法进行在线迁移。 步骤 1 登录分布式缓存服务控制台。如果源Redis与目标Redis所属不同账号下，请使用源Redis所在的账号登录DCS。在管理控制台左上角单击 ，选择源Redis所在的区域。 步骤 2 单击左侧菜单栏的“数据迁移”。页面显示迁移任务列表页面。 步骤 3单击右上角的“创建在线迁移任务”。 步骤 4 设置迁移任务名称和描述。任务名称请以字母开头，长度不小于4位且不超过64位。任务名称只能包含字母、数字、中划线、下划线。 步骤 5 配置在线迁移任务虚拟机资源的VPC、子网和安全组。 请选择与源Redis或目标Redis相同的VPC。 创建的在线迁移任务会占用一个租户侧IP，即控制台上迁移任务对应的“迁移IP”。如果源端Redis或目标端Redis配置了白名单，需确保配置了迁移IP或关闭白名单限制。 迁移任务所选安全组的“出方向规则”需放通源端Redis和目标端Redis的IP和端口（安全组默认情况下为全部放通，则无需单独放通），以便迁移任务的虚拟机资源能访问源Redis和目标Redis。 结束

实例类型 规格变更类型 实例规格变更的影响 单机、主备和读写分离实例 扩容/缩容 Redis 4.0及以上版本实例，扩容期间连接会有秒级中断，大约1分钟的只读，缩容期间连接不会中断。 Redis 3.0实例，规格变更期间连接会有秒级中断，5~30分钟只读。 如果是扩容，只扩大实例的内存，不会提升CPU处理能力。 单机实例不支持持久化，变更规格不能保证数据可靠性。在实例变更后，需要确认数据完整性以及是否需要再次填充数据。如果有重要数据，建议先把数据用迁移工具迁移到其他实例备份。 主备和读写分离实例缩容前的备份记录，缩容后不能使用。如有需要请提前下载备份文件，或缩容后重新备份。 Proxy和Cluster集群实例 扩容/缩容 水平扩容（分片数增加）： − 连接不中断，但会占用CPU，导致性能有20%以内的下降。 − 分片数增加时，会新增数据节点，数据自动负载均衡到新的数据节点，访问时延会增大。 水平缩容（分片数减少）： − 分片数减少时，会删除节点。Cluster集群实例缩容前，请确保应用中没有直接引用这些删除的节点，否则可能导致业务访问异常。 − 删除节点会导致连接闪断，请确保您的客户端应用具备重连机制和处理异常的能力，否则在变更规格后可能需要重启客户端应用。 垂直扩容（分片数不变，分片容量增加）： − 如果节点所在的虚拟机内存容量不足，会发生节点迁移，迁移时业务连接会有闪断和只读。 − 如果虚拟机内存容量充足，则直接扩大节点容量，对业务无影响。 垂直缩容（分片数不变，分片容量减少）：无影响。 实例缩容前，每个节点的已用内存要小于缩容后节点最大内存的70%，否则将不允许变更。 实例规格变更期间，可能会进行数据迁移，访问时延会增大。Cluster集群请确保客户端能正常处理MOVED和ASK命令，否则会导致请求失败。 实例规格变更期间，如果有大批量数据写入导致节点内存写满，将会导致变更失败。 在实例规格变更前，请先使用缓存分析中的大key分析，确保实例中没有大key存在，否则在规格改变后，节点间进行数据迁移的过程中，单个key过大（≥512MB）会触发Redis内核对于单key的迁移限制，造成数据迁移超时失败，进而导致规格变更失败，key越大失败的概率越高。 Cluster集群实例扩容或缩容时，请确保客户端开启集群拓扑自动刷新配置，否则在变更后需要重启客户端。Lettuce客户端开启集群拓扑自动刷新配置请参考 主备、读写分离和Cluster集群实例 副本数变更 Cluster集群实例增加或删除副本时，如果您使用的是Lettuce客户端，请确保开启集群拓扑自动刷新配置，否则在变更后需要重启客户端。开启集群拓扑自动刷新配置请参考

迁移后验证 数据迁移前如果目标Redis中数据为空，迁移完成后，可以通过以下方式确认数据的完整性： 1. 连接源Redis和目标Redis。连接Redis的方法请参考使用rediscli连接Redis实例。 2. 输入info keyspace，查看keys参数和expires参数的值。 3. 对比源Redis和目标Redis的keys参数分别减去expires参数的差值。如果差值一致，则表示数据完整，迁移正常。 注意 如果是全量迁移，迁移过程中源Redis更新的数据不会迁移到目标实例。

本节主要介绍DCS实例迁移下云 场景介绍 您可以通过DCS控制台的在线迁移功能，将DCS实例迁移到自建Redis。另外，您也可以通过导出RDB文件，然后导入本地Redis实例或者自建Redis中。 推荐方案 DCS控制台在线迁移功能 在线迁移操作，操作可以参考使用在线迁移，选择目标Redis的数据源时，选择“自建Redis”，填写目标Redis地址。 使用Rediscli导出DCS实例RDB文件或者控制台导出实例数据文件，然后使用Redisshake导入。 关于Redisshake的安装和使用，请参考使用RedisShake工具迁移自建Redis Cluster集群及Redisshake配置说明。 Rump 支持在线迁移，网络条件允许的情况下，可以考虑使用此方式。指导说明请参考使用Rump在线迁移。

检查网络 步骤 1 检查源Redis、目标Redis、迁移任务资源所在VPC是否在同一个VPC内。 如果是，则执行配置在线迁移任务：创建在线迁移任务；如果不是，执行步骤2。 步骤 2 检查源Redis的VPC、目标Redis的VPC、迁移任务资源所在VPC的网络是否打通，确保迁移任务的虚拟机资源能访问源Redis和目标Redis。 如果已打通，则执行配置在线迁移任务；如果没打通，则执行步骤3。 步骤 3 执行相应操作，打通网络。 当源Redis和目标Redis都属于DCS同一region，请查看和创建对等连接，打通网络。 当源Redis和目标Redis属于不同的云厂商或不同Region，请打通网络。 结束 配置在线迁移任务 步骤 1 单击 “继续配置”，配置在线迁移的源Redis、目标Redis等信息。 如果还没准备好配置资源，可以单击“立即创建”创建迁移任务，等配置资源准备好后在数据迁移页面单击需要配置的迁移任务右侧的“配置”，继续配置在线迁移任务。 步骤 2 选择迁移方法。 支持“全量迁移”和“全量迁移＋增量迁移”两种，“全量迁移”和“全量迁移＋增量迁移”的功能及限制如下表所示。 表 在线迁移方法说明 迁移类型 描述 全量迁移 该模式为Redis的一次性迁移，适用于可中断业务的迁移场景。全量迁移过程中，如果源Redis有数据更新，这部分更新数据不会被迁移到目标Redis 。 全量迁移＋增量迁移 该模式为Redis的持续性迁移，适用于对业务中断敏感的迁移场景。增量迁移阶段通过解析日志等技术， 持续保持源Redis和目标端Redis的数据一致。增量迁移，迁移任务会在迁移开始后，一直保持迁移中状态，不会自动停止 。需要您在合适时间，在“操作”列单击“停止”，手动停止迁移。停止后，源端数据不会造成丢失，只是目标端不再写入数据。增量迁移在传输链路网络稳定情况下是秒级时延，具体的时延情况依赖于网络链路的传输质量。 图 选择迁移方法 步骤 3 仅当迁移方法选择“全量迁移+增量迁移”时，支持选择是否启用“带宽限制”。 如果启用带宽限制功能，当数据同步速度达到带宽限制时，将限制同步速度的继续增长。 步骤 4 选择是否“自动重连”。如开启自动重连模式，迁移过程中在遇到网络等异常情况时，会无限自动重连。 自动重连模式在无法进行增量同步时，会触发全量同步，增加带宽占用，请谨慎选择。 步骤 5 分别配置“源Redis”和“目标Redis”。 1. 配置“源Redis类型”和“源Redis实例”： “源Redis类型”请选择“自建Redis”，并在“源Redis实例”处输入源Redis的IP地址和端口。 如果源Redis为Cluster集群，需要输入集群所有主节点的IP端口，用英文逗号隔开。例如：192.168.1.1:6379,192.168.0.0:6379 2. 配置“目标Redis类型”和“目标Redis实例”： “目标Redis类型”请选择“云服务Redis”，并在“目标Redis实例”处选择需要迁移的目标Redis。 3. 分别配置“源Redis实例密码”和“目标Redis实例密码”：如果是密码访问模式实例，在输入连接实例密码后，单击密码右侧的“测试连接”，检查实例密码是否正确、网络是否连通。如果是免密访问的实例，请直接单击“测试连接”。如果测试连接失败，请检查输入的实例密码是否正确、Redis实例与迁移任务网络是否打通。 步骤 6 单击“提交”。 步骤 7 确认迁移信息，然后单击“提交”，开始创建迁移任务。 可返回迁移任务列表中，观察对应的迁移任务的状态，迁移成功后，任务状态显示“成功”。 如果出现迁移失败，建议单击迁移任务名称，进入迁移任务详情页面，通过“迁移日志”排查迁移失败的原因。 如果是增量迁移，全量迁移后会一直处于增量迁移中的状态。 如需手动停止迁移中的任务，勾选迁移任务左侧的方框，单击迁移任务上方的“停止”，即可停止迁移。 结束

本节主要介绍使用在线迁移Redis实例 在满足DCS源Redis和目标Redis的网络相通、源Redis放通SYNC和PSYNC命令这两个前提下，支持使用在线迁移的方式，将DCS源Redis中的数据全量或增量迁移到目标Redis中。 约束与限制 在线迁移不支持公网方式直接迁移。 将高版本Redis实例数据迁移到低版本Redis实例可能失败。 较早建立的实例如果密码中包含单引号（'），则该实例不支持进行在线迁移，建议修改实例密码或使用其他迁移方式。 如果是单机/主备等多DB的源实例迁移到Proxy集群实例，Proxy集群默认仅有一个DB0，请先确保源实例DB0以外的DB是否有数据，如果有，请先参考开启多DB操作开启Proxy集群多DB。 如果是单机/主备等多DB的源端实例迁移到Cluster集群实例，Cluster集群不支持多DB，仅有一个DB0，请先确保源端实例DB0以外的DB是否有数据，如果有，请将数据转存到DB0，否则会出现迁移失败，将数据转存到DB0的操作请参考使用Rump在线迁移。 进行在线迁移时，建议将源端实例的参数repltimeout配置为300秒，clientoutputbufferslavehardlimit和clientoutputbufferslavesoftlimit配置为实例最大内存的20%。 在线迁移，相当于临时给源端Redis增加一个从节点并且做一次全量同步到迁移机，建议在业务低峰期执行迁移，否则可能导致源端实例CPU瞬时冲高，时延增大。