华为云分布式缓存服务(DCS) 1.10.0 用户指南说明书

分布式缓存服务(DCS) 1.10.0
用户指南
文档版本01
发布日期2023-03-30
版权所有 © 华为云计算技术有限公司 2023。

保留一切权利。

非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。

商标声明
和其他华为商标均为华为技术有限公司的商标。

本文档提及的其他所有商标或注册商标，由各自的所有人拥有。

注意
您购买的产品、服务或特性等应受华为云计算技术有限公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。

除非合同另有约定，华为云计算技术有限公司对本文档内容不做任何明示或暗示的声明或保证。

由于产品版本升级或其他原因，本文档内容会不定期进行更新。

除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。

华为云计算技术有限公司
地址：贵州省贵安新区黔中大道交兴功路华为云数据中心邮编：550029
网址：https:///
目录1 快速入门 (1)
1.1 创建实例 (1)
1.1.1 创建前准备 (1)
1.1.2 准备实例依赖资源 (2)
1.1.3 创建Redis实例 (3)
1.2 查看实例信息 (5)
2 用户指南 (8)
2.1 登录分布式缓存服务 (8)
2.2 实例日常操作 (8)
2.2.1 变更规格 (8)
2.2.2 重启实例 (11)
2.2.3 删除实例 (12)
2.2.4 主备切换 (13)
2.2.5 清空实例数据 (14)
2.2.6 导出实例列表 (15)
2.2.7 命令重命名 (15)
2.3 实例配置管理 (16)
2.3.1 配置管理说明 (16)
2.3.2 修改实例配置参数 (16)
2.3.3 修改实例安全组 (24)
2.3.4 查看实例后台任务 (24)
2.3.5 查看Redis 3.0 Proxy集群实例的数据存储统计信息 (25)
2.3.6 管理分片与副本 (26)
2.3.7 管理实例白名单 (27)
2.3.8 查询Redis实例慢查询 (28)
2.3.9 查询Redis实例运行日志 (29)
2.4 实例备份恢复管理 (30)
2.4.1 备份与恢复说明 (30)
2.4.2 设置自动备份策略 (32)
2.4.3 手动备份实例 (33)
2.4.4 实例恢复 (34)
2.4.5 下载实例备份文件 (35)
2.5 使用DCS迁移数据 (36)
2.5.2 备份文件导入方式 (37)
2.5.2.1 备份文件导入方式-OBS桶 (38)
2.5.2.2 备份文件导入方式-Redis实例 (40)
2.5.3 在线迁移方式 (41)
2.6 密码管理 (45)
2.6.1 关于实例连接密码的说明 (45)
2.6.2 修改缓存实例密码 (46)
2.6.3 重置缓存实例密码 (47)
2.6.4 修改Redis实例的访问方式 (48)
2.7 用户Redis切换DCS Redis操作指导 (49)
2.7.1 概述 (49)
2.7.2 创建DCS Redis实例 (50)
2.7.3 迁移用户Redis数据 (50)
2.7.3.1 备份文件导入方式-OBS桶 (50)
2.7.3.2 在线迁移方式 (51)
2.7.3.2.1 约束条件 (51)
2.7.3.2.2 在线迁移实施步骤 (51)
2.7.4 数据完整性校验 (53)
2.7.5 切换访问DCS Redis (53)
2.7.6 业务功能验证 (54)
2.8 参数模板 (54)
2.8.1 查看参数模板信息 (54)
2.8.2 创建自定义参数模板 (60)
2.8.3 修改自定义参数模板 (66)
2.8.4 删除自定义参数模板 (73)
2.9 监控 (74)
2.9.1 支持的监控指标 (74)
2.9.2 查看监控指标 (95)
3 最佳实践 (96)
3.1 使用DCS实现热点资源顺序访问 (96)
3.2 使用Redis实现排行榜功能 (101)
3.3 Redis使用规范 (103)
3.4 Redis客户端重试指南 (110)
3.5 使用主备切换功能验证应用是否实现自动重连 (113)
4 常见问题 (115)
4.1 实例类型/版本 (115)
4.1.1 版本差异 (115)
4.1.2 如何查询Redis实例的原生版本 (116)
4.1.3 DCS Redis 4.0支持的新特性说明 (116)
4.1.4 DCS Redis 5.0支持的新特性说明 (120)
4.2 客户端和网络连接 (125)
4.2.2 DCS实例支持弹性IP访问吗？ (126)
4.2.3 DCS实例是否支持跨VPC访问？ (126)
4.2.4 客户Http的Server端关闭导致Redis访问失败 (127)
4.2.5 客户端出现概率性超时错误 (127)
4.2.6 使用Jedis连接池报错如何处理？ (127)
4.2.7 客户端访问Redis实例出现“ERR unknown command”的原因是什么？ (129)
4.2.8 如何使用Redis-desktop-manager访问Redis实例？ (129)
4.2.9 使用SpringCloud时出现ERR Unsupported CONFIG subcommand怎么办？ (130)
4.2.10 Redis实例连接失败的原因排查 (131)
4.2.11 连接池选择及Jedis连接池参数配置建议 (131)
4.2.12 使用Redis实例的发布订阅(pubsub)有哪些注意事项？ (134)
4.3 Redis使用 (134)
4.3.1 Redis实例CPU使用率达到100%的原因 (134)
4.3.2 Redis实例能否修改VPC和子网？ (134)
4.3.3 Redis 4.0/5.0实例为什么没有安全组信息？ (134)
4.3.4 Redis实例支持的单个Key和Value数据大小是否有限制？ (134)
4.3.5 Redis集群可以读取每个节点的IP地址吗？ (135)
4.3.6 创建缓存实例，为什么可使用内存比实例规格少一些？ (135)
4.3.7 Redis实例是否支持多DB方式？ (135)
4.3.8 Redis集群实例是否支持原生集群？ (135)
4.3.9 Redis实例是否支持配置哨兵模式？ (135)
4.3.10 Redis默认的数据逐出策略是什么？ (135)
4.3.11 使用redis-exporter出错怎么办？ (136)
4.3.12 Redis3.0 Proxy集群不支持redisson分布式锁的原因 (136)
4.3.13 实例是否支持自定义或修改端口？ (136)
4.3.14 实例是否支持修改访问地址？ (137)
4.3.15 DCS实例是否支持跨可用区部署？ (137)
4.3.16 集群实例启动时间过长是什么原因？ (137)
4.3.17 客户使用Redis版本和DCS Redis版本不同是否存在兼容问题？ (137)
4.3.18 DCS Redis有没有后台管理软件？ (137)
4.3.19 Redis实例经常内存满了但是key不多的原因 (137)
4.3.20 DCS缓存实例的数据被删除之后，能否找回？ (138)
4.3.21 访问Redis返回“Error in execution” (138)
4.3.22 Redis key丢失是什么原因 (138)
4.3.23 重启实例后缓存数据会保留吗？ (138)
4.4 Redis命令 (138)
4.4.1 如何清空Redis数据？ (139)
4.4.2 高危命令如何重命名？ (139)
4.4.3 是否支持pipeline命令？ (139)
4.4.4 Redis是否支持INCR/EXPIRE等命令？ (139)
4.4.5 Redis命令执行失败的可能原因 (140)
4.4.7 Redis命令执行是否有超时时间？超时了会出现什么结果？ (141)
4.5 扩容缩容与实例升级 (141)
4.5.1 Redis实例是否支持版本升级？如Redis4.0升级到Redis5.0？ (141)
4.5.2 DCS实例规格变更是否需要关闭或重启实例？ (141)
4.5.3 DCS实例规格变更的业务影响 (141)
4.5.4 Redis实例变更失败的原因 (142)
4.6 监控告警 (143)
4.6.1 如何查看Redis实例的实时并发连接数和最大连接数 (143)
4.6.2 Redis命令是否支持审计？ (143)
4.6.3 Redis监控数据异常处理方法 (143)
4.6.4 为什么实例实际可用内存比申请规格小而且已使用内存不为0？ (143)
4.6.5 监控数据出现实例已使用内存略大于实例可使用内存是什么原因？ (144)
4.6.6 为什么带宽使用率指标会超过100% (144)
4.6.7 监控指标中存在已拒绝连接数是什么原因？ (144)
4.7 数据备份/导出/迁移 (145)
4.7.1 如何导出Redis实例数据？ (145)
4.7.2 是否支持控制台导出RDB格式的Redis备份文件？ (145)
4.7.3 迁移过程中为什么进程总是被kill？ (145)
4.7.4 Redis在线数据迁移是迁移整个实例数据么？ (146)
4.7.5 DCS支持数据持久化吗？开启持久化有什么影响？ (146)
4.7.6 AOF文件在什么情况下会被重写 (146)
4.7.7 使用Rump在线迁移 (147)
4.8 主备倒换 (148)
4.8.1 发生主备倒换的原因有哪些？ (148)
4.8.2 主备倒换的业务影响 (148)
4.8.3 主备实例发生主备倒换后是否需要客户端切换IP？ (148)
4.8.4 Redis主备同步机制怎样？ (148)
5 错误码 (150)
5.1 111400111 实例重启中，请稍后重试 (150)
5.2 111400113 实例正在规格变更中，请稍后重试 (150)
5.3 111403002 租户只有只读权限，无法操作DCS (150)
5.4 DCS.2007 您的权限不足 (151)
5.5 dcs.08.0002 操作超时 (151)
5.6 111403003 角色没有操作权限，无法执行此操作 (151)
5.7 111400010 实例名称不合法，请以字母，中文，或数字开头，且只能包含中文、字母、数字、下划线或者中划线，长度为4-64 (152)
5.8 111400096 当前实例正在备份中，请稍后再试 (152)
5.9 111400011 实例描述长度必须为0~1024 (152)
5.10 111400017 实例正在执行后台任务 (153)
5.11 111400020 子网的DHCP必须开启 (153)
5.12 111400019 密码复杂度不符合要求 (153)
5.13 DCS.4026 实例的当前状态不支持此操作 (154)
5.14 111400027 当前节点不支持该操作 (154)
5.15 111400035 租户实例配额不足 (154)
5.16 111400039 请求调整配额超出限制范围 (155)
5.17 111400036 租户内存配额不足 (155)
5.18 111400042 可用区不存在。

