DescribeNetworkInterfaces_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

接口说明

DescribeNetworkInterfaces接口支持指定MaxResults或NextToken参数通过分页查询。具体使用说明：

分页查询首页时，仅需设置MaxResults以限制返回信息的条目数，返回结果中的NextToken将作为查询后续页的凭证。
查询后续页时，将NextToken参数设置为上一次返回结果中获取到的NextToken作为查询凭证，并设置MaxResults限制返回条目数。

流控信息

请求速率为1000/60(s)。更多流控信息，请前往配额中心查看

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称	字段详情
RegionIdstring	所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
Tagarray<object>	标签列表子级条数 <= 20
ResourceGroupIdstring	资源组 ID。使用该参数过滤资源时，资源数量不能超过 1000 个。展开详情示例值:rg-bp67acfmxazb4p****
VSwitchIdstring	弹性网卡所属的交换机 ID。示例值:vsw-bp16usj2p27htro3****
VpcIdstring	弹性网卡所属的专有网络 VPC ID。示例值:vpc-bp1j7w3gc1cexjqd****
PrimaryIpAddressstring	弹性网卡主私网 IPv4 地址。示例值:192.168..
SecurityGroupIdstring	辅助网卡对应的安全组 ID。展开详情示例值:sg-bp144yr32sx6ndw****参考取值来源: CreateSecurityGroup DescribeSecurityGroups
NetworkInterfaceNamestring	弹性网卡的名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文和数字等）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。示例值:test-eni-name参考取值来源: CreateNetworkInterface DescribeNetworkInterfaceAttribute
Typestring	弹性网卡类型。取值范围：展开详情示例值:Secondary
InstanceIdstring	弹性网卡当前附加的实例 ID。示例值:i-bp1e2l6djkndyuli****参考取值来源: RunInstances StopInstances StartInstances CreateInstance RebootInstances DescribeInstances ModifyManagedInstance RenewReservedInstances DetachInstanceRamRole AttachInstanceRamRole DeregisterManagedInstance PurchaseReservedInstancesOffering
ServiceManagedboolean	该弹性网卡的使用者是否为云产品或虚商。示例值:true
Statusstring	弹性网卡的状态。取值范围：展开详情示例值:Available
deprecatedPageNumberinteger<int32>	说明该参数已废弃，建议您通过指定 MaxResults 或 NextToken 参数时使用分页方式查询。示例值:1
deprecatedPageSizeinteger<int32>	说明该参数已废弃，建议您通过指定 MaxResults 或 NextToken 参数时使用分页方式查询。示例值:100
NextTokenstring	查询凭证（Token），取值为上一次 API 调用返回的`NextToken`参数值。展开详情示例值:AAAAAdDWBF2****
MaxResultsinteger<int32>	分页查询时每页的最大条目数。取值范围：10~500。展开详情示例值:50
PrivateIpAddressarray<string>	弹性网卡的辅助私网 IPv4 地址。N 的取值范围：1~100。示例值:192.168..子级条数 <= 100
NetworkInterfaceIdarray<string>	弹性网卡 ID。N 的取值范围：1~100。示例值:eni-bp125p95hhdhn3ot****子级条数 <= 1000
Ipv6Addressarray<string>	弹性网卡的 IPv6 地址。N 表示可以设置多个 IPv6 地址，N 的取值范围：1~100。示例值:2408:4321:180:1701:94c7:bc38:3bfa:****子级条数 <= 1000

返回参数

字段名称	字段详情
NextTokenstring	本次调用返回的查询凭证值。示例值:AAAAAdDWBF2****
PageSizeinteger<int32>	分页查询参数。展开详情示例值:1
PageNumberinteger<int32>	分页查询参数。展开详情示例值:1
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCountinteger<int32>	返回的弹性网卡总数。展开详情示例值:2
NetworkInterfaceSetsobject

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	MissingParameter	%s	诊断
400	UnsupportedParameter	%s	诊断
400	InvalidParameter	%s	诊断
400	InvalidInstanceID.Malformed	%s	诊断
400	InvalidOperation.InvalidEcsState	%s	诊断
400	InvalidOperation.InvalidEniState	%s	诊断
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	诊断
400	Forbidden.RegionId	%s	诊断
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	诊断
403	InvalidUserType.NotSupported	%s	诊断
403	Abs.InvalidAccount.NotFound	%s	诊断
403	Forbidden.NotSupportRAM	%s	诊断
403	Forbidden.SubUser	%s	诊断
403	InvalidParameter	%s	诊断
403	MaxEniCountExceeded	%s	诊断
403	EniPerInstanceLimitExceeded	%s	诊断
403	InvalidOperation.AvailabilityZoneMismatch	%s	诊断
403	InvalidOperation.VpcMismatch	%s	诊断
403	SecurityGroupInstanceLimitExceed	%s	诊断
403	InvalidSecurityGroupId.NotVpc	%s	诊断
403	InvalidOperation.InvalidEniType	%s	诊断
403	InvalidVpc.Empty	%s	诊断
403	Forbidden.RegionId	%s	诊断
403	InvalidOperation.InvalidEniPageNumber	%s	诊断
403	InvalidVpc.Indeterminacy	%s	诊断
404	InvalidEcsId.NotFound	%s	诊断
404	InvalidEniId.NotFound	%s	诊断
404	InvalidVSwitchId.NotFound	%s	诊断
404	InvalidSecurityGroupId.NotFound	%s	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-09-14	变更返回参数
	2024-08-08	变更返回参数
	2023-10-09	删除返回参数
	2023-01-04	变更返回参数

1
2
10 条/页

DescribeNetworkInterfaces_云服务器 ECS_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例