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

接口说明

调用该接口时，您需要注意：

不允许分离实例主网卡。
弹性网卡必须处于分离中（Detaching）或者已附加（InUse）状态。
实例必须处于运行中（Running）或者已停止（Stopped）状态。
本接口为异步接口，调用成功后，您可以通过查询弹性网卡状态或监听网卡操作事件来感知操作结果，弹性网卡状态机如下图所示：
- Detaching 状态说明分离弹性网卡请求发送成功，弹性网卡正在从 ECS 实例分离。
- Available 状态说明弹性网卡从 ECS 实例分离成功。
- 若弹性网卡长时间为 Detaching 状态，可能是因为实例内部的操作系统不响应网卡的分离请求等原因导致了分离失败。此时，您可以对该弹性网卡重新发起分离请求，若长时间不成功的话，可以尝试重启实例后重试。

调用示例详情参见分离弹性网卡。

流控信息

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

授权信息

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

具体说明如下：展开详情

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

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

请求参数

字段名称	字段详情
RegionIdstring	资源所属地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
NetworkInterfaceIdstring	弹性网卡 ID。示例值:eni-bp67acfmxazb4p****参考取值来源: CreateNetworkInterface DescribeNetworkInterfaces
InstanceIdstring	实例 ID。示例值:i-bp67acfmxazb4p****参考取值来源: RunInstances StopInstances CreateInstance StartInstances RebootInstances DescribeInstances ModifyManagedInstance RenewReservedInstances DetachInstanceRamRole AttachInstanceRamRole DeregisterManagedInstance PurchaseReservedInstancesOffering
TrunkNetworkInstanceIdstring	中继网卡 ID。展开详情示例值:eni-f8zapqwj1v1j4ia3****

返回参数

字段名称	字段详情
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	InvalidParams.EniId	%s	诊断
400	InvalidParameter.EniNotBelongEcs	%s	诊断
400	InvalidOperation.EniHotPlugNotSupported	The ENI with high-performance traffic mode cannot be hot-plugged. Please stop the ECS instance to which the ENI is attached, and try again.	诊断
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	InvalidOperation.EniServiceManaged	%s	诊断
403	InvalidOperation.EniLinked	%s	诊断
403	InvalidInstanceId.NotFound	%s	诊断
403	InvalidOperation.HotPlugNotSupport	%s	诊断
403	InvalidOperation.InvalidTrunkEniStatus	%s	诊断
403	InvalidOperation.TrunkingIsNotAllowed	%s	诊断
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	诊断
403	InvalidParameter.EniNotBelongTrunk	%s	诊断
403	InvalidOperation.EniTypeNotSupportTrunking	%s	诊断
403	InvalidOperation.HasMemberEniAttached	%s	诊断
403	InvalidParameter.EniNotBelongEcs	%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.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-09-24	新增错误码500
	2023-11-15	变更错误码400

DetachNetworkInterface_云服务器 ECS_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

错误码

变更历史

相关示例