DeleteNetworkInterface - 删除弹性网卡（ENI） - 云服务器 ECS

异步删除一张弹性网卡（ENI）。

接口说明

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

弹性网卡必须处于可用（Available）状态。
如果弹性网卡已经附加到 ECS 实例，必须先从实例分离（ DetachNetworkInterface ），才能删除弹性网卡。
删除弹性网卡之后：
- 弹性网卡的所有私有地址（包括主私网地址和辅助私网地址）会自动释放。
- 被删除的弹性网卡退出所属的所有安全组。
本接口为异步接口，调用成功后，您可以通过查询弹性网卡状态或监听网卡操作事件来感知操作结果，弹性网卡状态机如下图所示：
- Deleting 说明删除弹性网卡请求发送成功，弹性网卡正在删除中。
- 若无法查询到弹性网卡，说明弹性网卡删除成功。
- 若弹性网卡状态长时间为 Deleting 说明删除失败，此时您可以重新发起删除请求弹性网卡操作。

调用示例详情参见删除弹性网卡。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DeleteNetworkInterface

delete

*NetworkInterface

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

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
NetworkInterfaceId	string	是	弹性网卡的 ID。	eni-bp14v2sdd3v8htln****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	F3CD6886-D8D0-4FEE-B93E-1B73239673DE

示例

正常返回示例

JSON格式

{
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

异常返回示例

JSON格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidOperation.HasSlaveEniBonded	%s	该网卡还有与其绑定的SLAVE网卡
400	MissingParameter	%s	缺失参数，请检查参数是否完整。
400	UnsupportedParameter	%s	不支持参数。
400	InvalidParameter	%s	无效的参数。
400	InvalidInstanceID.Malformed	%s	参数 InstanceId 格式错误。
400	InvalidOperation.InvalidEcsState	%s	实例当前的状态不支持此操作。
400	InvalidOperation.InvalidEniState	%s	弹性网卡当前的状态不支持此操作。
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	不允许分离实例的主网卡。
400	Forbidden.RegionId	%s	当前地域暂时没有提供该服务。
400	InvalidParams.EniId	%s	指定的参数 EniId 无效。
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	InvalidEniId.NotFound	%s	指定的弹性网卡 ID 不存在。
403	InvalidOperation.EniServiceManaged	%s	操作无效。
403	InvalidOperation.TrunkingIsNotAllowed	The account is not authorized to use trunk ENI or perform trunking operation.	不允许操作中继网卡。您需要确保您的账号允许操作Trunk网卡。如有疑问，请提交工单。
404	InvalidEcsId.NotFound	%s	指定的实例 ID 不存在。
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	指定的交换机不存在。
404	InvalidSecurityGroupId.NotFound	%s	指定的安全组 ID 不存在。

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

变更历史

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