请确认指定的可用区存在后再重试。

(155)
5.19 111400043 租户不允许使用当前可用区 (156)
5.20 111400049 实例状态不是运行中 (156)
5.21 111400055 检查实例节点状态不正常 (156)
5.22 111500071 创建实例备份策略失败 (157)
5.23 111400086 只有主备类型的实例才支持这个操作 (157)
5.24 111400087 恢复实例时，备份记录的状态错误，succeed状态的才能进行恢复 (157)
5.25 保存备份信息失败 (158)
5.26 111500092 保存恢复数据失败 (158)
5.27 dcs.04.0004 存在两个主节点，主备节点间网络连接可能有问题 (158)
5.28 dcs.01.0003 数据库操作异常 (159)
5.29 111400101 删除实例备份文件失败 (159)
5.30 111400102 系统不支持变更规格 (159)
5.31 111400103 扩容容量必须比原来的大 (160)
5.32 111400094 系统不支持后台任务功能 (160)
5.33 111400095 系统不支持备份恢复功能 (160)
5.34 111500085 更新备份策略失败 (160)
5.35 111400104 实例内部异常正在恢复，请稍后重试 (161)
5.36 dcs.01.0001 数据访问异常，可能存在垃圾数据 (161)
5.37 DCS.5002 节点状态更新失败 (162)
5.38 DCS.5079 查询节点错误 (162)
5.39 111500070 修改实例配置参数错误 (162)
5.40 DCS.5077 查询实例失败 (163)
5.41 dcs.01.0002 数据库访问异常 (163)
5.42 111400099 实例状态为创建中、重启中、删除中时不允许执行删除操作 (163)
5.43 DCS.4910 不支持高级恢复 (164)
5.44 DCS.4857 OBS文件路径或者名称非法 (164)
5.45 111400813 数据包已经存在 (164)
5.46 111500815 数据面软件包导入失败 (165)
5.47 111500814 数据面升级导入包失败 (165)
5.48 DCS.4144 变更规格不能变更至与当前实例相同类型且规格相同 (165)
5.49 111500810 查询实例和节点软件信息失败 (166)
5.50 DCS.4145 实例已用内存超过缩容的规格大小 (166)
5.51 111500801 查询数据库统计信息失败 (166)
5.52 111500831 命令执行失败 (167)
5.53 DCS.4873 当前可用区资源不足 (167)
5.54 dcs.08.0013 重启或关闭实例导致备份中断 (167)
5.56 DCS.4911 网络IP不足 (168)
5.57 DCS.4943 操作的实例数超过最大上限 (168)
5.58 DCS.4104 实例内部异常正在恢复，请稍后重试 (169)
5.59 111500017 保存实例信息失败 (169)
5.60 DCS.4944 Redis实例网络连接失败 (169)
5.61 DCS.4913 不支持数据迁移 (170)
5.62 DCS.5091 不支持创建小规格实例 (170)
5.63 DCS.2006 操作权限不足 (170)
5.64 DCS.5000 系统繁忙，请稍后重试 (171)
5.65 DCS.3022 实例不存在 (171)
5.66 DCS.4945 Redis实例连接被拒绝 (172)
5.67 dcs.00.0002 参数错误 (172)
5.68 dcs.00.0003 实例进程启动失败 (172)
5.69 dcs.00.0004 实例进程停止失败 (173)
5.70 dcs.00.0008 实例进程重启失败 (173)
5.71 dcs.10.0010 集群Redis发生倒换 (173)
5.72 dcs.00.0006 回滚旧密码失败 (174)
5.73 dcs.00.0007 系统异常 (174)
5.74 dcs.02.0001 VPC创建失败，VPC服务可能存在异常 (174)
5.75 dcs.02.0002 VPC状态异常，VPC服务可能存在异常 (175)
5.76 dcs.02.0003 添加安全组规则失败，VPC服务可能存在异常 (175)
5.77 dcs.02.0004 子网创建失败，VPC服务可能存在异常 (175)
5.78 dcs.02.0005 子网状态异常，VPC服务可能存在异常 (176)
5.79 dcs.02.0006 安全组删除失败，VPC服务可能存在异常 (176)
5.80 dcs.02.0007 VPC删除失败，VPC服务可能存在异常 (176)
5.81 dcs.02.0008 VPC更新失败，VPC服务可能存在异常 (176)
5.82 dcs.03.0002 VM状态异常，ECS服务可能存在异常 (177)
5.83 dcs.03.0001 创建VM失败，ECS服务可能存在异常 (177)
5.84 dcs.03.0003 查询VM的浮动IP失败，ECS服务可能存在异常 (177)
5.85 dcs.03.0004 VM磁盘挂载失败，ECS服务可能存在异常 (178)
5.86 dcs.03.0005 VM绑定网卡失败，ECS服务可能存在异常 (178)
5.87 dcs.03.0006 VM删除失败，ECS服务可能存在异常 (178)
5.88 dcs.03.0007 VM启动失败，ECS服务可能存在异常 (179)
5.89 dcs.03.0008 VM重启失败，ECS服务可能存在异常 (179)
5.90 dcs.03.0009 VM停止失败，ECS服务可能存在异常 (179)
5.91 dcs.04.0002 实例部署异常，POD域网络可能存在异常 (179)
5.92 dcs.04.0003 无法连接实例，POD域网络可能存在异常 (180)
5.93 dcs.08.0005 创建桶失败 (180)
5.94 DCS.4950 请确保源Redis使用的DB数不能超过目标Redis支持的最大DB数 (180)
5.95 DCS.4096 实例备份中，请稍后重试 (181)
5.96 111400097 实例恢复中，请稍后重试 (181)
5.98 DCS.4114 实例配置中，请稍后重试 (182)
5.99 111400114 实例配置中，请稍后重试 (182)
5.100 111400115 正在修改密码，请稍后重试 (182)
5.101 111400124 实例正在主备切换中，或Sentinel状态不一致 (183)
5.102 111400117 实例回滚中，请稍后重试 (183)
5.103 DCS.4124 实例正在主备切换中，或Sentinel状态不一致 (183)
5.104 DCS.4117 实例回滚中，请稍后重试 (184)
5.105 111400121 实例重置密码中，请稍后重试 (184)
5.106 111400110 实例停止中，请稍后重试 (184)
5.107 DCS.4121 实例重置密码中，请稍后重试 (184)
5.108 DCS.4110 实例停止中，请稍后重试 (185)
5.109 DCS.4111 实例重启中，请稍后重试 (185)
5.110 111400112 实例启动中，请稍后重试 (185)
5.111 DCS.4112 实例启动中，请稍后重试 (186)
5.112 DCS.4113 实例扩容中，请稍后重试 (186)
5.113 DCS.4118 实例创建中，请稍后重试 (186)
5.114 111400118 实例创建中，请稍后重试 (186)
5.115 DCS.4116 实例升级中，请稍后重试 (187)
5.116 111400116 实例升级中，请稍后重试 (187)
5.117 111400142 实例清空数据中，请稍后重试 (187)
5.118 DCS.4142 实例清空数据中，请稍后重试 (188)
5.119 DCS.5083 保存备份用户失败 (188)
5.120 DCS.4985 实例节点不存在 (188)
5.121 DCS.4954 备份策略参数非法 (188)
5.122 DCS.4958 不支持从自建OBS桶迁移 (189)
5.123 DCS.4951 源redis实例和目标redis实例重复 (189)
5.124 DCS.5092 主备实例无法找到主节点 (189)
5.125 DCS.5081 查询实例分片信息错误 (190)
5.126 DCS.5007 实例密码修改失败 (190)
5.127 DCS.4995 迁移任务数量超出限制 (190)
5.128 DCS.4984 保留的节点可能存在过半的主节点在同一台主机上，请重新选择 (191)
5.129 DCS.4983 不支持集群缩容 (191)
5.130 DCS.4982 请求参数保留ip非法 (191)
5.131 DCS.4981 实例已用内存超出新容量的70%，不能进行缩容 (192)
5.132 DCS.4978 修改AUTH命令不报错开关失败 (192)
5.133 DCS.4977 ACL帐号名称不存在 (192)
5.134 DCS.4976 ACL帐号状态不允许当前操作 (193)
5.135 DCS.4975 实例状态不允许当前操作 (193)
5.136 DCS.4974 ACL帐号数量超出最大限制 (193)
5.137 DCS.4973 更新数据库信息失败 (193)
5.138 DCS.4972 修改ACL帐号角色失败 (194)
5.140 DCS.4970 修改ACL帐号密码失败 (194)
5.141 DCS.4969 ACL帐号已存在 (195)
5.142 DCS.4968 新密码与老密码相同 (195)
5.143 DCS.4988 查询配置参数模板数据失败 (195)
5.144 DCS.4967 该租户不支持ACL特性 (195)
5.145 DCS.4966 删除ACL帐号失败 (196)
5.146 DCS.4965 查询ACL数据库信息失败 (196)
5.147 DCS.4964 查询ACL列表失败 (196)
5.148 DCS.4963 关闭ACL开关前需删除所有ACL用户 (197)
5.149 DCS.4962 修改ACL开关失败 (197)
5.150 DCS.4961 ACL帐号请求参数不合法 (197)
5.151 DCS.4960 添加ACL帐号失败 (197)
5.152 DCS.4939 请求参数slave_priority_weight 非法 (198)
5.153 DCS.4937 唯一的备节点不允许被删除 (198)
5.154 DCS.4936 主节点不允许被删除 (198)
5.155 DCS.4935 只有一个备节点有dns ip，不允许删除该副本 (199)
5.156 DCS.4934 请求参数change_type非法 (199)
5.157 DCS.4933 请求参数available_zones非法 (199)
5.158 DCS.4932 spec_code与删除节点数不一致 (200)
5.159 DCS.4931 节点非只读副本，无法删除 (200)
5.160 DCS.4930 请求参数node_list非法 (200)
5.161 DCS.4929 不支持同时变更容量和副本数 (200)
5.162 DCS.4928 不支持创建超过5副本的实例 (201)
5.163 DCS.4927 请求参数spec_code非法 (201)
5.164 DCS.4926 不支持变更副本数 (201)
5.165 DCS.4925 请求参数与实例变更类型不匹配 (202)
5.166 DCS.4916 不支持实例拓扑图展示 (202)
5.167 DCS.4915 查询实例拓扑图失败 (202)
5.168 DCS.4914 实例密码校验错误 (203)
5.169 DCS.4912 不支持备份导入 (203)
5.170 DCS.4911 子网ip数量不足 (203)
5.171 DCS.4910 不支持高级恢复。

