文档中心

缓存数据库 Redis 版

快速入门

创建实例

创建实例是开始使用缓存数据库 Redis 版的第一步。本文介绍如何创建 Redis 实例。

前提条件

已注册火山引擎账号，并完成实名认证。账号注册和实名认证的方法，请参见如何进行账号注册和实名认证。

已完成跨服务访问授权以允许 Redis 访问其他服务（如 VPC、EIP 等）。具体操作步骤，请参见跨服务访问授权。

操作步骤

在顶部菜单栏选择实例所属的项目和地域。

在实例列表页，单击创建实例。

在创建实例页，设置如下参数。

参数			说明
服务类型			当前固定为 Redis 社区版，无需选择。
基本信息	实例名称	输入实例名称。选填。若不填，实例 ID 默认作为实例名称。名称需同时满足如下要求：不能以数字、中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度需为 1~128 个字符。说明设置实例名称后，若选择了批量创建实例，那么系统会自动在您设置的名称后添加 _<实例编号> 作为区分。例如 redistest_000、redistest_001 等。
基本信息		数据库版本	选择 Redis 数据库版本。您可以选择 Redis 7.0、Redis 6.0 或 Redis 5.0。
规格配置	实例类型	选择 Redis 实例类型，取值范围如下：主备：主备实例的每个分片中至少包含两个节点，其中 1 个主节点（也称读写节点），其他的为从节点（也称只读从节点），主从节点间存在复制关系。单节点：单节点实例每个分片仅包含一个节点（主节点），不存在节点间的复制关系，无法提供数据持久化和高可用能力。说明单节点实例不保障 SLA，在发生变更、维护升级、故障后会丢失全部数据，建议仅在测试、学习等场景使用，不建议在生产环境中使用。关于单节点实例的更多说明，请参见产品架构。
		分片集群	您可以选择启用或不启用分片集群。关于启用分片集群的更多信息，请参见产品架构。
		连接模式	选择实例的连接模式，取值范围如下：代理模式：更高吞吐，支持自动读写分离路由等高级功能。直连模式：成本更低、延迟更低、需要自行部署读写。说明仅数据库版本为 Redis 7.0 且不启用分片集群时可选择直连模式。不启用分片集群的直连功能当前为加白功能，如需使用，请提交工单申请。
		分片数	选择启用分片集群实例的分片数，取值范围为 2~256 间的任意整数。说明仅分片集群状态为启用时，支持该配置。
		扩展模块	勾选需要开启使用的扩展模块。关于扩展模块的更多信息，请参见扩展模块。说明仅数据库版本为 Redis 7.0 的实例支持开启扩展模块。如需使用扩展模块，请提交工单联系技术支持申请使用。已开启的扩展模块不支持关闭。您也可以在创建实例后再开启扩展模块功能，具体操作步骤，请参见开启扩展模块。选择 Valkey-Search 模块后，如需创建 JSON 格式的索引，需同时勾选 Valkey-JSON 模块。
		节点类型	为开启了 Valkey-Search 模块的实例选择合适的节点类型。使用 Valkey-Search 模块需要占用较大 CPU，建议选择核心数较多的节点类型。说明仅开启了 Valkey-Search 模块后，支持该配置。当前节点类型暂不收费，可免费使用。正式收费前会通过站内信、短信等方式提前通知，请您关注官网和产品通知。
		每分片节点数	选择每个分片中的节点数量，其中：仅实例类型为主备的 Redis 实例支持该配置。单节点实例的每个分片中固定包含 1 个节点，无需设置该参数。主备实例的每个分片中默认包含 2 个节点（1 个主节点和 1 个从节点），最多包含 6 个节点（1 个主节点和 5 个从节点）。说明针对规格为 256MiB 的节点，每个账号在每个地域默认最多可创建 4 个节点，若您需要调整 256MiB 规格节点的购买配额（上限为 10 个），请参见账号配额。
		节点规格	缓存数据库 Redis 版支持多种节点规格，每种规格的性能（如可用内存和带宽）不同，您可以根据业务需要选择合适的规格。更多详情，请参见实例规格。
		规格预览	查看并确认已选择的规格性能详情，包括内存总容量、分片数、节点规格、每个分片中的节点数、预估的读写带宽和总连接数。
