DescribeNetworkInterfaces

Description

DescribeNetworkInterfaces provides two ways to check responses:

• Method 1: Use NextToken to configure the query token. The value of this parameter is the value of NextToken returned by the last call of the DescribeNetworkInterfaces operation. Then use MaxResults to configure the maximum number of entries to return on each page.

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

  You can only use one of the preceding methods. If many entries are contained in the ENI list, we recommend that you use Method 1. If NextToken is set, the PageSize and the PageNumber parameters will not take effect and the TotalCount response parameter will be invalid.

Request parameters

Response parameters

Examples

Sample requests

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

Sample success responses

XML format

<DescribeNetworkInterfacesResponse>
      <PageNumber>1</PageNumber>
      <NextToken>AAAAAdDWBF2w6Olxc+cMPjUtUMoOHldehKPIfYtMyAi+***w+IDifXafILjY/QdPWM1nUw==</NextToken>
      <TotalCount>0</TotalCount>
      <PageSize>10</PageSize>
      <RequestId>F5266102-405B-4EEC-AAD8-ADF227463EA9</RequestId>
      <NetworkInterfaceSets>
            <NetworkInterfaceSet>
                  <Type>Primary</Type>
                  <ResourceGroupId></ResourceGroupId>
                  <InstanceId>i-bp188rg4xz5qev******</InstanceId>
                  <PrivateIpSets>
                        <PrivateIpSet>
                              <PrivateIpAddress>172.16. ***.99</PrivateIpAddress>
                              <Primary>true</Primary>
                              <AssociatedPublicIp></AssociatedPublicIp>
                        </PrivateIpSet>
                  </PrivateIpSets>
                  <ZoneId>cn-hangzhou-g</ZoneId>
                  <VSwitchId>vsw-bp1s5fnvk4gn2tw******</VSwitchId>
                  <VpcId>vpc-bp1opxu1zkhn00g******</VpcId>
                  <AssociatedPublicIp></AssociatedPublicIp>
                  <NetworkInterfaceId>eni-bp14664y88uf9t******</NetworkInterfaceId>
                  <CreationTime>2018-11-09T13:56:24Z</CreationTime>
                  <Status>InUse</Status>
                  <MacAddress>00:16:3e:15:40:5d</MacAddress>
                  <SecurityGroupIds>
                        <SecurityGroupId>sg-bp10zcgmybh0qc******</SecurityGroupId>
                  </SecurityGroupIds>
                  <PrivateIpAddress>172.16. ***.99</PrivateIpAddress>
            </NetworkInterfaceSet>
      </NetworkInterfaceSets>
</DescribeNetworkInterfacesResponse>

JSON format

{
    "PageNumber": 1,
    "NextToken": "AAAAAdDWBF2w6Olxc+cMPjUtUMoOHldehKPIfYtMyAi+***w+IDifXafILjY/QdPWM1nUw==",
    "TotalCount": 0,
    "PageSize": 10,
    "RequestId": "F5266102-405B-4EEC-AAD8-ADF227463EA9",
    "NetworkInterfaceSets": {
        "NetworkInterfaceSet": [
            {
                "Type": "Primary",
                "ResourceGroupId": "",
                "InstanceId": "i-bp188rg4xz5qev******",
                "PrivateIpSets": {
                    "PrivateIpSet": [
                        {
                            "PrivateIpAddress": "172.16. ***.99",
                            "Primary": true,
                            "AssociatedPublicIp": {}
                        }
                    ]
                },
                "ZoneId": "cn-hangzhou-g",
                "VSwitchId": "vsw-bp1s5fnvk4gn2tw******",
                "VpcId": "vpc-bp1opxu1zkhn00g******",
                "AssociatedPublicIp": {},
                "NetworkInterfaceId": "eni-bp14664y88uf9t******",
                "CreationTime": "2018-11-09T13:56:24Z",
                "Status": "InUse",
                "MacAddress": "00:16:3e:15:40:5d",
                "SecurityGroupIds": {
                    "SecurityGroupId": [
                        "sg-bp10zcgmybh0qc******"
                    ]
                },
                "PrivateIpAddress": "172.16. ***.99"
            }
        ]
    }
}

Error codes

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