接口说明

• 新创建的弹性网卡处于可用（Available）状态。
• 弹性网卡只支持附加到同一可用区的VPC类型实例。
• 一个弹性网卡只能附加到一台实例。附加到新实例之前您需要将其与当前实例分离。
• 弹性网卡重新附加到另一台实例时，其属性不变，网络流量也会重定向到新的实例。
• 创建弹性网卡时，如果您需要设置IPv6地址，则需要确保指定的交换机开通了IPv6。更多信息，请参见什么是IPv6网关。
• 一个账号在一个阿里云地域内默认最多可创建100个弹性网卡。如果需要更多，请提交工单申请。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateNetworkInterface
&RegionId=cn-hangzhou
&SecurityGroupIds.1=sg-bp18kz60mefsicfg****
&VSwitchId=vsw-bp1s5fnvk4gn2tws03****
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&ResourceGroupId=rg-bp67acfmxazb4ph****
&PrimaryIpAddress=172.17.**.**
&NetworkInterfaceName=testNetworkInterfaceName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6AddressCount=1
&<公共请求参数>

正常返回示例

XML格式

<CreateNetworkInterfaceResponse>
      <Description>testDescription</Description>
      <Status>Available</Status>
      <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
      <ServiceManaged>false</ServiceManaged>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <ResourceGroupId>rg-2ze88m67qx5z****</ResourceGroupId>
      <ZoneId>cn-hangzhou-e</ZoneId>
      <VSwitchId>vsw-bp16usj2p27htro3****</VSwitchId>
      <NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
      <MacAddress>00:16:3e:12:**:**</MacAddress>
      <NetworkInterfaceId>eni-bp14v2sdd3v8htln****</NetworkInterfaceId>
      <SecurityGroupIds>
            <SecurityGroupId>sg-bp18kz60mefsicfg****</SecurityGroupId>
      </SecurityGroupIds>
      <Type>Secondary</Type>
      <Ipv6Sets>
            <Ipv6Set>
                  <Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
            </Ipv6Set>
      </Ipv6Sets>
      <VpcId>vpc-bp1j7w3gc1cexjqd****</VpcId>
      <OwnerId>123456****</OwnerId>
      <Tags>
            <Tag>
                  <TagKey>TestKey</TagKey>
                  <TagValue>TestValue</TagValue>
            </Tag>
      </Tags>
      <PrivateIpSets>
            <PrivateIpSet>
                  <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
                  <Primary>true</Primary>
            </PrivateIpSet>
      </PrivateIpSets>
</CreateNetworkInterfaceResponse>

JSON格式

{
	"Description": "testDescription",
	"Status": "Available",
	"PrivateIpAddress": "172.17.**.**",
	"ServiceManaged": false,
	"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
	"ResourceGroupId": "rg-2ze88m67qx5z****",
	"ZoneId": "cn-hangzhou-e",
	"VSwitchId": "vsw-bp16usj2p27htro3****",
	"NetworkInterfaceName": "my-eni-name",
	"MacAddress": "00:16:3e:12:**:**",
	"NetworkInterfaceId": "eni-bp14v2sdd3v8htln****",
	"SecurityGroupIds": {
		"SecurityGroupId": [
			"sg-bp18kz60mefsicfg****"
		]
	},
	"Type": "Secondary",
	"Ipv6Sets": {
		"Ipv6Set": [
			{
				"Ipv6Address": "2001:db8:1234:1a00::****"
			}
		]
	},
	"VpcId": "vpc-bp1j7w3gc1cexjqd****",
	"OwnerId": "123456****",
	"Tags": {
		"Tag": [
			{
				"TagKey": "TestKey",
				"TagValue": "TestValue"
			}
		]
	},
	"PrivateIpSets": {
		"PrivateIpSet": [
			{
				"PrivateIpAddress": "172.17.**.**",
				"Primary": true
			}
		]
	}
}

错误码

访问错误中心查看更多错误码。