升级白名单

本文介绍为云数据库 PostgreSQL 版实例升级白名单管理功能的操作步骤。

背景信息

为使白名单管理更加高效和便捷，云数据库 PostgreSQL 版于 2024 年 4 月 25 日全面上线了新版的白名单管理功能。新版的白名单管理功能实现了白名单与实例的解耦，白名单与实例相互独立，一个白名单可以绑定到多个实例，一个实例也可以绑定多个白名单，支持批量管理，更加贴合实际业务场景。例如，可以按照应用服务器来组织白名单，增加一台应用服务器只需要调用一次 Open API，即可达到批量管理多个实例的效果。

新版白名单管理功能提供了新的 Open API 接口。新老版本的白名单 Open API 不能互通，在新版本接口发布后，老版本接口会被逐步废弃，不再支持调用。

升级说明

如果在控制台中实例的数据安全页签下看到以下提示，需要为实例升级白名单管理功能。关于升级白名单管理功能的详细信息，请参见升级白名单管理功能。

• 如果您使用了 Open API ，需要在升级白名单管理功能并对业务代码做修改和适配。新老版本白名单差异请参见新老版本白名单接口使用方式差异。

• 如果在使用新版白名单管理功能过程中，遇到“The AllowListVersion is not valid.”的提示，可能是因为调用的接口版本与实例的白名单管理功能版本不一致导致，请参照新老版本白名单接口使用方式差异进行改造。

升级白名单管理功能

可通过控制台或 Open API 完成白名单管理功能的升级。

• 通过控制台

  1. 登录云数据库 PostgreSQL 版控制台。

  2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。

     说明

     如未设置实例的所属项目，本操作应选择项目为账号全部资源。

  3. 在左侧导航栏单击实例列表。

  4. 在实例列表页面，单击目标实例名称。

  5. 在页面上方，单击数据安全页签。

  6. 单击数据安全页签下横幅消息的立即升级。

  7. 在弹出的立即升级对话框中，单击确定。

     说明

     • 升级完成后，实例之前绑定的所有 IP 白名单组中的 IP，会合并为一个名为“实例ID的白名单”的白名单，并与实例绑定。
     • 升级白名单管理功能的过程中，会对 IP 地址进行规范化处理，将未采用 CIDR 格式的 IP 地址统一规范为标准 CIDR 格式表示（/32）。例如，原地址为 127.0.0.1，升级后会被规范为 127.0.0.1/32。已采用了 CIDR 格式表述的 IP 地址或地址段不做处理。

• 通过 Open API

  调用 UpgradeAllowListVersion 接口，即可完成升级。

新老版本白名单接口使用方式差异

如果您使用了 Open API ，需要在升级白名单管理功能后，选择合适的时机，对业务代码做修改和适配。

相关 API