云数据库Redis版网络切换 - 最佳实践| 阿里云

本文档介绍了如何通过控制台和API将云数据库Redis版的网络类型切换至专有网络，同时保留经典网络的访问地址。经典网络的访问地址有保留时间限制，您可以根据需要指定保留期限。到期后，经典网络地址会自动被系统删除。

前提条件

在开始切换前，确认当前实例是否具备以下切换条件：

您已经注册了阿里云账号。如还未注册，请先完成账号注册。详细信息，请参见账号注册。
确认当前网络类型是否为经典网络。
确认在当前数据库实例可用区下是否有可用的VPC和交换机。详细信息，请参见使用专有网络。

通过控制台切换网络类型

登录Redis管理控制台。
选择目标实例所在地域。
单击目标实例的ID。
在实例信息页面，单击切换为专有网络。
在切换为专有网络对话框中，执行以下操作：
1. 选择切换的目标专有网络和交换机。
2. 选择保留经典网络地址并选择保留时长。
  
  说明选择保留经典网络地址后，专有网络地址和经典网络地址是两个不同的地址。经典网络下的ECS仍可访问数据，对业务无影响。当经典网络地址到期后，系统会自动删除经典网络地址，您将无法通过经典网络地址访问数据库。
3. 单击确定。
在实例信息页面，单击刷新查看专有网络和经典网络的访问地址。

通过控制台修改经典网络内网地址使用期限

设置经典网络访问地址的保留时间后，您可以在过期前通过控制台延长其保留时间。

在混访期间，您可以根据需求随时调整保留原经典网络的时间，过期时间会从变更日期重新开始计时。例如，原经典网络的内网地址会在2017年08月18日过期，但您在2017年08月15日将过期时间变更为14天后，则原经典网络的内网地址将会在2017年08月29日被释放。

登录Redis管理控制台。
选择目标实例所在地域。
单击目标实例的ID。
在预留的经典IP地址区域，单击修改过期时间。
在弹出的修改过期时间对话框中，选择新的过期时间，然后单击确定。

通过API切换网络类型

单击SDK链接下载相关SDK。（云数据库Memcache版和Redis版的SDK相同。）

调用SwitchNetwork接口进行网络切换。

请求参数说明


名称	类型	是否必须	说明
Action	String	是	系统规定参数，取值： SwitchNetwork
InstanceId	String	是	实例 ID。
TargetNetworkType	String	是	实例的网络类型： VPC：专有网络 Classic：经典网络
VPCId	String	否	专有网络的ID。
VSwitchId	String	否	交换机的ID。如果指定了VPC ID，则该参数也必须指定。
RetainClassic	String	否	是否保留经典网络地址，默认False： True：保留 False：不保留
ClassicExpiredDays	String	否	经典网络地址保留的天数，最短1天，最长120天，默认7天。若选择保留经典网络地址，则该参数必传。

返回参数说明


参数	类型	说明
RequestId	String	请求ID。
TaskId	String	任务ID。

参考代码

import com.aliyuncs.DefaultAcsClient;
 import com.aliyuncs.IAcsClient;
 import com.aliyuncs.exceptions.ClientException;
 import com.aliyuncs.exceptions.ServerException;
 import com.aliyuncs.profile.DefaultProfile;
 import com.aliyuncs.profile.IClientProfile;
 import com.aliyuncs.r_kvstore.model.v20150101.SwitchNetworkRequest;
 import com.aliyuncs.r_kvstore.model.v20150101.SwitchNetworkResponse;
 import org.junit.Test;
 /**
  * Created by wb259286 on 2017/06/09.
  */
 public class SwitchNetworkTest {
     @Test
     public  void switchNetwork_success() {
         SwitchNetworkRequest request=new SwitchNetworkRequest();
         request.setInstanceId("<您的实例ID>");
         request.setTargetNetworkType("VPC");
         request.setVpcId("<VpcId:当TargetNetworkType为VPC时必填>");
         request.setVSwitchId("<VSwitchId:当TargetNetworkType为VPC时必填>");
         request.setRetainClassic("<是否保留CLASSIC的网络链接，True保留，False不保留>");
         request.setClassicExpiredDays("保留CLASSIC的网络链接的天数");
         IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<您的AccessKey ID>",
             "<您的AccessKey Secret>");
         IAcsClient client = new DefaultAcsClient(profile);
         try {
             SwitchNetworkResponse response
                 = client.getAcsResponse(request);
             System.out.println(response.getRequestId());
     }catch (ServerException e) {
             e.printStackTrace();
     }
         catch (ClientException e) {
             e.printStackTrace();
         }
     }
 }

