1. 接口描述
本接口(DetachNetworkInterface)用于弹性网卡解绑云服务器。
接口请求域名:vpc.api.qcloud.com
1) 将弹性网卡和云服务器解绑。
2) 解绑之后弹性网卡上的所有弹性公网 IP 处于未关联状态,所有未关联状态的弹性公网 IP 将收取费用,详情请参见 弹性公网 IP 计费 。
3) 只有运行中或者已关机状态的云服务器才能绑定弹性网卡,查看云服务器状态详见 查看腾讯云服务器信息。
2. 输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 DetachNetworkInterface。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
vpcId | 是 | String | 弹性网卡对应的私用网络 ID,例如:vpc-7t9nf3pu |
networkInterfaceId | 是 | String | 弹性网卡 ID,例如:eni-m6dyj72l |
instanceId | 是 | String | 云服务器实例 ID,例如:ins-xx44545f |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
code | Int | 错误码。0:成功,其他值:失败 |
message | String | 错误信息 |
taskId | Int | 任务ID,操作结果可以用taskId查询,详见 查询任务执行结果接口。 |
4. 错误码表
以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码。
错误码 | 描述 |
---|---|
InvalidVpc.NotFound | 无效的 VPC,VPC 资源不存在。请再次核实您输入的资源信息是否正确,可通过 DescribeVpcEx 接口查询 VPC |
InvalidNetworkInterface.NotFound | 无效的弹性网卡,弹性网卡资源不存在。请再次核实您输入的资源信息是否正确,可通过 DescribeNetworkInterfaces 接口查询弹性网卡 |
InvalidInstance.NotFound | 无效的云服务器实例,云服务器实例资源不存在。请再次核实您输入的资源信息是否正确,可通过 DescribeInstances 接口查询云服务器实例 |
InvalidNetworkInterface.NotAttached | 弹性网卡和云服务器已解绑 |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=DetachNetworkInterface &<公共请求参数> &vpcId=vpc-7t9nf3pu &networkInterfaceId=eni-m6dyj72l &instanceId=ins-xx44545f
输出
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data":
{
"taskId": 16284
}
}