查看彈性網卡(ENI)列表。

描述

  • 查詢時,我們通過您指定屬性值過濾結果。
  • 不指定屬性值就不過濾該屬性,返回所有類目結果。
  • 一次最多查看 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 類型。