文档中心

云数据库 MySQL 版

请输入

白名单管理

升级白名单

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

背景信息

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

在云数据库 MySQL 版控制台，我们会对实例使用的白名单管理功能的版本进行识别和提示。如果在控制台中实例的数据安全页签下看到以下提示，则说明该实例当前使用的白名单管理功能为 v1 版本，需要进行升级；如果在控制台中实例的数据安全页签下未出现以下提示，则说明实例使用的已经是 v2 版本的白名单管理功能，无需升级。

新建实例会自动使用 v2 版本的白名单管理功能，存量实例则需要根据业务需要决定是否升级白名单管理功能和升级时间。

注意事项

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

如果您没有使用 Open API ，也没有第三方业务通过 Open API 管理您的实例，则只需按照本文进行升级。升级白名单功能不会对业务产生影响。

如果您使用了 Open API ，则需选择合适的时机，对业务代码做修改和适配。更多详细内容，请参见白名单相关接口升级说明。

前提条件

实例状态为运行中，且在控制台中实例的数据安全页签下看到升级的横幅提示。

操作步骤

登录云数据库 MySQL 版控制台。

在顶部菜单栏选择白名单所属的地域。

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

在实例列表页面，单击目标实例名称，再单击数据安全，进入数据安全页签。

在数据安全页签，单击页面顶部横幅中的立即升级。

在弹出的立即升级窗口中，阅读并确认升级收益与风险提示后，单击确定。

最近更新时间：2026.10.09 18:07:11

这个页面对您有帮助吗？

有用

无用