文档数据库 MongoDB 版
文档数据库 MongoDB 版
文档数据库 MongoDB 版
文档指南
请输入
产品简介
用户指南
多可用区同城容灾解决方案
网络与连接管理
数据安全
AI 能力
最佳实践
API 参考
实例管理
连接管理
备份与恢复
白名单管理
参数管理
常见问题
- 文档首页
文档数据库 MongoDB 版用户指南实例管理创建实例
复制全文
下载 pdf创建实例
文档反馈
问问助手创建实例是开始使用文档数据库 MongoDB 版的第一步，本文介绍如何创建 MongoDB 实例。
前提条件
- 已完成跨服务访问授权以允许 MongoDB 访问其他服务（如 VPC、EIP 等）。具体操作步骤，请参见跨服务访问授权。
操作步骤
- 登录 MongoDB 控制台。
- 在顶部菜单栏，选择实例所属的项目和地域。
- 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。
- 在目标实例类型列表页，单击创建实例。
- 在创建实例页，设置如下参数。
- 参数说明参数说明基本信息实例名称输入实例名称，选填。名称需同时满足如下要求：
- 不能以数字、中划线（-）开头。
- 只能包含中文、字母、数字、下划线（_）和中划线（-）。
- 长度需为 2~64 个字符。
说明- 若该参数不填，实例 ID 默认作为实例名称。
- 您可以根据需要自定义实例名称，实例名称无唯一性要求。
- 设置实例名称后，若选择了批量创建实例，那么系统会在您设置的名称后添加实例编号作为区分，具体规则如下：
- 若您已在实例名称末尾设置了编号（格式需为<实例名称前缀>-<编号>），那么系统会以该编号为起始值，自动在本次批量创建的其他实例名称末尾添加递增编号作为区分。
- 例如，您设置了实例名称为 mongodbtest-4，且选择了批量创建 3 个实例，那么这 3 个实例的名称将分别为 mongodbtest-4、mongodbtest-5 和 mongodbtest-6。
- 若您没有在实例名称末尾设置编号，那么系统会自动在您设置的名称后添加-<编号> 作为区分，默认起始编号为 1。
- 例如，您设置了实例名称为 mongodbtest，且选择了批量创建 3 个实例，那么这 3 个实例的名称将分别为 mongodbtest-1、mongodbtest-2 和 mongodbtest-3。
检索功能数据库版本实例类型选择 MongoDB 的实例类型，您可以选择副本集或分片集群。存储类型部署方式您可以根据业务需要选择单可用区部署或多可用区部署，其中：- 设置单可用区部署
- 选择部署方式为单可用区部署。
- 从可用区右侧选择需要的可用区，并根据业务需要选择是否添加只读节点。
- 设置多可用区部署
- 选择部署方式为多可用区部署。
- 从可用区下拉列表中，分别为主节点和各从节点设置需要的可用区，并根据业务需要选择是否添加只读节点。
说明- 当前仅副本集实例和分片集群实例中 Shard 分片支持添加只读节点。
- 每个实例（或每个 Shard 分片）最多可添加 5 个只读节点。更多关于只读节点的功能介绍和使用限制，请参见 MongoDB 只读节点。
- 实例所在地域需要支持 3 个及以上的可用区资源才支持选择多可用区部署方式。
- 跨可用区部署可提高可用性，同时可能会出现 2 ms ~ 3 ms 的网络延迟。关于多可用区部署的更多信息，请参见多可用区同城容灾解决方案。
实例配置若实例类型为副本集，需要设置如下配置：Mongod：- 节点规格：选择副本集实例中 Mongod 节点的规格。更多详情，请参见计算节点规格。
- 节点数：当前每个副本集实例固定支持 3 个 Mongod 节点，无需选择。
- 存储空间：选择 Mongod 节点的存储空间，单位：GiB，步长为 10。
说明Mongot：- 节点规格：选择副本集实例中 Mongot 节点的规格。更多详情，请参见计算节点规格。
- 节点数：当前固定为 2 个，暂不支持变更。
- 存储空间：选择 Mongot 节点的存储空间，单位：GiB，步长为 10。建议与 Mongod 节点的初始配置保持一致。
说明- Mongot 节点仅在开启检索功能后显示。
- Mongot 节点采用双节点高可用架构部署，系统会自动执行故障切换，将流量路由到健康节点，请确保业务具备重试机制。
若选择实例类型为分片集群，需要对 Mongos、Shard、Mongot 和 ConfigServer 组件进行配置：- Mongos：
- 节点规格：选择分片集群中 Mongos 的节点规格。更多详情，请参见计算节点规格。
- 节点数量：选择 Mongos 节点的数量，取值范围：2~32。
- Shard：
- 分片数：选择分片集群中 Shard 分片数，取值范围：2~32。
说明为保证实例运行性能，系统会根据已选择的分片数，自动推荐匹配的默认 Configserver 节点规格，您也可以根据实际业务需要灵活配置。- 分片节点数：每个 Shard 默认为三副本集架构，即每个分片中均包含 3 个节点，无需选择。
- 节点规格：选择 Shard 分片的节点规格，每个分片中的每个节点规格一致。更多详情，请参见计算节点规格。
- 存储空间：选择 Shard 的存储空间，单位：GiB，步长为 10。
说明- Mongot：
- 节点规格：选择分片集群中 Mongot 的节点规格。更多详情，请参见计算节点规格。
- 单分片下节点数量：当前固定为 2 个。
- 存储空间：选择 Mongot 节点的存储空间，单位：GiB，步长为 10。建议与 Mongod 节点的初始配置保持一致。
说明Mongot 组件仅在开启检索功能后显示。- ConfigServer：
- 节点规格：选择 ConfigServer 的节点规格，更多详情，请参见计算节点规格。
说明为保证实例运行性能，系统会根据已选择的分片数，自动推荐匹配的默认 Configserver 节点规格，您也可以根据实际业务需要灵活配置。- 存储空间：选择 ConfigServer 的存储空间，单位：GiB，步长为 10。
说明规格预览查看并确认已选择的规格性能详情，包括节点规格、节点数、存储空间等。密码设置设置密码设置实例的默认账号（即 root 账号）密码。您可以选择立即设置或稍后设置实例的账号密码。- 若选择立即设置，您需要输入实例密码并确认密码。密码需满足如下条件：
- 只能为大小写字母、数字及以下特殊字符 _#!@$%^&*()+=-。
- 长度为 8~32 个字符。
- 至少包含大写字母、小写字母、数字或特殊字符中的 3 种。
- 不允许使用极易被破解的弱密码（如 Admin@123）。
网络配置私有网络从下拉列表中选择实例所在的私有网络。说明- 若您还未创建任何私有网络，请先单击下拉列表右侧的创建私有网络，具体操作步骤，请参见创建私有网络。
- 实例创建成功后，私有网络不可更改。
- 当使用子账号登录控制台时，仅能看到该子账号所属项目下的私有网络信息。若您看不到目标私有网络，请确认是否使用了子账号，以及该子账号是否具备目标项目资源的权限。更多详情，请参见通过子用户使用 MongoDB 服务。
子网从下拉列表中选择当前私有网络中可使用的子网。子网是私有网络内的 IP 地址块。私有网络中的所有云资源都必须部署在子网内，子网为云资源分配私网 IP 地址。说明- 若您还未创建任何子网，请先单击下拉列表右侧的创建子网，具体操作步骤，请参见创建子网。
- 子网具有可用区属性，下拉列表中仅展示当前私有网络中和实例属于同一可用区下的子网。
- 创建私有网络时可指定项目，但创建子网时不支持指定项目，子网默认与与所属 VPC 在同一项目下。VPC 和子网的项目变更具有独立性，即修改 VPC 所属项目并不会同时修改当前 VPC 下子网的所属项目。更多详情，请参见私有网络项目管理。
- 若修改了 VPC 所属项目，您还需要将 VPC 下的子网项目也进行相应变更，保证两者所属项目的一致性，否则非全局权限子用户创建云资源（如文档数据库 MongoDB 版）时将无法选择子网或出现异常报错。修改所属项目的具体操作步骤，请参见项目资源管理。
默认端口为新实例设置私网连接地址的端口号。默认使用 3717 端口。取值范围：1000~65535。说明白名单若新建实例时已存在默认白名单，新实例会自动选中默认白名单。若新建实例时不存在默认白名单，或您需要将新建实例加入其他白名单，请参考如下步骤完成操作：- 单击白名单组输入框。
- 在弹出的控制面板中，根据选择的绑定模式，完成后续操作。
- 若选择了新白名单（即创建一个新的白名单，并自动绑定至当前实例）您需要：
- 从所属项目下拉列表中，为新建白名单选择需要加入的项目，默认会加入 default 项目。
- 输入新的白名单名称、描述（选填）和 IP 地址。您也可以选择将新建的白名单设置为默认白名单。
- 单击确定。
- 若选择了已有白名单（即绑定已有白名单至当前实例），您需要：
- 在已有白名单列表中勾选需要绑定的白名单。
说明- 您可以在白名单列表上方，先通过所属项目下拉列表和白名单名称搜索框快速筛选出目标白名单。
- 您可以在已有白名单列表中同时勾选多个白名单进行批量绑定。
- 单击确定。
说明- 关于创建白名单时的名称、描述和 IP 地址配置的更多说明，请参见创建白名单。
- 若通过子用户使用 MongoDB 云服务，您只能看到已为当前子用户授权项目下的白名单信息。更多详情，请参见通过子用户使用 MongoDB 云服务。
高级配置所属项目根据业务需要设置实例所属的项目。- 若您选择的是账号全部资源，那么新建实例会默认加入 default（默认资源）项目中，您也可以根据业务需要选择其他项目。
- 若您选择的不是账号全部资源，而是一个具体的项目（例如您自行创建的项目），那么新建实例将默认自动加入该项目，您也可以根据业务需要选择其他项目。
标签参数配置从下拉列表中为新建实例选择一个参数模板。说明- 当前仅副本集实例支持参数模板功能，因此仅当实例类型选择副本集时才会看到该配置项。
- 参数模板必须应用在数据库版本相同的实例中，因此下拉列表中仅展示与实例的数据库版本相同的参数模板。例如创建的是 MongoDB 6.0 实例，那么下拉列表中仅会展示数据库版本为 MongoDB 6.0 的参数模板。关于参数模板的更多详情，请参见参数模板管理。
- 您可以选择系统参数模板，也可以单击下拉列表右侧的查看参数模板前往参数模板页创建自定义模板。具体操作步骤，请参见创建参数模板。
- 若该配置项留空，表示不选择任何参数模板，此时实例的所有参数均使用默认参数值。
- 若您选择了自定义参数模板，但自定义参数模板中并没有包含实例支持的所有参数，那么创建实例时会将参数模板中的参数值配置到实例中，而未在该参数模板中的参数则使用默认值。
计费信息计费类型您可以选择按量计费或包年包月。说明若选择计费类型为选择包年包月，您需要确认购买时长，同时您还可以勾选到期自动续费，系统会在实例到期前自动续费。
- 在页面左下角选择实例购买数量，在右下角单击确认订单。
说明
- 每次需至少购买 1 个实例，最多可同时购买 10 个实例。
- 每个火山引擎主账号在每个地域下默认最多可购买 30 个 MongoDB 实例。若您需要调整配额购买更多实例，请前往配额中心提交配额申请。
- 若您设置了实例名称且同时购买了多个实例，系统会根据相应规则在实例名称末尾添加编号作为区分。更多详情，请参见创建实例参数配置表中实例名称的规则说明。
- 根据您选择的计费类型完成后续步骤。
- 计费类型操作步骤计费类型操作步骤按量计费在确认订单页面，确认订单详情，阅读并勾选服务条款，单击立即购买。包年包月
- 在确认订单页面，确认订单详情，阅读并勾选服务条款，单击提交订单。
- 在确认订单信息页面，再次确认订单详情，单击下一步。
- 在提交支付信息页面，确认支付明细并选择支付方式，单击去支付。
相关 API
API | 描述 |
API | 描述 |
调用 CreateDBInstance 接口创建 MongoDB 实例。 | |
调用 DescribeRegions 接口查询文档数据库 MongoDB 版可用的地域资源列表。 | |
调用 DescribeAvailabilityZones 接口查询文档数据库 MongoDB 版在指定地域下的可用区资源列表。 |
最近更新时间：2026.10.13 14:26:17
这个页面对您有帮助吗？
有用
有用
无用
无用