调用 ModifyDBInstanceSubnet 接口将目标 Redis 实例绑定到指定子网。

请求类型

异步请求。

注意事项

• 自 2022 年 05 月 17 日起，新开通 Redis 产品的客户以及存量实例都需要进行跨服务访问授权。请您尽快完成授权，否则调用 CreateDBInstance、ModifyDBInstanceSubnet、CreateDBEndpointPublicAddress 等接口时将会报错。
  跨服务访问授权方法如下：
  • 通过 Redis 控制台授权，详细操作步骤，请参见跨服务访问授权。
  • 调用 CreateServiceLinkedRole（ServiceName 为 Redis）接口完成跨服务授权。
• 针对创建时间早于 2022 年 05 月 17 日的实例，您可以通过该接口将实例绑定至目标私网，来完成网络安全升级。关于网络安全升级的更多信息，请参见网络安全升级。

操作影响

• 变更网络配置（包括修改私有网络或子网）过程中，所有连接地址（如私网地址、直连地址、公网地址）都可能会发生 1~2 次连接闪断，请谨慎操作。建议在业务低峰期执行变更操作，并确保业务具备自动重连机制。
• 修改私有网络和子网不会改变私网地址或直连地址域名，但其对应的 IP 地址将会发生变化，请确保业务使用域名进行连接，并且业务所在网络环境与新配置的网络环境能够互通。
• 请及时对客户端缓存进行清理，否则可能会出现读写异常的情况。
• 修改私有网络和子网会短暂影响 DTS、DBW 等数据库生态产品的使用。

请求参数

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

示例

请求示例

POST https://redis.volcengineapi.com/?Action=ModifyDBInstanceSubnet&Version=2020-12-07 HTTP/1.1
Host: redis.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=****
{
	"InstanceId": "redis-cn0212gzmh2xs****",
	"VpcId": "vpc-1g15j0fvgmt4w8ibuxwjl****",
	"SubnetId": "subnet-1g15t8rj4uigw8ibuxxij****"
}

返回示例

{
     "ResponseMetadata": {
          "RequestId": "2022042510294601022524308102C5****",
          "Action": "ModifyDBInstanceSubnet",
          "Version": "2020-12-07",
          "Service": "Redis",
          "Region": "cn-beijing",
     },
     "Result": null
}

错误码

更多详情，请参见错误码。