(204)
5.172 DCS.4909 备实例与主实例之间网络不通 (204)
5.173 DCS.4908 主实例当前为非运行状态，不能进行此操作 (204)
5.174 DCS.4907 备实例当前为非运行状态，不能进行此操作 (204)
5.175 DCS.4906 主实例数据不为空 (205)
5.176 DCS.4905 备实例密码校验错误 (205)
5.177 DCS.4904 主实例密码校验错误 (205)
5.178 DCS.4902 实例密码连续5次校验错误，已经被锁定 (206)
5.179 DCS.4901备实例信息错误 (206)
5.180 DCS.4900 主实例信息错误 (206)
用户指南目录5.181 DCS.4873 当前可用区资源不足 (206)
5.182 DCS.4857 OBS文件路径或者名称非法 (207)
5.183 DCS.4822 参数scan_keys_count取值不合法，取值范围在10~1000 (207)
5.184 DCS.4821 参数timeout 取值不合法，必须大于0，且至少是扫描间隔时间的两倍 (207)
5.185 DCS.4820 参数interval 取值不合法。

必须大于等于0秒 (208)
5.186 DCS.4819 参数first_scan_at取值不合法，不符合ISO格式的UTC时间，first_scan_at必须晚于当前时间 (208)
5.187 111400800 请求参数错误 (208)
5.188 DCS.4108 实例存在正在处理的变更订单，请稍后再试 (209)
5.189 111400108 实例存在正在处理的变更订单，请稍后再试 (209)
5.190 111400062 查询参数{0}非法 (209)
5.191 DCS.4062 查询参数非法 (210)
5.192 111500033 调用EPS更新project信息失败。

