CreateNetworkInterface
创建一张弹性网卡（ENI），支持指定主私网IP地址
服务地址：
华东1 金融云
输入参数
只看必填
RegionId要创建的弹性网卡所在地域的ID
Tag弹性网卡的标签列表
0弹性网卡的标签
Key弹性网卡的标签键
Value弹性网卡的标签值
添加
ResourceGroupId资源组ID
VSwitchId弹性网卡的交换机ID
PrimaryIpAddress弹性网卡的主私网IP地址
SecurityGroupId加入一个安全组
NetworkInterfaceName弹性网卡名称
Description弹性网卡的描述信息
Visible>该参数已废弃
请选择布尔值
InstanceType弹性网卡类型
BusinessType>该参数已废弃
SecondaryPrivateIpAddressCount指定私有IP地址数量
QueueNumber弹性网卡队列数
NetworkInterfaceTrafficMode弹性网卡的通讯模式
QueuePairNumberRDMA网卡队列数
SecurityGroupIds加入一个或多个安全组
0加入一个或多个安全组
添加
PrivateIpAddress从弹性网卡所属交换机的CIDR地址段内...
0从弹性网卡所属交换机的CIDR地址段内...
添加
Ipv6Address为弹性网卡指定一个或多个IPv6地址
0为弹性网卡指定一个或多个IPv6地址
添加
Ipv6AddressCount为弹性网卡指定随机生成的IPv6地址数量
Ipv4Prefix为弹性网卡指定一个或多个IPv4前缀
0为弹性网卡指定一个或多个IPv4前缀
添加
Ipv4PrefixCount为弹性网卡指定一个或多个IPv4前缀
Ipv6Prefix为弹性网卡指定一个或多个IPv6前缀
0为弹性网卡指定一个或多个IPv6前缀
添加
Ipv6PrefixCount为弹性网卡指定一个或多个IPv6前缀
DeleteOnRelease释放实例时是否保留网卡
请选择布尔值
TxQueueSize弹性网卡出方向队列深度
RxQueueSize弹性网卡入方向队列深度
NetworkInterfaceTrafficConfig弹性网卡通讯参数集合
QueueNumber弹性网卡队列数
NetworkInterfaceTrafficMode弹性网卡的通讯模式
QueuePairNumberRDMA 网卡队列数
TxQueueSize弹性网卡出方向队列深度
RxQueueSize弹性网卡入方向队列深度
ConnectionTrackingConfiguration网络连接跟踪配置信息集合
TcpEstablishedTimeout已建状态的TCP连接超时时间
TcpClosedAndTimeWaitTimeoutTCP等待与关闭超时时间
UdpTimeoutUDP流超时时间
EnhancedNetwork>参数暂未开放使用
EnableSriov>该参数暂未开放使用
请选择布尔值
EnableRss该参数暂未开放使用
请选择布尔值
SourceDestCheck>该参数正在邀测中
请选择布尔值
幂等性参数
ClientToken保证请求幂等性
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

调用该接口时，请注意：

  • 该接口为同步接口，新创建的弹性网卡为可用（Available）状态，可以直接进行附加操作。
  • 若创建接口返回结果中NetworkInterfaceId为空，请再次尝试创建弹性网卡。
  • 一张弹性网卡只能附加到一台专有网络的实例。
  • 弹性网卡重新附加到另一台实例时，其属性不变，网络流量也会重定向到新的实例。
  • 创建弹性网卡时，调用该接口最多可以分配 49 个辅助私网 IP 地址。
  • 创建弹性网卡时，如果您需要设置 IPv6 地址，则需要确保指定的交换机开通了 IPv6。更多信息，请参见什么是 IPv6 网关。
  • 一个账号在一个阿里云地域内创建弹性网卡有数量限制。可在 ECS 管理控制台查看资源配额。具体操作，请参见查看和提升资源配额。

请求示例

创建一张弹性网卡
RegionId:  cn-hangzhou,   //设置华东 1（杭州）地域。
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //设置安全组 ID。
VSwitchId:  vsw-bp19wo63nleroq22g****,   //设置虚拟交换机 ID。
创建一张弹性网卡，并指定主私网 IP 地址
RegionId:  cn-hangzhou,   //华东 1（杭州）地域。
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //安全组 ID。
VSwitchId:  vsw-bp19wo63nleroq22g****,   //虚拟交换机 ID。
PrimaryIpAddress:  192.168.0.*,   //主私网 IP 地址。

请求参数

字段名称字段详情
RegionIdstring

要创建的弹性网卡所在地域的 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
Tagarray<object>

弹性网卡的标签列表。

子级条数 <= 20
ResourceGroupIdstring

资源组 ID。您可以调用 ListResourceGroups 查询资源组信息。

示例值:rg-bp67acfmxazb4ph****
VSwitchIdstring

弹性网卡的交换机 ID。弹性网卡的私网 IP 地址在交换机的 IP 地址段内的空闲地址中取值。展开详情

示例值:vsw-bp1s5fnvk4gn2tws03****
PrimaryIpAddressstring

弹性网卡的主私网 IP 地址。展开详情

示例值:172.17.**.**
SecurityGroupIdstring

加入一个安全组。安全组和弹性网卡必须在同一个专有网络 VPC 中。展开详情

示例值:sg-bp1fg655nh68xyz9i****参考取值来源:
    CreateSecurityGroup
    DescribeSecurityGroups
