调用AttachNetworkInterface为ECS实例附加弹性网卡-云服务器 ECS-阿里云-云服务器 ECS(ECS)-阿里云帮助中心

调用AttachNetworkInterface接口，并可以指定NetworkInterfaceId、InstanceId、NetworkCardIndex等参数，附加一个弹性网卡（ENI）到一台专有网络VPC类型ECS实例上。

接口说明

调用该接口时，请注意：

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

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

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:AttachNetworkInterface

update

*NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	实例所在地域的 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
RegionId	string	是	实例所在地域的 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
NetworkInterfaceId	string	是	弹性网卡 ID。	eni-bp17pdijfczax1huji****
InstanceId	string	是	实例 ID。	i-bp16qstyvxj9gpqw****
TrunkNetworkInstanceId	string	否	中继网卡 ID。说明该参数暂未上线，不支持使用。	eni-f8zapqwj1v1j4ia3****
WaitForNetworkConfigurationReady	boolean	否	说明该参数已废弃。	null
NetworkCardIndex	integer	否	网卡指定的物理网卡索引。说明 NetworkCardIndex 取值与实例规格族有关。如果实例规格不支持 NetworkCard 则不能指定；如果支持，取值请参见实例规格族。	0

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HTTP status code	错误码	错误信息	描述
400	MissingParameter	%s	缺失参数，请检查参数是否完整。
400	UnsupportedParameter	%s	不支持参数。
400	InvalidParameter	%s	无效的参数。
400	InvalidInstanceID.Malformed	%s	参数 InstanceId 格式错误。
400	InvalidOperation.InvalidRegion	%s	指定的参数 RegionId 无效。
400	InvalidOperation.InvalidEcsState	%s	实例当前的状态不支持此操作。
400	InvalidOperation.InvalidEniState	%s	弹性网卡当前的状态不支持此操作。
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	不允许分离实例的主网卡。
400	Forbidden.RegionId	%s	当前地域暂时没有提供该服务。
400	InvalidOperation.InvalidGeneration	%s	该操作无效。
400	InvalidParams.EniId	%s	指定的参数 EniId 无效。
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.	指定实例的规格不支持开启Rss
400	OperationDenied.NoEniStock	The requested resource of ENI is insufficient in the specified ECS, please retry or upgrade to enterprise-level computing instance types.	当前实例上的 ENI 库存资源不足，请重试或升配到企业级规格。
400	InvalidOperation.InstanceTypeNotSupportSriov	The specified instance type does not support ENI Sriov.	该实例规格不支持弹性网卡的Sriov能力。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误，请重试。
500	InvalidSecurityGroupId.EniMustHaveSecurityGroup	The specified network card does not have an associated security group.	指定的网卡没有关联的安全组。
403	InvalidUserType.NotSupported	%s	您当前的账号不支持此操作。
403	Abs.InvalidAccount.NotFound	%s	您的阿里云账号不存在，或者您的 AccessKey 已经过期。
403	Forbidden.NotSupportRAM	%s	暂不支持RAM用户执行该操作。
403	Forbidden.SubUser	%s	您的账号没有操作此资源的权限，请向主账号申请相关的权限。
403	MaxEniCountExceeded	%s	已超过可以操作的最大弹性网卡数。
403	EniPerInstanceLimitExceeded	%s	实例附加的弹性网卡数量已经达到了最大限度，不能再为实例附加弹性网卡。
403	InvalidOperation.AvailabilityZoneMismatch	%s	该操作无效。
403	InvalidOperation.VpcMismatch	%s	您的操作无效，请确认该操作中的 VPC 与其它参数是否匹配。
403	SecurityGroupInstanceLimitExceed	%s	该安全组内已有的实例数量已达到最大限制。
403	InvalidSecurityGroupId.NotVpc	%s	参数 SecurityGroupId 无效，该安全组的网络类型不是专有网络。
403	InvalidOperation.InvalidEniType	%s	当前弹性网卡的类型不支持此操作。
403	InvalidInstanceId.NotFound	%s	指定的实例不存在，请确认参数 InstanceId 是否正确。
403	InvalidEni.NotSameVpc	%s	指定的资源和指定的ENI不属于同一个VPC。具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.Ipv4CountExceeded	%s	IPv4 数量达到上限，导致该操作无效。
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	IPv6不支持当前操作。
403	InvalidOperation.HotPlugNotSupport	%s	指定的资源处于运行状态，不支持本次操作，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidInstance.NetworkType	%s
403	InvalidOperation.InvalidTrunkEniStatus	%s	指定的中继模式的ENI状态不允许执行本次操作，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.TrunkingIsNotAllowed	%s	中继网卡不可操作。
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	不支持本次操作。具体信息请参见错误信息%s占位符的实际返回值。
403	InvalidOperation.EniTypeNotSupportTrunking	%s	ENI的类型不支持中继模式的相关操作，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.EniTrunkDeviceFull	%s
403	InvalidParameter.EniNotBelongTrunk	%s	指定的ENI不属于中继模式的ENI，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.EniTypeNotSupportAttachToTrunk	%s
403	InvalidParameter.EniNotBelongEcs	%s
403	InvalidParameter.InvalidEniQueueNumber	%s	弹性网卡队列数有误，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	弹性网卡队列数超过上限，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	弹性网卡队列总数超过上限，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.HighPerformanceTrafficModeNotSupportTrunkEni	%s
403	InvalidOperation.HighPerformanceTrafficModeNotSupportMemberEni	%s
403	InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode	%s	指定实例的实例规格不支持RDMA通信模式的网卡。
403	InvalidOperation.EniTrafficModeNotSupportIpv6	%s
403	InvalidOperation.MaxEniQueuePairNumberExceed	%s
403	InvalidParameter.InvalidQueuePairNumber	%s
403	InvalidOperation.EniQueuePairNumberOverflow	%s
403	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	%s
403	InvalidOperation.Ipv6CountExceeded	%s.	IPv6 数量达到上限，导致该操作无效。
403	InvalidOperation.PrimaryEniNotExist	Primary Eni Not Exist.	实例主网卡不存在。
404	InvalidEcsId.NotFound	%s	指定的实例 ID 不存在。
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	指定的交换机不存在。
404	InvalidSecurityGroupId.NotFound	%s	指定的安全组 ID 不存在。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。