请检查首页的已分配资源是否同步，同步完成后重试。

(210)
5.193 dcs.10.0005 实例部署异常，物理机可能存在异常 (211)
5.194 111403005 您的权限不足 (211)
5.195 DCS.2005 您的权限不足 (211)
1快速入门
1.1 创建实例
1.1.1 创建前准备
在创建实例之前，请先根据您的实际业务需要，明确实例创建需求，完成以下工作：
1.确定缓存实例版本。

不同的Redis版本，特性会不同，可参考《分布式缓存服务(DCS) 1.10.0 产品介绍
(for 华为云Stack 8.2.1)》中“Redis版本差异”章节。

2.确定缓存实例类型，即实例架构。

确定缓存类型后，需要明确实例架构，当前支持的实例架构有单机、主备、读写
分离、Proxy集群和Cluster集群。

实例规格特点和架构，可参考《分布式缓存服务
(DCS) 1.10.0 产品介绍(for 华为云Stack 8.2.1)》中“实例类型”章节。

3.确定实例规格。

确定实例架构后，需要明确实例规格大小。

实例支持的连接数和带宽，可参考
《分布式缓存服务(DCS) 1.10.0 产品介绍(for 华为云Stack 8.2.1)》中“实例类
型”章节。

4.确定选择的区域以及实例是否跨可用区部署。