可用区和网络配置	部署方案	根据需要的可用区部署方案完成如下操作：设置单可用区部署选择部署方案为单可用区部署。从可用区下拉列表中选择需要的可用区。设置多可用区部署选择部署方案为多可用区部署。从可用区下拉列表中，分别为主节点和各从节点设置需要的可用区。说明若您选择了多个相同的可用区，表示主从节点均在同一可用区，那么创建实例时，系统会自动将部署方案切换为单可用区部署方案。多可用区部署可提高可用性，同时可能会出现 2ms~3ms 的网络延迟。关于可用区部署方案的更多详情，请参见多可用区同城容灾解决方案。
		私有网络	从下拉列表中选择实例所在的私有网络（VPC）。建议 Redis 实例与需要连接的 ECS 实例在同一私有网络，否则它们无法通过内网互通来实现最佳性能。更多关于私有网络和子网的信息，请参见什么是私有网络。说明若您还未创建任何私有网络，请先单击下拉列表右侧的创建私有网络，具体操作步骤，请参见创建私有网络。实例创建成功后，您可以修改实例所属的私有网络和子网，具体操作步骤，请参见修改私有网络或子网。当使用子账号登录控制台时，仅能看到该子账号所属项目下的私有网络信息。若您看不到目标私有网络，请确认是否使用了子账号，以及该子账号是否具备目标项目资源的权限。更多详情，请参见通过子用户使用 Redis 服务。
		子网	从下拉列表中选择当前私有网络中可使用的子网。子网是私有网络内的 IP 地址块。私有网络中的所有云资源都必须部署在子网内，子网为云资源分配私网 IP 地址。说明若您还未创建任何子网，请先单击下拉列表右侧的创建子网，具体操作步骤，请参见创建子网。子网具有可用区属性，下拉列表中仅展示当前私有网络中和实例属于同一可用区下的子网。创建私有网络时可指定项目，但创建子网时不支持指定项目，子网默认与所属 VPC 在同一项目下。VPC 和子网的项目变更具有独立性，即修改 VPC 所属项目并不会同时修改当前 VPC 下子网的所属项目。更多详情，请参见私有网络项目管理。若修改了 VPC 所属项目，您还需要将 VPC 下的子网项目也进行相应变更，保证两者所属项目的一致性。否则非全局权限子用户创建云资源（如缓存数据库 Redis 版）时将无法选择子网或出现异常报错。修改所属项目的具体操作步骤，请参见项目资源管理。
		端口	您可以自定义私网连接地址的端口号，默认使用 6379 端口。取值范围：1024~65535。实例创建成功后，您还可以修改私网地址的端口号。端口号修改方法，请参见修改端口号。
