阿里云ECS云服务器CreateNetworkInterface-云淘科技

接口说明

调用该接口时，请注意：

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

调用示例详情参见创建弹性网卡。

请求参数

返回数据

示例

请求示例

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格式

HTTP/1.1 200 OK
Content-Type:application/xml


    testDescription
    Available
    172.17.**.**
    false
    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    rg-2ze88m67qx5z****
    cn-hangzhou-e
    vsw-bp16usj2p27htro3****
    my-eni-name
    00:16:3e:12:**:**
    eni-bp14v2sdd3v8htln****
    
        sg-bp18kz60mefsicfg****
    
    Secondary
    
        
            2001:db8:1234:1a00::****
        
    
    vpc-bp1j7w3gc1cexjqd****
    123456****
    
        
            TestKey
            TestValue
        
    
    
        
            172.17.**.**
            true
        
    

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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
    } ]
  }
}

错误码

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