选择的区域，建议选择接近您应用程序的区域，减少网络延时。

一个区域对应多个可用区（AZ），当前DCS支持将主备实例部署在不同的AZ内，
节点间电力与网络均物理隔离。

您可以将应用程序也进行跨AZ部署，从而达到数
据与应用全部高可用。

说明
●当前只有Redis 4.0及5.0主备实例在跨AZ容灾环境下才能部署在不同的AZ内。

●当主备Redis实例进行跨可用区部署时，如果其中一个可用区故障，另一个可用区的节
点不受影响。

备节点会自动升级为主节点，对外提供服务，从而提供更高的容灾能力。

●由于实例跨可用区部署时网络访问效率略低于部署在同一可用区内，因此Redis实例跨
可用区部署时，主备节点之间同步效率会略有降低。

5.确定实例是否配置备份策略。

单机实例不支持配置备份与恢复策略。

关于备份恢复，请参考备份与恢复说明。

1.1.2 准备实例依赖资源
使用DCS服务前，若采用VPC内连接的方式，您需要创建虚拟私有云（Virtual Private
Cloud，以下简称VPC），并且配置安全组与子网。

VPC为DCS服务提供一个隔离的、
您可以自主配置和管理的虚拟网络环境，提升资源的安全性，简化网络部署。

