DescribeNetworkInterfaces

调试

前往【API Explorer】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。

请求参数

返回参数

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaces
&RegionId=cn-hangzhou
&Tag.1.Key=test
&Tag.1.Value=api
&ResourceGroupId=rg-resourcegroupid1
&VSwitchId=vsw-bp16usj2p27htro3xxxxx
&VpcId=vsw-bp16usj2p27htro3xxxxx
&PrimaryIpAddress=172.17.XX.XXX
&SecurityGroupId=sg-bp144yr32sx6ndwxxxxx
&NetworkInterfaceName=my-eni-name
&Type=Secondary
&InstanceId=AY121018033933eaxxxxx
&NetworkInterfaceId.1=eni-bp17pdijfczaxZZZZxxxxx
&PageNumber=1
&PageSize=100
&<公共请求参数>

正常返回示例

XML 格式

<DescribeNetworkInterfacesResponse>
  <NetworkInterfaceSets>
    <NetworkInterfaceSet>
      <AssociatedPublicIp/>
      <CreationTime>2017-11-24T06:14:22Z</CreationTime>
      <InstanceId>AY121018033933eaxxxxx</InstanceId>
      <MacAddress>00:16:3e:0f:XX:XX</MacAddress>
      <NetworkInterfaceId>eni-bp17pdijfczaxZZZZxxxxx</NetworkInterfaceId>
      <PrivateIpAddress>XXX.XXX.XX.XX</PrivateIpAddress>
      <PrivateIpSets>
        <PrivateIpSet>
          <AssociatedPublicIp/>
          <Primary>true</Primary>
          <PrivateIpAddress>XXX.XXX.XX.XX</PrivateIpAddress>
        </PrivateIpSet>
      </PrivateIpSets>
      <SecurityGroupIds>
        <SecurityGroupId>sg-bp144yr32sx6ndwxxxxx</SecurityGroupId>
      </SecurityGroupIds>
      <Status>Available</Status>
      <Type>Secondary</Type>
      <VpcId>vpc-bp1j7w3gc1cexjqdxxxxx</VpcId>
      <VSwitchId>vsw-bp16usj2p27htro3xxxxx</VSwitchId>
      <ZoneId>cn-hangzhou-e</ZoneId>
    </NetworkInterfaceSet>
  </NetworkInterfaceSets>
  <PageNumber>1</PageNumber>
  <PageSize>100</PageSize>
  <RequestId>CEE5C347-0B64-4535-A061-95BE95Axxxxx</RequestId>
  <TotalCount>1</TotalCount>
</DescribeNetworkInterfacesResponse>

JSON 格式

{
	"PageNumber":1,
	"TotalCount":1,
	"PageSize":100,
	"RequestId":"CEE5C347-0B64-4535-A061-95BE95Axxxxx",
	"NetworkInterfaceSets":{
		"NetworkInterfaceSet":[
			{
				"Type":"Secondary",
				"InstanceId":"AY121018033933eaxxxxx",
				"PrivateIpSets":{
					"PrivateIpSet":[
						{
							"PrivateIpAddress":"XXX.XXX.XX.XX",
							"Primary":true,
							"AssociatedPublicIp":{}
						}
					]
				},
				"ZoneId":"cn-hangzhou-e",
				"VSwitchId":"vsw-bp16usj2p27htro3xxxxx",
				"VpcId":"vpc-bp1j7w3gc1cexjqdxxxxx",
				"AssociatedPublicIp":{},
				"NetworkInterfaceId":"eni-bp17pdijfczaxZZZZxxxxx",
				"CreationTime":"2017-11-24T06:14:22Z",
				"Status":"Available",
				"MacAddress":"00:16:3e:0f:XX:XX",
				"SecurityGroupIds":{
					"SecurityGroupId":[
						"sg-bp144yr32sx6ndwxxxxx"
					]
				},
				"PrivateIpAddress":"XXX.XXX.XX.XX"
			}
		]
	}
}

错误码

查看本产品错误码