Unbind ENI with CVM

Last updated: 2018-08-27 17:38:29

1. API Description

This API (DetachNetworkInterface) is used to unbind ENIs.
Domain for API request: vpc.api.qcloud.com

1) Unbind ENIs from the CVM.
2) After the ENIs are unbound, all the EIP addresses will be unassociated with the ENIs and be charged accordingly. For details on the billing methods, refer to EIP Billing Method.
3) Only CVMs that are in a running/shutdown status can bind ENIs. For details on the CVM status, refer to Query CVM Information.

2. Input Parameters

The following request parameter list only provides API request parameters. Common request parameters need to be added when the API is called. For more information, refer to Common Request Parameters. The Action field for this API is DetachNetworkInterface.

Parameter Name Required Type Description
vpcId Yes String Virtual private cloud ID of ENI, for example: vpc-7t9nf3pu
networkInterfaceId Yes String ENI ID, for example: eni-m6dyj72l
instanceId Yes String CVM instance ID, for example: ins-xx44545f

3. Output Parameters

Parameter Name Type Description
code Int Error code. 0: Succeeded; other values: Failed.
message String Error message
taskId Int Task ID. The operation result can be queried with taskId. For more information, refer to API for Querying Task Execution Result.

4. Error Code Table

The following error code list only provides the business logic error codes for this API. For additional common error codes, refer to VPC Error Codes.

Error Code Description
InvalidVpc.NotFound VPC does not exist. Please check the information you entered. You can query the VPC via the DescribeVpcEx API
InvalidNetworkInterface.NotFound ENI does not exist. Please check the information you entered. You can query the ENI via the DescribeNetworkInterfaces API
InvalidInstance.NotFound CVM instance does not exist. Please check the information you entered. You can query the CVM instance via the DescribeInstances API
InvalidNetworkInterface.NotAttached The ENI is already unbound from the CVM

5. Example

Input


https://vpc.api.qcloud.com/v2/index.php?Action=DetachNetworkInterface
&<Common request parameters>
&vpcId=vpc-7t9nf3pu
&networkInterfaceId=eni-m6dyj72l
&instanceId=ins-xx44545f

Output

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data":
        {
            "taskId": 16284
        }
}