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>5C0E2B68-EDB0-421D-B146-E58A04808242</RequestId>
      <PageSize>10</PageSize>
      <NextToken>AAAAAdDWBF2w6Olxc+cMPjUtUMpaCa3hjTbxWpikFyOaihc****/JSvFWO/sGLK3bh****</NextToken>
      <PageNumber>1</PageNumber>
      <NetworkInterfaceSets>
            <NetworkInterfaceSet>
                  <Status>InUse</Status>
                  <PrivateIpAddress>192.168.**.**</PrivateIpAddress>
                  <ZoneId>cn-shenzhen-c</ZoneId>
                  <ResourceGroupId>rg-aek2boynwys****</ResourceGroupId>
                  <InstanceId>i-wz91t9p4j9xsw2pn****</InstanceId>
                  <VSwitchId>vsw-wz9vqfgwgkj94ubb1****</VSwitchId>
                  <NetworkInterfaceId>eni-wz9iib303as7e5c3****</NetworkInterfaceId>
                  <MacAddress>00:16:3e:**:**:c2</MacAddress>
                  <SecurityGroupIds>
                        <SecurityGroupId>sg-wz9iib303as7e5c7****</SecurityGroupId>
                  </SecurityGroupIds>
                  <Type>Primary</Type>
                  <Ipv6Sets>
                        <Ipv6Set>
                              <Ipv6Address>2408:4321:180:1701:94c7:bc38:3bfa:***</Ipv6Address>
                        </Ipv6Set>
                  </Ipv6Sets>
                  <VpcId>vpc-wz9wh0fywtu5szszb****</VpcId>
                  <OwnerId>140692647406****</OwnerId>
                  <AssociatedPublicIp></AssociatedPublicIp>
                  <CreationTime>2019-12-25T12:31:31Z</CreationTime>
                  <Tags>
                        <Tag>
                              <TagKey>owner</TagKey>
                              <TagValue>lisi</TagValue>
                        </Tag>
                  </Tags>
                  <PrivateIpSets>
                        <PrivateIpSet>
                              <PrivateIpAddress>192.168.**.**</PrivateIpAddress>
                              <AssociatedPublicIp></AssociatedPublicIp>
                              <Primary>true</Primary>
                        </PrivateIpSet>
                  </PrivateIpSets>
            </NetworkInterfaceSet>
      </NetworkInterfaceSets>
</DescribeNetworkInterfacesResponse>

JSON 格式

{
	"TotalCount": 1,
	"RequestId": "5C0E2B68-EDB0-421D-B146-E58A04808242",
	"PageSize": 10,
	"NextToken": "AAAAAdDWBF2w6Olxc+cMPjUtUMpaCa3hjTbxWpikFyOaihc****/JSvFWO/sGLK3bh****",
	"PageNumber": 1,
	"NetworkInterfaceSets": {
		"NetworkInterfaceSet": [{
			"Status": "InUse",
			"PrivateIpAddress": "192.168.**.**",
			"ZoneId": "cn-shenzhen-c",
			"ResourceGroupId": "rg-aek2boynwys****",
			"InstanceId": "i-wz91t9p4j9xsw2pn****",
			"VSwitchId": "vsw-wz9vqfgwgkj94ubb1****",
			"NetworkInterfaceId": "eni-wz9iib303as7e5c3****",
			"MacAddress": "00:16:3e:**:**:c2",
			"SecurityGroupIds": {
				"SecurityGroupId": [
					"sg-wz9iib303as7e5c7****"
				]
			},
			"Type": "Primary",
			"Ipv6Sets": {
				"Ipv6Set": [{
					"Ipv6Address": "2408:4321:180:1701:94c7:bc38:3bfa:***"
				}]
			},
			"VpcId": "vpc-wz9wh0fywtu5szszb****",
			"OwnerId": "140692647406****",
			"AssociatedPublicIp": {},
			"CreationTime": "2019-12-25T12:31:31Z",
			"Tags": {
				"Tag": [{
					"TagKey": "owner",
					"TagValue": "lisi"
				}]
			},
			"PrivateIpSets": {
				"PrivateIpSet": [{
					"PrivateIpAddress": "192.168.**.**",
					"AssociatedPublicIp": {},
					"Primary": true
				}]
			}
		}]
	}
}

错误码

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