调用CreateNetworkInterface创建一个弹性网卡（ENI）。
接口说明
- 新创建的弹性网卡处于可用（Available）状态。
- 弹性网卡只支持附加到同一可用区的VPC类型实例。
- 一个弹性网卡只能附加到一台实例。附加到新实例之前您需要将其与当前实例分离。
- 弹性网卡重新附加到另一台实例时，其属性不变，网络流量也会重定向到新的实例。
- 一个账号在一个阿里云地域内默认最多可创建100个弹性网卡。如果需要更多，请提交工单申请。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 否 | CreateNetworkInterface |
系统规定参数。取值：CreateNetworkInterface |
| RegionId | String | 是 | cn-hangzhou |
实例所在地域的ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| VSwitchId | String | 是 | vsw-bp1s5fnvk4gn2tws03*** |
指定VPC的交换机ID。 |
| Tag.N.Key | String | 否 | test |
弹性网卡的标签键。N的取值范围：1~20。一旦传入该值，则不允许为空字符串。最多支持128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。 |
| Tag.N.Value | String | 否 | api |
弹性网卡的标签值。N的取值范围：1~20。一旦传入该值，可以为空字符串。最多支持128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。 |
| ResourceGroupId | String | 否 | rg-bp67acfmxazb4ph*** |
资源组ID。 |
| PrimaryIpAddress | String | 否 | 172.17.**.*** |
弹性网卡的主私有IP地址。 指定IP必须是在所属交换机的地址段内的空闲地址，不指定则默认随机分配该交换机中的空闲地址。 |
| SecurityGroupId | String | 否 | sg-bp1fg655nh68xyz9i*** |
加入一个安全组。安全组和弹性网卡必须在同一个专有网络VPC中。 |
| SecurityGroupIds.N | RepeatList | 否 | sg-bp1fg655nh68xyz9i*** |
加入一个或多个安全组。安全组和弹性网卡必须在同一个专有网络VPC中。N的取值范围与弹性网卡能够加入安全组配额有关，更多详情，请参见使用限制。 说明 不支持同时指定
SecurityGroupId和SecurityGroupIds.N。
|
| NetworkInterfaceName | String | 否 | eni-eniname1 |
弹性网卡名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。 默认值：空。 |
| Description | String | 否 | test |
弹性网卡的描述信息。长度为2~256个英文或中文字符，不能以http://和https://开头。 默认值：空。 |
| PrivateIpAddress.N | RepeatList | 否 | 172.***.***.177 |
从弹性网卡所属交换机的CIDR地址段内的空闲地址中选择一个或多个辅助私有IP地址。N的取值范围： 说明 分配辅助私有IP地址时，您不能同时指定参数
PrivateIpAddress.N和参数SecondaryPrivateIpAddressCount。
|
| SecondaryPrivateIpAddressCount | Integer | 否 | 1 |
指定私有IP地址数量，让ECS为您自动创建IP地址。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见如何保证幂等性。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
| NetworkInterfaceId | String | eni-bp14v2sdd3v8htlnm*** |
弹性网卡ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateNetworkInterface
&RegionId=cn-hangzhou
&SecurityGroupIds.1=sg-bp1fg655nh68xyz9i***
&SecurityGroupIds.2=sg-bp67acfmxazb4ph***
&VSwitchId=vsw-bp1s5fnvk4gn2tws03***
&Tag.1.Key=test
&Tag.1.Value=api
&ResourceGroupId=rg-bp67acfmxazb4ph***
&PrimaryIpAddress=172.17.**.***
&NetworkInterfaceName=eni-eniname1
&Description=test
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<公共请求参数>正常返回示例
XML 格式
<CreateNetworkInterfaceResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
<NetworkInterfaceId>eni-bp14v2sdd3v8htlnm***</NetworkInterfaceId>
</CreateNetworkInterfaceResponse>JSON 格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
"NetworkInterfaceId": "eni-bp14v2sdd3v8htlnm***"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 403 | InvalidUserType.NotSupported | %s | 您当前的账号不支持此操作。 |
| 403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云账号不存在，或者您的AccessKey已经过期。 |
| 400 | MissingParameter | %s | 缺失参数，请检查参数是否完整。 |
| 403 | Forbidden.NotSupportRAM | %s | 暂不支持 RAM 用户执行该操作。 |
| 400 | UnsupportedParameter | %s | 不支持参数。 |
| 403 | Forbidden.SubUser | %s | 您的账号没有操作此资源的权限，请向主账号申请相关的权限。 |
| 400 | InvalidParameter | %s | 无效的参数。 |
| 400 | InvalidInstanceID.Malformed | %s | 参数“InstanceId”格式错误。 |
| 400 | InvalidOperation.InvalidEcsState | %s | 实例当前的状态不支持此操作。 |
| 400 | InvalidOperation.InvalidEniState | %s | 弹性网卡当前的状态不支持此操作。 |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 不允许解绑实例的主网卡。 |
| 404 | InvalidEcsId.NotFound | %s | 指定的实例 ID 不存在。 |
| 404 | InvalidEniId.NotFound | %s | 指定的弹性网卡 ID 不存在。 |
| 404 | InvalidVSwitchId.NotFound | %s | 指定的交换机不存在。 |
| 404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全组 ID 不存在。 |
| 403 | MaxEniCountExceeded | %s | 超过可以操作的最大弹性网卡数 |
| 403 | EniPerInstanceLimitExceeded | %s | 实例绑定的弹性网卡数量已经达到了最大限度，不能在为实例绑定弹性网卡。 |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | 该操作无效。 |
| 403 | InvalidOperation.VpcMismatch | %s | 您的操作无效，请确认该操作中的 VPC 与其它参数是否匹配。 |
| 403 | SecurityGroupInstanceLimitExceed | %s | 该安全组内已有的实例数量已达到最大限制。 |
| 403 | InvalidSecurityGroupId.NotVpc | %s | 参数“SecurityGroupId”无效，该安全组的网络类型不是专有网络。 |
| 403 | InvalidOperation.InvalidEniType | %s | 当前弹性网卡的类型不支持此操作。 |
| 403 | InvalidVSwitchId.IpNotEnough | %s | 指定的交换机内 IP 数量不足。 |
| 403 | InvalidVSwitchId.IpInvalid | %s | 指定的私网 IP 无效。 |
| 400 | Forbidden.RegionId | %s | 当前地域暂时没有提供该服务。 |
| 404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | 资源组并不在记录中。 |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | 标签中存在重复的键，请保持键的唯一性。 |
| 400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | 指定的标签键不合法。 |
| 400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | 指定的标签值不合法。 |
| 403 | QuotaExceed.Tags | %s | 标签数超过可以配置的最大数量。 |
| 403 | InvalidIp.Address | %s | 指定的 IPv6 地址无效。 |
| 403 | InvalidIp.IpRepeated | %s | 指定的 IP 重复。 |
| 400 | InvalidPrivateIpAddress.Duplicated | Specified private IP address is duplicated. | 指定的私网IP已经被使用，请您更换IP再重试。 |
访问错误中心查看更多错误码。