You need to enable JavaScript to run this app.
导航
编辑白名单
最近更新时间:2025.04.24 20:19:22首次发布时间:2022.04.12 10:59:01
我的收藏
有用
有用
无用
无用

文档数据库 MongoDB 版实例创建成功后,您需要为实例设置白名单,以允许外部设备访问该实例。本文介绍如何编辑白名单,包括修改白名单名称、IP 地址,以及是否设置为默认白名单。

使用限制

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

操作步骤

  1. 登录 MongoDB 控制台
  2. 在顶部菜单栏的左上角,选择实例所属的项目和地域。
  3. 在左侧导航栏中,选择 NoSQL数据库 > MongoDB > 白名单列表
  4. 白名单列表页,找到目标白名单,并根据业务需要执行对应操作。
    操作类型操作步骤

    修改白名单名称

    1. 将鼠标放置在目标白名单名称上,单击名称旁边的图标。
    2. 在弹出的对话框中输入新的名称。

      说明

      名称需同时满足如下要求:

      • 不能以数字、中划线(-)开头。
      • 只能包含中文、字母、数字、下划线(_)和中划线(-)。
      • 长度需为 1~128 个字符。
    3. 单击确定

    修改白名单 IP 地址

    1. 单击目标白名单名称。

      说明

      您也可以在 MongoDB 实例的数据安全页签找到目标白名单,具体方法如下:

      1. 登录 MongoDB 控制台
      2. 在顶部菜单栏的左上角,选择实例所属的项目和地域。
      3. 根据实例类型,在左侧导航栏中选择副本集实例列表分片集实例列表
      4. 在目标实例类型列表页,单击目标实例名称。
      5. 在实例详情页,单击数据安全页签。
      6. 白名单子页签下的白名单列表中,找到并单击目标白名单名称。
    2. 在弹出的白名单详情面板中,单击白名单信息后的编辑
    3. 编辑白名单信息控制面板的 IP地址对话框中,输入 IP 地址或 CIDR 格式的地址段。

      说明

      • 不允许设置重复的地址,多个地址间用英文逗号(,)隔开。
      • 设置 0.0.0.0/0,表示允许所有地址访问。
      • 设置 127.0.0.1,表示禁止所有地址访问。
      • 同时设置 0.0.0.0/0127.0.0.1,表示允许所有地址访问。
      • 设置 CIDR 192.168.1.0/24,表示允许该网段内的 IP 地址访问。
      • 设置 192.168.1.1,表示仅允许该 IP 地址访问。
    4. 单击确定
    5. 在弹出的对话框中,单击确定

      说明

      此次修改将会应用到绑定到该白名单的所有实例。

    设置默认白名单

    1. 单击目标白名单名称。

      说明

      您也可以在 MongoDB 实例的数据安全页签找到目标白名单,具体方法如下:

      1. 登录 MongoDB 控制台
      2. 在顶部菜单栏的左上角,选择实例所属的项目和地域。
      3. 根据实例类型,在左侧导航栏中选择副本集实例列表分片集实例列表
      4. 在目标实例类型列表页,单击目标实例名称。
      5. 在实例详情页,单击数据安全页签。
      6. 白名单子页签下的白名单列表中,找到并单击目标白名单名称。
    2. 在弹出的白名单详情面板中,单击白名单信息后的编辑
    3. 编辑白名单信息控制面板中的默认白名单后面,根据业务需要选择是否需要将当前白名单设置为默认白名单。

      说明

      • 设置为默认白名单后,新建实例时会自动选中默认白名单。
      • 每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单,即原有默认白名单会自动变为非默认白名单。更多详情,请参见约束与限制
    4. 单击确定
    绑定实例和白名单详细操作步骤,请参见绑定实例和白名单
    解绑实例和白名单详细操作步骤,请参见解绑实例和白名单
    删除白名单详细操作步骤,请参见删除白名单

相关 API

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