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

接口说明

调用该接口时，请注意：

弹性网卡必须处于可用（Available）状态，一个弹性网卡只能同时附加到一台相同可用区且相同专有网络的实例上。
实例需处于运行中（Running）或者已停止（Stopped）状态，部分实例规格的实例在附加弹性网卡时必须为已停止（Stopped）状态，更多信息，请参见附加弹性网卡中的需要停止实例的 ECS 实例规格章节。

说明如果实例最后一次启动时间在 2018 年 4 月 1 日之前（包括但不限于启动新购的实例、重启、重开机），您必须提前调用 RebootInstance 重启一直保持运行中状态的实例，否则无法附加弹性网卡。
一台实例可以同时附加多个弹性网卡，更多信息，请参见弹性网卡概述。
弹性网卡所在的交换机必须与实例所在交换机属于同一可用区且同一专有网络 VPC。
该接口为异步接口，调用成功后，您可以通过查询弹性网卡状态或监听网卡操作事件的方式来感知操作结果。弹性网卡状态机如下图所示：
- Attaching 说明附加弹性网卡请求发送成功，弹性网卡正在附加到 ECS 实例中。
- InUse 说明弹性网卡已附加到 ECS 实例。
- Available 说明弹性网卡附加到 ECS 实例失败。

调用示例详情参见附加弹性网卡。

流控信息

请求速率为500/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:AttachNetworkInterface	Update	NetworkInterface acs:ecs:{#regionId}:{#accountId}:eni/{#eniId} Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}	无	无

请求参数

字段名称	字段详情
RegionIdstring	实例所在地域的 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
NetworkInterfaceIdstring	弹性网卡 ID。示例值:eni-bp17pdijfczax1huji****参考取值来源: CreateNetworkInterface DescribeNetworkInterfaces
InstanceIdstring	实例 ID。示例值:i-bp16qstyvxj9gpqw****参考取值来源: RunInstances StopInstances StartInstances CreateInstance RebootInstances DescribeInstances ModifyManagedInstance RenewReservedInstances AttachInstanceRamRole DetachInstanceRamRole DeregisterManagedInstance PurchaseReservedInstancesOffering
TrunkNetworkInstanceIdstring	中继网卡 ID。展开详情示例值:eni-f8zapqwj1v1j4ia3****
WaitForNetworkConfigurationReadyboolean	说明该参数已废弃。示例值:null
NetworkCardIndexinteger<int32>	网卡指定的物理网卡索引。展开详情示例值:0

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

返回示例

错误码

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

全局错误码

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

400	MissingParameter	%s	诊断
400	UnsupportedParameter	%s	诊断
400	InvalidParameter	%s	诊断
400	InvalidInstanceID.Malformed	%s	诊断
400	InvalidOperation.InvalidRegion	%s	诊断
400	InvalidOperation.InvalidEcsState	%s	诊断
400	InvalidOperation.InvalidEniState	%s	诊断
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	诊断
400	Forbidden.RegionId	%s	诊断
400	InvalidOperation.InvalidGeneration	%s	诊断
400	InvalidParams.EniId	%s	诊断
400	InvalidOperation.UserNotSupportNetworkCard	User not support network card.	诊断
400	InvalidOperation.ConnectionTrackingConfigNotSupportMemberEni	Member eni not support ConnectionTrackingConfiguration.	诊断
400	InvalidParameter.NetworkCardIndexInvalid	The network card index is invalid or the current ECS/ENI type does not support the value.	诊断
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support Rss.	诊断
403	InvalidUserType.NotSupported	%s	诊断
403	Abs.InvalidAccount.NotFound	%s	诊断
403	Forbidden.NotSupportRAM	%s	诊断
403	Forbidden.SubUser	%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	InvalidInstanceId.NotFound	%s	诊断
403	InvalidEni.NotSameVpc	%s	诊断
403	InvalidOperation.Ipv4CountExceeded	%s	诊断
403	InvalidOperation.EniServiceManaged	%s	诊断
403	InvalidOperation.MultiGroupType	The specified instance can't join different types of security group.	诊断
403	InvalidOperation.NotSupportEnterpriseGroup	The specified instance type doesn't support enterprise level security group.	诊断
403	InvalidOperation.EniCountExceeded	The maximum number of eni in a enterprise level security group is exceeded.	诊断
403	InvalidOperation.EipBindModel	%s	诊断
403	InvalidOperation.Ipv6NotSupport	%s	诊断
403	InvalidOperation.HotPlugNotSupport	%s	诊断
403	InvalidInstance.NetworkType	%s	诊断
403	InvalidOperation.InvalidTrunkEniStatus	%s	诊断
403	InvalidOperation.TrunkingIsNotAllowed	%s	诊断
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	诊断
403	InvalidOperation.EniTypeNotSupportTrunking	%s	诊断
403	InvalidOperation.EniTrunkDeviceFull	%s	诊断
403	InvalidParameter.EniNotBelongTrunk	%s	诊断
403	InvalidOperation.EniTypeNotSupportAttachToTrunk	%s	诊断
403	InvalidParameter.EniNotBelongEcs	%s	诊断
403	InvalidParameter.InvalidEniQueueNumber	%s	诊断
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	诊断
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	诊断
403	InvalidOperation.HighPerformanceTrafficModeNotSupportTrunkEni	%s	诊断
403	InvalidOperation.HighPerformanceTrafficModeNotSupportMemberEni	%s	诊断
403	InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode	%s	诊断
403	InvalidOperation.EniTrafficModeNotSupportIpv6	%s	诊断
403	InvalidOperation.MaxEniQueuePairNumberExceed	%s	诊断
403	InvalidParameter.InvalidQueuePairNumber	%s	诊断
403	InvalidOperation.EniQueuePairNumberOverflow	%s	诊断
403	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	%s	诊断
403	InvalidOperation.Ipv6CountExceeded	%s.	诊断
404	InvalidEcsId.NotFound	%s	诊断
404	InvalidEniId.NotFound	%s	诊断
404	InvalidVSwitchId.NotFound	%s	诊断
404	InvalidSecurityGroupId.NotFound	%s	诊断
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-01-09	变更错误码400
	2024-09-12	变更错误码400 变更错误码403 新增错误码500
	2024-05-08	删除返回参数
	2024-05-07	变更错误码400
	2023-01-04	变更错误码400 新增请求参数NetworkCardIndex 新增返回参数

AttachNetworkInterface_云服务器 ECS_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例