文档

指定ECI实例的私网IP地址

更新时间:

某些业务场景下,可能需要某一业务实例使用某个固定的IP地址。本文介绍在创建ECI实例时,如何指定实例的私网IP地址。

功能说明

默认情况下,创建ECI实例时,系统会从配置的交换机网段中,随机为实例分配一个私网IP地址。某些业务场景下,您可能想要指定实例的私网IP地址。例如迁移业务时,在删除了旧的ECI实例后,可以为新创建的ECI实例指定使用旧实例对应的IP地址,以此来保证业务连续性。

使用限制

指定私网IP地址功能仅支持IPv4地址,不支持IPv6地址。

配置说明

调用CreateContainerGroup接口创建ECI实例时,您可以通过PrivateIpAddress参数指定实例的私网IP地址。相关参数说明如下表所示。更多信息,请参见CreateContainerGroup

名称

类型

示例值

描述

VSwitchId

String

vsw-bp1gds63lmlm7ib05****

实例所属的交换机。

指定私网IP地址的场景下,必须要指定交换机。

SecurityGroupId

String

sg-bp1daxpbz9lzpvvc****

实例所属的安全组。

指定交换机的情况下,必须要指定安全组。

PrivateIpAddress

string

172.16.0.1

指定交换机网段下某一私网IP地址。请确保该IP地址没有被占用。

配置示例

  1. 指定私网IP地址创建一台ECI实例。

    调用CreateContainerGroup接口创建ECI实例所采用的参数示例如下:

    {
      "RegionId": "cn-beijing",
      "SecurityGroupId": "sg-2ze1pjtsbqcuykpp****",
      "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
      "PrivateIpAddress": "172.16.0.1",
      "ContainerGroupName": "test",
      "Container": [
        {
          "Name": "nginx",
          "Image": "registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.14.2"
        }
      ]
    }
  2. 确认实例的私网IP地址。

    您可以根据返回的实例ID调用DescribeContainerGroups接口查询获取实例的私网IP地址(IntranetIp字段),也可以直接在控制台查看。

    示例如下:

    指定IP.png