文档数据库 MongoDB 版
文档数据库 MongoDB 版
文档指南
请输入
- 文档首页
文档数据库 MongoDB 版用户指南数据安全白名单管理编辑白名单
复制全文
下载 pdf编辑白名单
文档反馈
问问助手文档数据库 MongoDB 版实例创建成功后，您需要为实例设置白名单，以允许外部设备访问该实例。本文介绍如何编辑白名单，包括修改白名单名称、IP 地址，以及是否设置为默认白名单。
使用限制
- 每个火山引擎主账号在每个地域下最多可以创建 500 个 IP 白名单。
- 每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单，即原有默认白名单会自动变为非默认白名单。
- 每个白名单中最多添加 1000 个 IP 地址（或 CIDR 格式的 IP 地址段）。
- 每个白名单最多支持绑定 500 个实例。
- 每个白名单每次可最多批量绑定 200 个实例。
- 每个实例最多支持绑定 100 个白名单，但每个实例绑定的所有白名单中，IP 地址或 CIDR 格式的 IP 地址段的总和不可超过 1000 个。
- 每个实例每次可最多批量绑定 100 个白名单。
- 如果一个实例没有绑定任何白名单，表示禁止所有地址访问。
操作步骤
- 登录 MongoDB 控制台。
- 在顶部菜单栏，选择实例所属的项目和地域。
- 在左侧导航栏中，选择 NoSQL 数据库 > MongoDB > 白名单列表。
- 在白名单列表页，找到目标白名单，并根据业务需要执行对应操作。
- 操作类型操作步骤修改白名单名称
- 将鼠标放置在目标白名单名称上，单击名称旁边的
图标。
- 在弹出的对话框中输入新的名称。
说明名称需同时满足如下要求：- 不能以数字、中划线（-）开头。
- 只能包含中文、字母、数字、下划线（_）和中划线（-）。
- 长度需为 1~128 个字符。
- 单击确定。
修改白名单 IP 地址- 单击目标白名单名称。
说明您也可以在 MongoDB 实例的数据安全页签找到目标白名单，具体方法如下：- 登录 MongoDB 控制台。
- 在顶部菜单栏，选择实例所属的项目和地域。
- 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。
- 在目标实例类型列表页，单击目标实例名称。
- 在实例详情页，单击数据安全页签。
- 在白名单子页签下的白名单列表中，找到并单击目标白名单名称。
- 在弹出的白名单详情面板中，单击白名单信息后的编辑。
- 在编辑白名单信息控制面板的 IP地址对话框中，输入 IP 地址或 CIDR 格式的地址段。
说明- 不允许设置重复的地址，多个地址间用英文逗号（,）隔开。
- 设置 0.0.0.0/0，表示允许所有地址访问。
- 设置 127.0.0.1，表示禁止所有地址访问。
- 同时设置 0.0.0.0/0 和 127.0.0.1，表示允许所有地址访问。
- 设置 CIDR 192.168.1.0/24，表示允许该网段内的 IP 地址访问。
- 设置 192.168.1.1，表示仅允许该 IP 地址访问。
- 单击确定。
- 在弹出的对话框中，单击确定。
说明此次修改将会应用到绑定到该白名单的所有实例。设置默认白名单- 单击目标白名单名称。
说明您也可以在 MongoDB 实例的数据安全页签找到目标白名单，具体方法如下：- 登录 MongoDB 控制台。
- 在顶部菜单栏，选择实例所属的项目和地域。
- 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。
- 在目标实例类型列表页，单击目标实例名称。
- 在实例详情页，单击数据安全页签。
- 在白名单子页签下的白名单列表中，找到并单击目标白名单名称。
- 在弹出的白名单详情面板中，单击白名单信息后的编辑。
- 在编辑白名单信息控制面板中的默认白名单后面，根据业务需要选择是否需要将当前白名单设置为默认白名单。
说明- 设置为默认白名单后，新建实例时会自动选中默认白名单。
- 每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单，即原有默认白名单会自动变为非默认白名单。更多详情，请参见约束与限制。
- 单击确定。
绑定实例和白名单解绑实例和白名单删除白名单 - 将鼠标放置在目标白名单名称上，单击名称旁边的
相关 API
API | 描述 |
调用 DescribeAllowLists 接口查询当前账号下指定地域内的 IP 白名单列表。 | |
调用 DescribeAllowListDetail 接口查询目标白名单的详细信息，包括 IP 地址和绑定的实例详情。 | |
调用 ModifyAllowList 接口修改目标白名单设置（例如白名单名称、IP 白名单地址、是否设置为默认白名单等）。 | |
调用 AssociateAllowList 接口将目标 MongoDB 实例绑定到指定 IP 白名单。 | |
调用 DisassociateAllowList 接口将目标 MongoDB 实例与指定白名单解绑。 | |
调用 DeleteAllowList 接口删除目标白名单。 |
最近更新时间：2026.09.14 16:01:31
这个页面对您有帮助吗？
有用
有用
无用
无用