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

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

前提条件

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

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

通过控制台切换网络类型

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

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

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

在混访期间，您可以根据需求随时调整保留原经典网络的时间，过期时间会从变更日期重新开始计时。例如，原经典网络的内网地址会在2017年8月18日过期，但您在2017年8月15日将过期时间变更为14天后，则原经典网络的内网地址将会在2017年8月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/6/9.
  */
 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", "<您的AK>",
             "<您的Security>");
         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", "<您的AK>",
             "<您的Security>");
         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", "<你的ak>",
             "<你的sk>");
     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();
     }
 }