DescribeNetworkInterfaces -

描述

查詢時，我們通過您指定屬性值過濾結果。
不指定屬性值就不過濾該屬性，返回所有類目結果。
一次最多查看 100 個彈性網卡。

請求參數


名稱	類型	是否必需	描述
Action	String	是	系統規定參數。取值：DescribeNetworkInterfaces
RegionId	String	是	所在地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
VpcId	String	否	網卡所屬的專有網路 VPC ID。
VSwitchId	String	否	VPC 的虛擬交換器 ID。
PrimaryIpAddress	String	否	彈性網卡主私有 IP 位址。
SecurityGroupId	String	否	安全性群組 ID。
NetworkInterfaceName	String	否	彈性網卡的名稱。
Type	String	否	彈性網卡類型。取值範圍： Primary Secondary
InstanceId	String	否	彈性網卡當前關聯的實例 ID。
NetworkInterfaceId.N	String	否	彈性網卡 ID。一次最多查看 100 個。
PageNumber	Integer	否	查詢結果的頁碼。取值為正整數。預設值：1
PageSize	Integer	否	查詢結果的分頁大小。取值範圍：[1,100] 預設值：10

返回參數


名稱	類型	描述
NetworkInterfaceSet	NetworkInterfaceSet	彈性網卡資訊組成的集合
TotalCount	Integer	實例總個數
PageNumber	Integer	實例列表的頁碼
PageSize	Integer	輸入時設定的每頁行數

樣本

請求樣本

https://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaces
&RegionId=cn-hangzhou
&<公共請求參數>

返回樣本

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

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

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。


錯誤碼	錯誤資訊	HTTP 狀態碼	說明
Abs.InvalidAccount.NotFound	The Account is not found or ak is expired.	403	您的阿里雲帳號不存在，或者您的 AccessKey 已經過期。
UnsupportedParameter	The parameters is unsupported.	400	該參數不存在，或者不支援該參數。
MissingParameter	The input parameter that is mandatory for processing this request is not supplied.	400	缺少必需參數。
InvalidEcsId.NotFound	The specified EcsId is not found.	404	指定的實例 ID 不存在。
InvalidVSwitchId.NotFound	The specified VSwitchId is not found.	404	指定的交換器 ID 不存在。
InvalidSecurityGroupId.NotFound	The specified SecurityGroupId is not found.	404	指定的安全性群組 ID 不存在。
InvalidOperation.AvailabilityZoneMismatch	The VPC VSwitch of the specified ENI and ECS instance are not in the same availability zone.	403	指定的 VPC 交換器 ID、彈性網卡和實例 ID 不在同一個可用區。
InvalidOperation.VpcMismatch	The VPC of the specified ENI and security group are not in the same VPC.	403	指定的彈性網卡和安全性群組 ID 不在同一個 VPC。
InvalidSecurityGroupId.NotVpc	The specified SecurityGroupId not in VPC.	403	指定的安全性群組 ID 不是 VPC 類型。