如果您已有以下依赖资源，可重复使用，不需要多次创建。

创建VPC和子网
步骤1使用浏览器，以VDC管理员或VDC业务员帐号登录ManageOne。

登录地址：https://ManageOne运营面的访问地址。

例如，https://。

步骤2在页面左上角单击，选择“区域”和“资源集”，然后选择“网络 > 虚拟私有云”。

步骤3在左侧导航栏选择“虚拟私有云 > 我的VPC”，进入虚拟私有云页面。

步骤4单击“创建虚拟私有云”。

步骤5根据界面提示创建虚拟私有云。

如无特殊需求，界面参数均可保持默认。

关于创建VPC的详细信息可以参考《虚拟私有云(VPC) 8.2.1 使用指南(for 华为云
Stack 8.2.1)》中《虚拟私有云(VPC) 8.2.1 用户指南(for 华为云Stack 8.2.1)》的“创
建 > 申请虚拟私有云”章节。

创建虚拟私有云时，会同时创建子网，若需要额外创建子网，请参考步骤6和步骤7；
如果不需要额外创建子网，请执行创建安全组。

说明
●在创建虚拟私有云时，配置参数“网段”，即为VPC的地址范围，若配置该参数，则VPC内
的子网地址必须在VPC的地址范围内。

●若创建虚拟私有云用于发放DCS实例时，可不用配置虚拟私有云的“网段”。

步骤6在左侧导航栏选择“虚拟私有云 > 子网”，进入子网页面。

步骤7单击“创建子网”。

