全部产品
Search

搜索本产品

    云服务器 ECS：DetachNetworkInterface - 从实例上分离弹性网卡（ENI）

    文档中心

    云服务器 ECS：DetachNetworkInterface - 从实例上分离弹性网卡（ENI）

    更新时间：Aug 28, 2026

    从一台ECS实例上分离一张弹性网卡（ENI）。

    接口说明

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

    • 不允许分离实例主网卡。

    • 弹性网卡必须处于分离中（Detaching）或者已附加（InUse）状态。

    • 实例必须处于运行中（Running）或者已停止（Stopped）状态。

    • 本接口为异步接口，调用成功后，您可以通过查询弹性网卡状态或监听网卡操作事件来感知操作结果， 弹性网卡状态机如下图所示：

      • Detaching 状态说明分离弹性网卡请求发送成功，弹性网卡正在从 ECS 实例分离。

      • Available 状态说明弹性网卡从 ECS 实例分离成功。

      • 若弹性网卡长时间为 Detaching 状态，可能是因为实例内部的操作系统不响应网卡的分离请求等原因导致了分离失败。此时，您可以对该弹性网卡重新发起分离请求，若长时间不成功的话，可以尝试重启实例后重试。

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

    调试

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

    调试

    授权信息

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

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ecs:DetachNetworkInterface

    update

    *NetworkInterface

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

    *Instance

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

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

    资源所属地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou
    RegionId

    string

    是

    资源所属地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou
    NetworkInterfaceId

    string

    是

    弹性网卡 ID。

    eni-bp67acfmxazb4p****
    InstanceId

    string

    是

    实例 ID。

    i-bp67acfmxazb4p****
    TrunkNetworkInstanceId

    string

    否

    中继网卡 ID。

    说明

    该参数暂未上线，不支持使用。

    eni-f8zapqwj1v1j4ia3****

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    示例

    正常返回示例

    JSON格式

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

    异常返回示例

    JSON格式

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

    错误码

    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 InvalidParams.EniId %s 指定的参数 EniId 无效。
    400 InvalidParameter.EniNotBelongEcs %s 指定的ENI不属于指定的ECS实例，具体信息请参见错误信息%s占位符的实际返回结果。您可以调用DescribeInstances查看指定ECS实例已附加的ENI ID。
    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. 开启了高性能通讯模式的弹性网卡不支持热拔出，请将该弹性网卡所挂载的ECS实例停机后重试。
    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 InvalidOperation.EniServiceManaged %s 操作无效。
    403 InvalidOperation.EniLinked %s 实例的当前弹性网卡关联了其他弹性网卡，导致操作无效。需要解除关联后才能从实例分离。
    403 InvalidInstanceId.NotFound %s 指定的实例不存在，请确认参数 InstanceId 是否正确。
    403 InvalidOperation.HotPlugNotSupport %s 指定的资源处于运行状态，不支持本次操作，具体信息请参见错误信息%s占位符的实际返回结果。
    403 InvalidOperation.InvalidTrunkEniStatus %s 指定的中继模式的ENI状态不允许执行本次操作，具体信息请参见错误信息%s占位符的实际返回结果。
    403 InvalidOperation.TrunkingIsNotAllowed %s 中继网卡不可操作。
    403 InvalidOperation.InstanceTypeNotSupportEniTrunking %s 不支持本次操作。具体信息请参见错误信息%s占位符的实际返回值。
    403 InvalidParameter.EniNotBelongTrunk %s 指定的ENI不属于中继模式的ENI，具体信息请参见错误信息%s占位符的实际返回结果。
    403 InvalidOperation.EniTypeNotSupportTrunking %s ENI的类型不支持中继模式的相关操作，具体信息请参见错误信息%s占位符的实际返回结果。
    403 InvalidOperation.HasMemberEniAttached %s 指定的中继模式的ENI附加了其它ENI，具体信息请参见错误信息%s占位符的实际返回结果。
    403 InvalidParameter.EniNotBelongEcs %s
    404 InvalidEcsId.NotFound %s 指定的实例 ID 不存在。
    404 InvalidEniId.NotFound %s
    404 InvalidVSwitchId.NotFound %s 指定的交换机不存在。
    404 InvalidSecurityGroupId.NotFound %s 指定的安全组 ID 不存在。

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

    变更历史

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