You need to enable JavaScript to run this app.
导航
绑定实例和白名单
最近更新时间:2025.06.06 10:43:24首次发布时间:2022.04.12 10:59:01
我的收藏
有用
有用
无用
无用

文档数据库 MongoDB 版实例创建成功后,您需要为实例设置白名单,以允许外部设备访问该实例。本文介绍如何通过控制台绑定实例和白名单。

前提条件

已创建白名单。白名单创建方法,请参见创建白名单

使用限制

  • 每个火山引擎主账号在每个地域下最多可以创建 100 个 IP 白名单。
  • 每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单,即原有默认白名单会自动变为非默认白名单。
  • 每个 IP 白名单中最多添加 1000 个 IP 地址或 CIDR 格式的 IP 地址段。
  • 每个白名单最多支持绑定 200 个实例,每次可最多批量绑定 50 个实例。
  • 每个实例最多支持绑定 100 个白名单,每次可最多批量绑定 100 个白名单。
  • 如果一个实例没有绑定任何白名单,表示禁止所有地址访问。

操作步骤

您可以选择以下任意一种方式来绑定实例和白名单。

方法一:绑定实例至当前白名单

  1. 登录 MongoDB 控制台
  2. 在顶部菜单栏的左上角,选择实例所属的项目和地域。
  3. 在左侧导航栏中,选择 NoSQL 数据库 > MongoDB > 白名单列表
  4. 白名单列表页,单击目标白名单右侧操作栏中的绑定实例
  5. 在弹出的控制面板中,勾选需要加入至当前白名单的实例。
  6. 单击确定

方法二:绑定白名单至当前实例

  1. 登录 MongoDB 控制台
  2. 在顶部菜单栏的左上角,选择实例所属的项目和地域。
  3. 根据实例类型,在左侧导航栏中选择副本集实例列表分片集实例列表
  1. 在目标实例类型列表页,单击目标实例名称。
  2. 在实例详情页,单击数据安全页签。
  3. 数据安全页签下,单击绑定白名单
  4. 在弹出的控制面板中,先确认实例名称和所属项目信息,再根据选择的绑定模式,完成后续操作。
    • 若选择了已有白名单(即绑定已有白名单至当前实例),您需要:
      1. 已有白名单列表中勾选需要绑定的白名单。
      2. 单击确定
    • 若选择了新白名单(即创建一个新的白名单,并自动绑定至当前实例)您需要:
      1. 所属项目下拉列表中,为新建白名单选择需要加入的项目,默认会加入 default 项目。
      2. 输入新的白名单名称、描述(选填)和 IP 地址。
      3. 单击确定

      说明

      • 关于创建白名单时的名称、描述和 IP 地址配置的更多说明,请参见创建白名单
      • 若通过子用户使用 MongoDB 云服务,您只能看到已为当前子用户授权项目下的白名单信息。更多详情,请参见通过子用户使用 MongoDB 云服务

相关 API

API
描述
DescribeAllowLists调用 DescribeAllowLists 接口查询当前账号下指定地域内的 IP 白名单列表。
DescribeAllowListDetail调用 DescribeAllowListDetail 接口查询目标白名单的详细信息,包括 IP 地址和绑定的实例详情。
AssociateAllowList调用 AssociateAllowList 接口将目标 MongoDB 实例绑定到指定 IP 白名单。
API描述
CreateAllowList调用 CreateAllowList 接口创建一个新的 IP 白名单。
DescribeAllowLists调用 DescribeAllowLists 接口查询当前账号下指定地域内的 IP 白名单列表。
DescribeAllowListDetail调用 DescribeAllowListDetail 接口查询目标白名单的详细信息,包括 IP 地址和绑定的实例详情。
ModifyAllowList调用 ModifyAllowList 接口修改目标白名单设置(例如白名单名称、IP 白名单地址、是否设置为默认白名单等)。
AssociateAllowList调用 AssociateAllowList 接口将目标 MongoDB 实例绑定到指定 IP 白名单。
DisassociateAllowList调用 DisassociateAllowList 接口将目标 MongoDB 实例与指定白名单解绑。
DeleteAllowList调用 DeleteAllowList 接口删除目标白名单。