Unbind Back-end Server

Last updated: 2019-11-29 16:58:33

    API Description

    This API (DeregisterInstancesFromLoadBalancer) is used to unbind one or more CVMs from a load balancer instance.

    Domain name for API access: lb.api.qcloud.com

    Request Parameters

    The following request parameter list only provides the API request parameters. Common request parameters are required when the API is called. The Action field for this API is DeregisterInstancesFromLoadBalancer.

    Parameter Name Required Type Description
    loadBalancerId Yes String ID of the load balancer instance, which can be queried via the API DescribeLoadBalancers.
    backends.n.instanceId Yes String Unique ID of the CVM, which can be obtained from "unInstanceId" (recommended) or "instanceId" in the returned fields of API DescribeInstances. This API allows entering instance IDs of multiple CVMs at a time. For example, if you want to enter two CVMs, enter: backends.0.instanceId&backends.1.instanceId.

    Response Parameters

    Parameter Name Type Description
    code Int Common error code; 0: Successful; other values: Failed.
    message String Module error message description depending on API.
    codeDesc String Error code. For a successful operation, "Success" is returned. For a failed operation, a message describing the failure is returned.
    requestId Int Request task ID. The API is an asynchronous task. DescribeLoadBalancersTaskResult is used to query the result of task execution.

    Example

    Request

    https://lb.api.qcloud.com/v2/index.php?Action=DeregisterInstancesFromLoadBalancer
    &<Common request parameters>
    &loadBalancerId=lb-abcdefgh
    &backends.0.instanceId=ins-1234test
    &backends.1.instanceId=ins-6789test
    

    Response

    {
      "code" : 0,
      "message" : "",
      "codeDesc": "Success",
      "requestId" : 1234
    }

    Was this page helpful?

    Was this page helpful?

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