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

前提条件

在开始切换前,确认当前实例是否具备以下切换条件:
  • 您已经注册了阿里云账号。如还未注册,请先完成账号注册。详细信息,请参见账号注册
  • 确认当前网络类型是否为经典网络。
  • 实例类型必须是MongoDB副本集。
  • 确认在当前数据库实例可用区下是否有可用的VPC和交换机。详情参见创建专有网络

通过控制台切换网络类型

  1. 登录MongoDB管理控制台
  2. 找到目标实例,单击实例ID或单击目标实例操作列的管理
  3. 在左侧导航栏,单击数据库连接页签,然后单击切换为专有网络
  4. 在弹出的对话框中,执行以下操作:
    1. 选择切换的目标专有网络和交换机。
    2. 选择保留经典网络地址并选择保留时长。
      说明 选择保留经典网络后,经典网络下的ECS仍可访问数据,对业务无影响。当经典网络地址到期后,系统会自动删除经典网络地址,您将无法通过经典网络地址访问数据库。
    3. 单击确定
  5. 数据库连接页面,单击刷新查看专有网络和经典网的访问地址。


通过API切换网络类型

  1. 单击SDK链接下载相关SDK。
  2. 调用ModifyDBInstanceNetworkType接口进行网络切换。
    请求参数说明
    名称 类型 是否必须 说明
    Action String 系统规定参数,取值:

    ModifyDBInstanceNetworkType

    DBInstanceId String 实例 ID。
    NetworkType 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。
  3. 调用DescribeReplicaSetRole接口查看经典网络和专有网络的访问地址。
    请求参数说明
    名称 类型 是否必须 说明
    Action String 系统规定参数,取值:

    DescribeReplicaSetRole

    DBInstanceId String 实例ID。
    返回参数说明
    参数 类型 说明
    ReplicaSets List 复制集角色列表。
    DBInstanceId String 实例 ID。
    ReplicaSetRole数据结构
    参数 类型 说明
    ReplicaSetRole String 复制集角色:Primary | Secondary
    ConnectionDomain String 实例连接域名。
    ConnectionPort String 实例连接端口。
    ExpiredTime String 经典网络地址剩余时长,以秒为单位。
    NetworkType String 实例的网络类型:
    • VPC:专有网络
    • Classic:经典网络