指定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地址没有被占用。

配置示例

指定私网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"
    }
  ]
}

确认实例的私网IP地址。

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

在ECI实例列表中，IP地址列显示实例已被分配的私网IP地址（例如172.16.0.1）。