根据界面提示创建子网。

如无特殊需求，界面参数均可保持默认。

关于创建子网的详细信息可以参考《虚拟私有云(VPC) 8.2.1 使用指南(for 华为云
Stack 8.2.1)》中《虚拟私有云(VPC) 8.2.1 用户指南(for 华为云Stack 8.2.1)》的“虚
拟私有云及子网 > 子网 > 创建子网”章节。

----结束
创建安全组
说明
仅Redis 3.0实例需要安全组。

步骤1登录虚拟私有云管理控制台。

步骤2在左侧导航选择“访问控制 > 安全组”，单击“创建安全组”。

根据界面提示创建安全组。

如无特殊需求，界面参数均可保持默认。

关于创建安全组的详细信息可以参考《虚拟私有云(VPC) 8.2.1 使用指南(for 华为云
Stack 8.2.1)》中《虚拟私有云(VPC) 8.2.1 用户指南(for 华为云Stack 8.2.1)》的“安
全组 > 创建安全组”章节。

----结束
1.1.3 创建Redis实例
您可以根据业务需要创建相应计算能力和存储空间的Redis实例。

说明
DCS新建局点已下线Redis 3.0实例，存量局点可以继续使用Redis 3.0。

建议使用Redis 4.0/5.0。

不支持Redis版本的升级，例如，不支持Redis 4.0单机升级为Redis 5.0单机实例。

如果需要使用
高版本Redis单机实例，建议重新创建高版本Redis单机实例，然后将原有Redis实例的数据迁移
到高版本实例上。

前提条件
已准备好实例依赖资源。

创建Redis实例
步骤1使用浏览器，以VDC管理员或VDC业务员帐号登录ManageOne。

登录地址：https://ManageOne运营面的访问地址。

例如，https://。

步骤2在页面左上角单击，选择“应用服务 > 分布式缓存服务 DCS”,进入分布式缓存服务首页。

步骤3在管理控制台左上角单击，选择区域和资源集。

步骤4单击“创建缓存实例”，进入实例创建页面。

步骤5在“区域”下拉列表中，选择靠近您应用程序的区域，可降低网络延时、提高访问速度。

步骤6根据创建前准备，设置以下基本信息；
1.在“缓存类型”区域，选择缓存实例类型。

本章节选择“Redis”。

2.在“版本号”区域，选择Redis版本。

当前DCS支持的Redis版本有：4.0、5.0。

3.在“实例类型”区域，选择单机、主备、Proxy集群、Cluster集群或读写分离实例
类型。

4.选择“CPU架构”，当前支持“x86计算”和“Arm计算”，部分区域已停售
“Arm计算”类型，建议选择“x86计算”。

5.在“副本数”区域，选择实例副本数，默认为2副本（包含主副本）。

当选择Redis4.0/Redis5.0，且实例类型为主备、Cluster集群、读写分离时，页面
才显示“副本数”。

6.在“可用区”区域，您可根据实际情况选择。

说明
–如果提高访问速度，可选择和应用同一个可用区。

–每个region有若干个可用区。

当可用区资源不足时，可用区会置灰，此时，请选择另一个可用区。

7.在“实例规格”区域，选择符合您的规格。

步骤7设置实例网络环境信息。

1.在“虚拟私有云”区域，选择已经创建好的虚拟私有云、子网。

2.设置实例IP地址。

Cluster集群实例仅支持自动分配地址，其他实例类型支持自动分配IP地址或手动
分配IP地址，用户选择手动分配IP地址时，可以输入一个在当前子网下可用的IP。

另外，Redis4.0及以上版本的实例支持自定义端口，自定义端口范围为1~65535的
任意数字；如果未自定义，则使用默认端口6379。

Redis3.0不支持自定义端口，
端口都为6379。

步骤8设置实例密码。

●“访问方式”：支持“密码访问”和“免密访问”，您可以设置访问实例时是否
要进行密码验证。

说明
–选择免密访问方式时，存在安全风险，请谨慎使用。

–若申请免密模式的Redis实例，申请成功后，可以通过重置密码进行密码设置，具体可参考修改Redis实例的访问方式章节。

●“密码”和“确认密码”：只有“访问方式”为“密码访问”时，才会显示该参
数，表示连接Redis实例的密码。

说明
DCS服务出于安全考虑，在密码访问模式下，连接使用Redis实例时，需要先进行密码认
证。

请妥善保存密码，并定期更新密码。

步骤9设置参数配置。