NetworkInterfaceNamestring

弹性网卡名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文等），ASCII 数字（0-9）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。展开详情

示例值:testNetworkInterfaceName参考取值来源:
    DescribeNetworkInterfaces
Descriptionstring

弹性网卡的描述信息。长度为 2~256 个英文或中文字符，不能以http://或https://开头。展开详情

示例值:testDescription
Visibleboolean
说明 该参数已废弃。
示例值:null
InstanceTypestring

弹性网卡类型。取值范围：展开详情

示例值:Secondary参考取值来源:
    DescribeInstanceTypes
    CreateInstance
BusinessTypestring
说明 该参数已废弃。
示例值:null
SecondaryPrivateIpAddressCountinteger<int32>

指定私有 IP 地址数量，让 ECS 为您自动创建 IP 地址。取值范围：1~49。

示例值:1取值 >= 1
QueueNumberinteger<int32>

弹性网卡队列数。取值范围：1~2048展开详情

示例值:1取值 >= 1
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。

示例值:123e4567-e89b-12d3-a456-426655440000
NetworkInterfaceTrafficModestring

弹性网卡的通讯模式。取值范围：展开详情

示例值:Standard参考取值来源:
    DescribeNetworkInterfaces
QueuePairNumberinteger<int32>

RDMA 网卡队列数。展开详情

示例值:22
SecurityGroupIdsarray<string>

加入一个或多个安全组。安全组和弹性网卡必须在同一个专有网络 VPC 中。N 的取值范围与弹性网卡能够加入安全组配额有关，更多信息，请参见使用限制。展开详情

示例值:sg-bp1fg655nh68xyz9i****子级条数 <= 51
PrivateIpAddressarray<string>

从弹性网卡所属交换机的 CIDR 地址段内的空闲地址中选择一个或多个辅助私有 IP 地址。N 的取值范围：0~10。展开详情

示例值:172.17.**.**子级条数 <= 10
Ipv6Addressarray<string>

为弹性网卡指定一个或多个 IPv6 地址。支持设置最多 10 个 IPv6 地址，即 N 的取值范围：1~10。展开详情

示例值:2001:db8:1234:1a00::****子级条数 <= 20
Ipv6AddressCountinteger<int32>

为弹性网卡指定随机生成的 IPv6 地址数量。取值范围：1~10。展开详情

示例值:1取值 >= 1
Ipv4Prefixarray<string>

为弹性网卡指定一个或多个 IPv4 前缀。N 的取值范围：1~10。展开详情

子级条数 <= 10
Ipv4PrefixCountinteger<int32>

为弹性网卡指定一个或多个 IPv4 前缀。取值范围：1~10。展开详情

示例值:1取值 <= 10
Ipv6Prefixarray<string>

为弹性网卡指定一个或多个 IPv6 前缀。N 的取值范围：1~10。展开详情

子级条数 <= 10
Ipv6PrefixCountinteger<int32>

为弹性网卡指定一个或多个 IPv6 前缀。取值范围：1~10。展开详情

示例值:1取值 <= 10
DeleteOnReleaseboolean

释放实例时是否保留网卡。取值范围：展开详情

示例值:true
TxQueueSizeinteger<int32>

弹性网卡出方向队列深度。展开详情

示例值:8192
RxQueueSizeinteger<int32>

弹性网卡入方向队列深度。展开详情

示例值:8192
NetworkInterfaceTrafficConfigobject

弹性网卡通讯参数集合。

ConnectionTrackingConfigurationobject

网络连接跟踪配置信息集合。展开详情

EnhancedNetworkobject
说明 参数暂未开放使用。
SourceDestCheckboolean
说明 该参数正在邀测中，暂未开放使用。
示例值:false

返回参数

字段名称字段详情
Statusstring

弹性网卡的状态。

示例值:Available
Typestring

弹性网卡的类型。

示例值:Secondary
VpcIdstring

网卡所属的专有网络 VPC ID。

示例值:vpc-bp1j7w3gc1cexjqd****
NetworkInterfaceNamestring

弹性网卡的名称。

示例值:my-eni-name
MacAddressstring

弹性网卡的 MAC 地址。

示例值:00:16:3e:12:**:**
NetworkInterfaceIdstring

弹性网卡 ID。

示例值:eni-bp14v2sdd3v8htln****
ServiceIDinteger<int64>

弹性网卡对应的虚商 ID。

注意 请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。
示例值:12345678910
OwnerIdstring

弹性网卡的所属账号 ID。

示例值:123456****
ServiceManagedboolean

该弹性网卡的使用者是否为云产品或虚商。

示例值:true
VSwitchIdstring

VPC 的交换机 ID。

示例值:vsw-bp16usj2p27htro3****
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Descriptionstring

弹性网卡的描述信息。

示例值:testDescription
ResourceGroupIdstring

资源组 ID。

示例值:rg-2ze88m67qx5z****
ZoneIdstring

可用区 ID。

示例值:cn-hangzhou-e
PrivateIpAddressstring

弹性网卡的私网 IP 地址。

示例值:172.17.**.**
SecurityGroupIdsobject
PrivateIpSetsobject
Tagsobject
Ipv6Setsobject
Ipv4PrefixSetsobject
Ipv6PrefixSetsobject
SourceDestCheckboolean
说明 该参数正在邀测中，暂未开放使用。
示例值:false
变更历史
暂无变更历史