You need to enable JavaScript to run this app.
导航
DetachNetworkInterface
最近更新时间:2024.07.09 08:30:22首次发布时间:2021.07.29 14:11:54

调用 DetachNetworkInterface 接口,从指定的云服务器实例上卸载辅助网卡。

调用说明

  • 云服务器实例的状态为运行中已停止才支持卸载网卡。
  • 主网卡、火山引擎官方服务网卡不支持卸载。
  • DetachNetworkInterface 为异步接口,即返回请求ID时,系统后台仍在配置。您可调用 DescribeNetworkInterfaceAttributes 查看网卡的状态,Detaching表示卸载中,Available 表示卸载完成。

调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringDetachNetworkInterface要执行的操作。取值: DetachNetworkInterface。
VersionString2020-04-01API版本信息,取值为:2020-04-01。

NetworkInterfaceId

String

eni-bp1fgnh68xyz9****

辅助网卡ID。
您可以调用 DescribeNetworkInterfaces 接口,查询网卡的ID。

InstanceId

String

i-wijfn35c****

云服务器的ID。
您可以调用 DescribeInstances 接口,查询云服务器实例的ID。

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。

请求示例

GET /?Action=DetachNetworkInterface&Version=2020-04-01&NetworkInterfaceId=eni-bp1fgn8xyz9****&InstanceId=i-wijfn35c**** HTTP/1.1
Host: open.volcengineapi.com
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "DetachNetworkInterface",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "2021062415303301022514515207C4****"
    }
}

错误码

此处仅展示当前API的错误码,更多错误码请参见公共错误码

HttpCode
错误码
错误信息
描述
400InvalidEni.InstanceMismatchThe specified elastic network interface is not attached to the specified instance.指定的弹性网卡没有绑定到ECS实例。
400InvalidEni.InvalidStatusThe specified elastic network interface is not in the correct status for the request.指定的弹性网卡所处的状态无法响应该请求。
400InvalidInstance.InvalidStatusThe specified instance is not in the correct status for the request.指定的ECS实例所处的状态无法响应该请求。
403ForbiddenYou are not authorized to perform operations on the specified elastic network interface. The specified elastic network interface is a service-managed elastic network interface.无权限对指定弹性网卡进行操作。指定的弹性网卡为云产品托管的弹性网卡。
404InvalidEniId.NotFoundThe specified elastic network interface does not exist.指定的弹性网卡不存在。
404InvalidInstance.NotFoundThe specified instance does not exist.指定的ECS实例不存在。
409InvalidOperation.ConflictThe specified resource operation conflicts.指定的资源操作冲突。