DescribeNetworkInterfaces

Description

The DescribeNetworkInterfaces operation supports paged query. During a paged query, when you call the DescribeNetworkInterfaces operation to retrieve the first page of results, set MaxResults to specify the maximum number of entries to return in the call. The return value of NextToken is a pagination token, which can be used in the next call to retrieve a new page of results. When you call the DescribeNetworkInterfaces operation to retrieve a new page of results, set NextToken to the NextToken value returned in the previous call and set MaxResults to specify the maximum number of entries to return in this call.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaces
&RegionId=cn-hangzhou
&PrivateIpAddress.1=192.168.**.**
&PrivateIpAddress.2=192.168.**.**
&NextToken=AAAAAdDWBF2****
&<Common request parameters>

Sample success responses

XML format

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

<DescribeNetworkInterfacesResponse>
    <TotalCount>2</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>1</PageSize>
    <NextToken>AAAAAdDWBF2****</NextToken>
    <PageNumber>1</PageNumber>
    <NetworkInterfaceSets>
        <NetworkInterfaceSet>
            <Status>Available</Status>
            <NetworkInterfaceTrafficMode>Standard</NetworkInterfaceTrafficMode>
            <ServiceManaged>false</ServiceManaged>
            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
            <ZoneId>cn-hangzhou-e</ZoneId>
            <ResourceGroupId>rg-aek2boynwys****</ResourceGroupId>
            <InstanceId>i-wz91t9p4j9xsw2pn****</InstanceId>
            <VSwitchId>vsw-bp16usj2p27htro3****</VSwitchId>
            <NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
            <MacAddress>00:16:3e:12:**:**</MacAddress>
            <SecurityGroupIds>
                <SecurityGroupId>sg-bp18kz60mefsicfg****</SecurityGroupId>
            </SecurityGroupIds>
            <Type>Secondary</Type>
            <Ipv6Sets>
                <Ipv6Set>
                    <Ipv6Address>2408:4321:180:1701:94c7:bc38:3bfa:****</Ipv6Address>
                </Ipv6Set>
            </Ipv6Sets>
            <VpcId>vpc-bp1j7w3gc1cexjqd****</VpcId>
            <OwnerId>123456****</OwnerId>
            <NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
            <AssociatedPublicIp/>
            <CreationTime>2019-12-25T12:31:31Z</CreationTime>
            <Tags>
                <Tag>
                    <TagKey>TestKey</TagKey>
                    <TagValue>TestValue</TagValue>
                </Tag>
            </Tags>
            <PrivateIpSets>
                <PrivateIpSet>
                    <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
                    <AssociatedPublicIp/>
                    <Primary>true</Primary>
                </PrivateIpSet>
            </PrivateIpSets>
        </NetworkInterfaceSet>
    </NetworkInterfaceSets>
</DescribeNetworkInterfacesResponse>

JSON format

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

{
  "TotalCount" : 2,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 1,
  "NextToken" : "AAAAAdDWBF2****",
  "PageNumber" : 1,
  "NetworkInterfaceSets" : {
    "NetworkInterfaceSet" : [ {
      "Status" : "Available",
      "NetworkInterfaceTrafficMode" : "Standard",
      "ServiceManaged" : false,
      "PrivateIpAddress" : "172.17.**.**",
      "ZoneId" : "cn-hangzhou-e",
      "ResourceGroupId" : "rg-aek2boynwys****",
      "InstanceId" : "i-wz91t9p4j9xsw2pn****",
      "VSwitchId" : "vsw-bp16usj2p27htro3****",
      "NetworkInterfaceId" : "eni-bp125p95hhdhn3ot****",
      "MacAddress" : "00:16:3e:12:**:**",
      "SecurityGroupIds" : {
        "SecurityGroupId" : [ "sg-bp18kz60mefsicfg****" ]
      },
      "Type" : "Secondary",
      "Ipv6Sets" : {
        "Ipv6Set" : [ {
          "Ipv6Address" : "2408:4321:180:1701:94c7:bc38:3bfa:****"
        } ]
      },
      "VpcId" : "vpc-bp1j7w3gc1cexjqd****",
      "OwnerId" : "123456****",
      "NetworkInterfaceName" : "my-eni-name",
      "AssociatedPublicIp" : { },
      "CreationTime" : "2019-12-25T12:31:31Z",
      "Tags" : {
        "Tag" : [ {
          "TagKey" : "TestKey",
          "TagValue" : "TestValue"
        } ]
      },
      "PrivateIpSets" : {
        "PrivateIpSet" : [ {
          "PrivateIpAddress" : "172.17.**.**",
          "AssociatedPublicIp" : { },
          "Primary" : true
        } ]
      }
    } ]
  }
}

Error codes

For a list of error codes, visit the API Error Center.