“参数配置”支持“系统默认”和“使用自定义模板”，您在购买实例时可以设置是
否使用自定义参数模板。

说明
●创建页面的参数配置默认使用“系统默认”参数模板。

●如需使用自定义模板，只能选择与所创建实例相同版本号和实例类型下的自定义模板，创建
自定义模板请参考创建自定义参数模板。

步骤10设置实例购买数量。

步骤11设置实例的“名称”和“资源组”。

创建实例时，名称长度不能少于4位字符串。

批量创建实例时，实例名称格式为“自定义名称-n”，其中n从000开始，依次递增。

例如，批量创建两个实例，自定义名称为
dcs_demo，则两个实例的名称为dcs_demo-000和dcs_demo-001。

“资源组”默认为“default”分组，可根据需要进行选择，如需查看资源组详情或创
建新的资源组，请单击右侧的“查看资源组”。

缓存实例创建后，在实例信息页面可
以查看或修改资源组。

步骤12单击“更多配置”，设置实例其他信息。

1.设置实例的“描述”。

2.选择是否开启“自动备份”。

只有当实例类型为主备，读写分离或者集群时显示该参数。

关于实例备份的说明
及备份策略的设置请参考备份与恢复说明。

3.重命名实例高危命令。

当创建的是Redis 4.0及以上版本的实例时，支持重命名高危命令。

当前支持的高
危命令有command、keys、flushdb、flushall和hgetall，其他命令暂时不支持重
命名。

步骤13实例信息配置完成后，单击“立即创建”，进入规格确认页面。

页面显示申请的分布式缓存服务的实例名称、缓存版本和实例规格等信息。

步骤14确认实例信息无误后，提交请求。

步骤15缓存实例创建成功后，您可以在“缓存管理”页面，查看并管理自己的缓存实例。

1.Redis 4.0及以上版本采用容器化部署，秒级完成创建。

2.缓存实例创建成功后，默认“状态”为“运行中”。

----结束
1.2 查看实例信息
本节介绍如何在DCS管理控制台查看DCS缓存实例的详细信息。

操作步骤
步骤1使用浏览器，以VDC管理员或VDC业务员帐号登录ManageOne。

登录地址：https://ManageOne运营面的访问地址。

例如，https://。

步骤2在页面左上角单击，选择“应用服务 > 分布式缓存服务 DCS”，进入分布式缓存服务首页。

步骤3在导航栏左上角下拉框选择区域和资源集。

步骤4单击左侧菜单栏的“缓存管理”。

进入缓存管理页面。

步骤5查询DCS缓存实例。

●支持通过关键字搜索对应的DCS缓存实例。

直接在搜索栏输入关键字即可。

●支持通过指定属性的关键字查询对应的DCS缓存实例。

当前支持的属性有“名称”、“ID”、“IP地址”、“可用区”、“状态”、
“实例类型”、“缓存类型”、“CPU”、“资源组”。

更多的搜索设置帮助，请单击搜索栏右侧的搜索帮助。

步骤6在需要查看的DCS缓存实例左侧，单击该实例的名称，进入实例的基本信息页面。

参数说明如下表所示。

表1-1参数说明
可以修改
缓存实例的描述信息。

单击“描述”后的
单击参数后的可以修改资源组，如需查看或创建资
可以修改安全组。

----结束
2用户指南
2.1 登录分布式缓存服务
操作步骤
步骤1使用浏览器，以VDC管理员或VDC业务员帐号登录ManageOne。

登录地址：https://ManageOne运营面的访问地址。

例如，https://。

步骤2在页面左上角单击，选择“应用服务 > 分布式缓存服务 DCS”，进入分布式缓存服务首页。

步骤3在导航栏左上角下拉框选择区域和资源集。

----结束
2.2 实例日常操作
2.2.1 变更规格
DCS管理控制台支持变更Redis缓存实例规格，即扩容/缩容，您可以根据实际需要，选
择合适的实例规格。

说明
●执行实例规格变更操作，建议在业务低峰期进行。

●当前除Redis 3.0单机和主备实例外，其他实例类型不支持跨实例类型的变更。

●如果实例创建时间非常早，由于实例版本没有升级而无法兼容规格变更（扩容/缩容）功能，
请联系技术支持将缓存实例升级到最新版本，升级后就可以支持规格变更（扩容/缩容）功
能。

●变更规格过程中会有秒级业务中断，需要业务连接Redis的模块支持连接中断后重连，常见的
Redis客户端SDK已在连接池方式中实现重连机制，建议业务使用SDK的连接池方式。