DescribeNetworkInterfaces

接口说明

DescribeNetworkInterfaces支持两种查看返回数据的方式：

• 方式一：通过NextToken设置查询凭证（Token），其取值是上一次调用DescribeNetworkInterfaces返回的NextToken参数值，再通过MaxResults设置单页查询的最大条目数。

• 方式二：通过PageSize设置单页返回的条目数，再通过PageNumber设置页码。

  以上两种方式只能任选其中之一。当弹性网卡返回的条目数较多时，推荐使用方式一。如果设置了NextToken，则请求参数PageSize和PageNumber将失效，且返回数据中的TotalCount无效。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaces
&RegionId=cn-hangzhou
&PrivateIpAddress.1=192.168.**.**
&PrivateIpAddress.2=192.168.**.**
&NextToken=AAAAAdDWBF2****
&<公共请求参数>

正常返回示例

XML格式

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

{
    "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
                        }
                    ]
                }
            }
        ]
    }
}

错误码

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