账号配置	设置密码	设置实例的默认账号（即 default 账号）密码。您可以选择立即设置或稍后设置实例的账号密码。其中：若选择立即设置，您需要输入实例密码并确认密码。密码需满足如下条件：长度为 8~64 个字符。至少包含大写字母、小写字母、数字或特殊字符中的任意 2 种。支持如下特殊字符： ()`~!@#$%^&*-+=_\|{}[];<>,.? 若选择稍后设置，您可以在实例创建后再为 default 账号设置密码，密码设置方法，请参见重置密码。您还可以根据业务需要设置新的账号和密码。具体方法，请参见创建与管理账号。
账号配置		免密访问	选择是否为新建实例打开免密访问开关。开启免密访问后，通过私有地址或直连地址连接实例时，均无需输入密码。说明实例创建成功后，您也可以随时关闭免密访问开关。关闭后，原来使用免密访问功能的客户端连接会断开。建议您在关闭免密访问功能前，先在客户端上使用账密验证的方式连接 Redis 实例。具体操作步骤，请参见免密访问。
高级配置	白名单组	若新建实例时已存在默认白名单，新实例会自动选中默认白名单。若新建实例时不存在默认白名单，或您需要将新建实例加入其他白名单，请参考如下步骤完成操作：单击白名单组输入框。在弹出的控制面板中，根据选择的绑定模式，完成后续操作。若选择了新白名单（即创建一个新的白名单，并自动绑定至当前实例）您需要：从所属项目下拉列表中，为新建白名单选择需要加入的项目，默认会加入 default 项目。输入新的白名单名称、描述（选填）和 IP 地址，您也可以选择将新建的白名单设置为默认白名单。单击确定。若选择了已有白名单（即绑定已有白名单至当前实例），您需要：在已有白名单列表中勾选需要绑定的白名单。说明您可以在白名单列表上方，先通过所属项目下拉列表和白名单名称搜索框快速筛选出目标白名单。单击确定。说明关于创建白名单时的名称、描述和 IP 地址配置的更多说明，请参见创建白名单。若通过子用户使用 Redis 云服务，您只能看到已为当前子用户授权项目下的白名单信息。更多详情，请参见通过子用户使用 Redis 服务。
		所属项目	根据业务需要设置实例所属的项目。根据您在 Redis 控制台顶部菜单栏已选择的项目，执行对应的操作：若您选择的是账号全部资源，那么新建实例会默认加入 default（默认资源）项目。您也可根据业务需要选择其他项目。若您选择的不是账号全部资源，而是一个具体的项目（例如您自行创建的项目），那么新建实例将默认加入该项目。您也可根据业务需要选择其他项目。说明实例创建成功后，您还可以改变实例的所属项目，例如将实例从当前项目转入至目标项目，或将未加入项目的云资源转入至目标项目。具体操作步骤，请参见项目资源管理。项目是一个虚拟的概念，包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理，并且控制项目内用户和角色对这些资源的权限。更多详情，请参见资源管理。
		标签	单击添加标签，输入标签键和标签值，为实例添加标签。标签键值的详细设置规则，请参见标签设置规则。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者或环境等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。更多信息，请参见标签管理。
		删除保护	您可以选择打开或关闭删除保护的开关。开启实例删除保护后，将无法删除该实例，避免因误操作导致实例删除。关于删除保护的更多信息，请参见实例删除保护。
		参数配置	从下拉列表中为新建实例选择参数模板。缓存数据库 Redis 版为每个数据库版本的主备和单节点实例都分别创建了一份默认的系统参数模板，模板中包含了该版本支持设置的所有参数和默认参数值，您可以根据已选择的数据库版本和实例类型，从下拉列表中选择并应用对应的参数模板。说明下拉列表中仅会展示当前账号和地域下，与实例当前数据库版本相同的参数模板。例如，您创建实例时选择的数据库版本为 Redis 6.0，那么下拉列表中仅会展示当前账号和地域下所有数据库版本为 Redis 6.0 的参数模板信息。关于参数模板的更多信息，请参见参数模板管理。若您还未创建任何自定义模板，请先单击下拉列表右侧的查看参数模板进入参数模板列表页进行创建，具体操作步骤，请参见创建参数模板。
计费信息	计费类型	您可以选择按量计费或包年包月。若选择计费类型为包年包月，您需要确认购买时长，同时您还可以勾选到期自动续费，系统会在实例到期前自动续费。

在页面左下角选择实例购买数量后，在右下角单击确认订单。

说明

每次需至少购买 1 个实例，最多可同时购买 20 个实例。

根据实例的计费类型完成后续步骤。

计费类型	操作步骤
按量计费	在确认订单页面，确认订单详情，阅读并勾选服务条款，单击立即购买。
包年包月	在确认订单页面，确认订单详情，阅读并勾选服务条款，单击提交订单。在确认订单信息页面，再次确认订单详情，单击下一步。在提交支付信息页面，确认支付明细并选择支付方式，单击去支付。说明若您已提交创建实例的订单，但未完成支付或支付失败，实例会进入等待支付状态。更多详情，请参见实例状态。待支付的实例订单创建成功后会保留 24 小时，建议及时完成支付否则该订单会被自动取消，您需要重新创建实例订单。您可以选择如下任一方式完成支付：在 Redis 控制台的实例列表页找到等待支付的目标实例，在实例右侧操作栏中，单击去支付跳转到实例的提交支付信息页面，您需要根据页面提示完成支付。前往费用中心 > 订单管理页，找到对应的待支付订单并根据页面提示完成支付。

说明

创建实例大约需要几分钟时间，您可以在实例列表中看到新创建的实例。

您可以前往任务中心查看新建实例的对应任务（任务名称/ID 为 CreateDBInstance），了解当前任务所处的阶段和进度详情。查看方法，请参见查看任务。

API	描述
CreateDBInstance	调用 CreateDBInstance 接口创建 Redis 实例。
DescribeRegions	调用 DescribeRegions 接口查询缓存数据库 Redis 版可用的地域资源列表。
DescribeZones	调用 DescribeZones 接口查询缓存数据库 Redis 版在指定地域下的可用区资源列表。