DescribeNetworkInterfaces

Description

You can use one of the following methods to check the responses returned by the DescribeNetworkInterfaces operation:

• Method 1: Use NextToken to configure the query token. Set the value to the NextToken value returned in the last call to the DescribeNetworkInterfaces operation. Then, use MaxResults to specify the maximum number of entries to return on each page.

• Method 2: Use PageSize to specify the number of entries to return on each page and then use PageNumber to specify the number of the page to return.

  You can use only one of the preceding methods. If a large number of entries are to be returned, we recommend that you use method 1. When NextToken is specified, PageSize and PageNumber do not take effect and TotalCount in the response is invalid.

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

<DescribeNetworkInterfacesResponse>
      <TotalCount>1</TotalCount>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <PageSize>1</PageSize>
      <NextToken>AAAAAdDWBF2****</NextToken>
      <PageNumber>1</PageNumber>
      <NetworkInterfaceSets>
            <NetworkInterfaceSet>
                  <Status>Available</Status>
                  <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></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></AssociatedPublicIp>
                              <Primary>true</Primary>
                        </PrivateIpSet>
                  </PrivateIpSets>
            </NetworkInterfaceSet>
      </NetworkInterfaceSets>
</DescribeNetworkInterfacesResponse>

JSON format

{
    "TotalCount": 1,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "PageSize": 1,
    "NextToken": "AAAAAdDWBF2****",
    "PageNumber": 1,
    "NetworkInterfaceSets": {
        "NetworkInterfaceSet": [
            {
                "Status": "Available",
                "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.