Delete ENIs

Last updated: 2020-06-04 17:55:25

    Note:

    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new VPC API 3.0 which is standardized and faster.

    1. API Description

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

    1) An ENI cannot be deleted when it is bound to a CVM.
    2) To delete a specified ENI, the ENI must be unbound from the sub-machine first. After the ENI is deleted, all the private IPs on it will be returned.

    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 DeleteNetworkInterface.

    Parameter Name Required Type Description
    vpcId Yes String Virtual private cloud ID of ENI, for example: vpc-7t9nf3pu
    networkInterfaceId Yes String ENI ID assigned by the system, for example: eni-m6dyj72l

    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.

    4. Error Codes

    The following 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 by using the DescribeVpcEx API
    InvalidNetworkInterface.NotFound ENI does not exist. Please check the information you entered. You can query the ENI via the DescribeNetworkInterfaces API
    InvalidNetworkInterface.CanNotDelete The ENI cannot be deleted because it is bound to a CVM

    5. Example

    Input

    https://vpc.api.qcloud.com/v2/index.php?Action=DeleteNetworkInterface
    &>
    &vpcId=vpc-7t9nf3pu
    &networkInterfaceId=eni-m6dyj72l
    

    Output

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

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help