调用DescribeDBInstanceNetInfo接口查看经典网络和专有网络的访问地址。

请求参数说明


名称	类型	是否必须	说明
Action	String	是	系统规定参数，取值： DescribeDBInstanceNetInfo
InstanceId	String	是	实例ID。

返回参数说明


参数	类型	说明
NetInfoItems	List	实例的连接信息。
InstanceNetworkType	String	实例的网络类型： VPC：VPC类型的实例。 Classic：经典网络类型的实例。

InstanceNetInfo数据结构


参数	类型	说明
ConnectionString	String	DNS连接串。
IPAddress	String	IP地址。
IPType	String	经典网络类型的实例的IP类型有： Inner：私网。 Public：公网。 VPC类型的实例的IP类型有： Private ：私网。 Public：公网。
Port	String	端口信息。
VPCId	String	VPC ID。
VSwitchId	String	交换机ID。
ExpiredTime	String	过期时间。

参考代码

import com.aliyuncs.DefaultAcsClient;
 import com.aliyuncs.IAcsClient;
 import com.aliyuncs.exceptions.ClientException;
 import com.aliyuncs.exceptions.ServerException;
 import com.aliyuncs.profile.DefaultProfile;
 import com.aliyuncs.profile.IClientProfile;
 import com.aliyuncs.r_kvstore.model.v20150101.DescribeDBInstanceNetInfoRequest;
 import com.aliyuncs.r_kvstore.model.v20150101.DescribeDBInstanceNetInfoResponse;
 import org.junit.Test;
 /**
  *
  */
 public class DescribeDBInstanceNetInfoTest {
 @Test
     public  void describeDBInstanceNetInfo_success() {
         DescribeDBInstanceNetInfoRequest request=new     DescribeDBInstanceNetInfoRequest();
         request.setInstanceId("<您的实例ID>");
         IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<您的AccessKey ID>",
             "<您的AccessKey Secret>");
         IAcsClient client = new DefaultAcsClient(profile);
         try {
             DescribeDBInstanceNetInfoResponse response
                 = client.getAcsResponse(request);
             System.out.println(response.getRequestId());
     }catch (ServerException e) {
             e.printStackTrace();
         }
         catch (ClientException e) {
         e.printStackTrace();
         }
     }
 }

通过API修改经典网络内网地址使用期限

单击SDK链接下载相关SDK。（云数据库Memcache版和Redis版的SDK相同。）

调用ModifyInstanceNetExpireTime接口进行网络切换。

请求参数说明


名称	类型	是否必须	说明
Action	String	是	系统规定参数，取值： ModifyInstanceNetExpireTime。
InstanceId	String	是	实例ID。
ConnectionString	String	是	经典网络的访问域名。
ClassicExpiredDays	Integer	是	选择保留时长。取值：14、30、60或120

返回参数说明


参数	类型	说明
RequestId	String	请求ID。

参考代码

public static void main(String[] args) {
     ModifyInstanceNetExpireTimeRequest request = new ModifyInstanceNetExpireTimeRequest();
     request.setClassicExpiredDays(3);
     request.setConnectionString("<链接字符串>");
     request.setInstanceId("<您的实例ID>");
     IClientProfile profile
             = DefaultProfile.getProfile("cn-hangzhou", "<您的AccessKey ID>",
             "<您的AccessKey Secret>");
     IAcsClient client = new DefaultAcsClient(profile);
     try {
         ModifyInstanceNetExpireTimeResponse response
                 = client.getAcsResponse(request);
         for (NetInfoItem item:response.getNetInfoItems()) {
             System.out.println(item.getConnectionString());
             System.out.println(item.getPort());
             System.out.println(item.getDBInstanceNetType());
             System.out.println(item.getIPAddress());
             System.out.println(item.getExpiredTime());
         }
     }catch (ServerException e) {
         e.printStackTrace();
     }
     catch (ClientException e) {
         e.printStackTrace();
     }
 }