私有网络
私有网络
文档指南
请输入
产品动态
产品计费
用户指南
网卡
安全组
API参考
私有网络
子网
路由表
网卡
安全组
前缀列表
高可用虚拟IP
流日志
网络ACL
流量镜像
IPv4网关实例
- 文档首页
私有网络API参考网卡DetachNetworkInterface - 卸载辅助网卡
复制全文
下载 pdfDetachNetworkInterface - 卸载辅助网卡
文档反馈
问问助手调用 DetachNetworkInterface 接口，从指定的云服务器实例上卸载辅助网卡。
使用说明
- 云服务器实例的状态为运行中或已停止才支持卸载网卡。
- 主网卡、火山引擎官方服务网卡不支持卸载。
- DetachNetworkInterface 为异步接口，即返回请求ID时，系统后台仍在配置。您可调用 DescribeNetworkInterfaceAttributes 查看网卡的状态，Detaching表示卸载中，Available 表示卸载完成。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action String 必选 示例值：DetachNetworkInterface
接口名称。当前 API 的名称为DetachNetworkInterface。
Version String 必选 示例值：2020-04-01
接口版本。当前 API 的版本为 2020-04-01。
NetworkInterfaceId String 必选 示例值：eni-bp1fgnh68xyz9****
辅助网卡ID。
返回参数
RequestId String 示例值：2021062415303301022514515207C4****
请求ID。
请求示例
GET /?Action=DetachNetworkInterface&Version=2020-04-01&NetworkInterfaceId=eni-bp1fgn8xyz9****&InstanceId=i-wijfn35c**** HTTP/1.1
Host: vpc.cn-beijing.volcengineapi.com
X-Date: 20251121T094038Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420****100232280022D31",
"Action": "DetachNetworkInterface",
"Version": "2020-04-01",
"Service": "vpc",
"Region": "cn-beijing"
},
"Result": {
"RequestId": "2021062415303301022514515207C4****"
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidEip.InUse | The specified EIP is being operated by another request. | 指定的EIP正被另一个请求操作，请稍后再试。 |
400 | InvalidEni.InstanceMismatch | The specified elastic network interface is not attached to the specified instance. | 指定的弹性网卡没有绑定到ECS实例。 |
400 | InvalidEni.InvalidStatus | The specified elastic network interface is not in the correct status for the request. | 指定的弹性网卡所处的状态无法响应该请求。 |
400 | InvalidEni.InvalidType | The type of specified elastic network interface is illegal for the request. | 指定类型的弹性网卡无法响应该请求。 |
400 | InvalidInstance.InvalidStatus | The specified instance is not in the correct status for the request. | 指定的ECS实例所处的状态无法响应该请求。 |
400 | InvalidTrafficMirrorSession.InvalidStatus | The specified traffic mirror session is not in the correct status for the request. | 指定的镜像流量会话所处的状态无法响应该请求。 |
400 | InvalidVpcEip.InUse | The specified vpc eip is being operated by another request. | 指定的EIP正被另一个请求操作，请稍后再试。 |
403 | Forbidden | You are not authorized to perform operations on the specified elastic network interface. The specified elastic network interface is a service-managed elastic network interface. | 无权限对指定弹性网卡进行操作。指定的弹性网卡为云产品托管的弹性网卡。 |
404 | InvalidEniId.NotFound | The specified elastic network interface does not exist. | 指定的弹性网卡不存在。 |
404 | InvalidInstance.NotFound | The specified instance does not exist. | 指定的ECS实例不存在。 |
最近更新时间：2026.02.09 16:06:03
这个页面对您有帮助吗？
有用
有用
无用
无用