查看弹性网卡(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个。
Tag.n.Key String 弹性网卡的标签键。n的取值范围:[1, 20]。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以aliyun、acs:、http://或者https://开头。
Tag.n.Value String 弹性网卡的标签值。n的取值范围:[1, 20]。一旦传入该值,可以为空字符串。最多支持128个字符,不能以aliyun、acs:、http://或者https://开头。
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类型。