2022 年 05 月 17 日上线版本所涉及 API 的改动及兼容说明

为了给您提供更加优质的服务，火山引擎缓存数据库 Redis 版在 2022 年 05 月 17 日发布的版本中，针对创建实例和白名单功能涉及的 OpenAPI 作了调整。

变更开始时间

2022 年 05 月 17 日 20 时

影响范围

跨服务访问授权

自 2022 年 05 月 17 日起，新开通 Redis 产品的客户以及存量实例都需要进行跨服务访问授权。跨服务访问授权方法如下：

• 通过 Redis 控制台授权，详细操作步骤，请参见跨服务访问授权。
• 调用 CreateServiceLinkedRole（ServiceName 为 Redis）接口完成跨服务授权。

创建实例

• 由于Redis新增支持在创建实例时选择子网，故在 CreateDBInstance 接口中新增了 SubnetId 字段。当前为了兼容老 API，该参数暂为选填参数。请您尽快将其改为必填，否则之后调用 CreateDBInstance 接口时将报错。

• 针对创建时间早于 2022 年 05 月 17 日的实例，您需要尽快将实例的私网 IP 地址升级至您 VPC 内的私有地址。您可以通过如下任一方式完成网络升级：

  • 通过 Redis 控制台升级。具体步骤，请参见网络安全升级。
  • 通过 ModifyDBInstanceSubnet 接口升级。

白名单

• Redis 现已推出新版的白名单管理功能，支持批量化管理。您可以通过如下任一方式在线切换到新版白名单功能，升级过程不会影响数据库的正常使用：
  • 通过 Redis 控制台升级。具体步骤，请参见设置白名单。
  • 通过 UpgradeAllowListVersion 接口升级。
• 请您尽快完成升级，否则后续将由火山引擎强制升级。白名单功能升级后，将不再支持调用老的白名单管理接口（即 DescribeDBInstanceSecurityIps 和 UpdateDBInstanceSecurityIps）。
• 升级后，您需要使用如下新 OpenAPI 接口来管理白名单：
  • 创建白名单：CreateAllowList
  • 查看白名单列表：DescribeAllowLists
  • 查看白名单详情：DescribeAllowListDetail
  • 修改白名单：ModifyAllowList
  • 绑定白名单：AssociateAllowList
  • 解绑白名单：DisassociateAllowList
  • 删除白名单：DeleteAllowList