All Products
Search

This Product

    Auto Scaling:DetachLoadBalancers

    Document Center

    Auto Scaling:DetachLoadBalancers

    Last Updated:Sep 10, 2026

    Removes one or more load balancing instances.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ScalingGroupId

    string

    Yes

    The ID of the scaling group.

    asg-bp1ffogfdauy0jw0****
    ForceDetach

    boolean

    No

    Specifies whether to remove ECS instances that belong to the current scaling group from the backend servers of the load balancing instance after the load balancing instance is removed. Valid values:

    • true: Removes the ECS instances.

    • false: Does not remove the ECS instances.

    Default value: false.

    false
    ClientToken

    string

    No

    The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests.

    The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

    123e4567-e89b-12d3-a456-42665544****
    Async

    boolean

    No

    Specifies whether to use asynchronous invocation when removing load balancing instances. Asynchronous invocation ensures the transactional nature of the operation, which means that either all operations execute successfully or none of the operations take effect if one fails. Use asynchronous invocation.

    Valid values:

    • true: Asynchronous invocation. The request returns the ID of the scaling activity.

    • false: Synchronous call.

    Default value: false.

    false
    LoadBalancer

    array

    Yes

    The ID of the load balancing instance. You can remove up to five load balancing instances at a time.

    lb-2zeur05gfs****

    string

    No

    The ID of the load balancing instance. You can remove up to five load balancing instances at a time.

    lb-2zeur05gfs****
    RegionId

    string

    No

    The region ID of the scaling group.

    cn-qingdao

    Response elements

    Element

    Type

    Description

    Example

    object

    ScalingActivityId

    string

    The ID of the scaling activity.

    This value is returned only when Async=true. You can call the DescribeScalingActivities operation to query the returned scaling activity ID and check the execution status of the scaling activity.

    asa-bp140qd7mak8k63f****
    RequestId

    string

    The request ID.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    Examples

    Success response

    JSON format

    {
  "ScalingActivityId": "asa-bp140qd7mak8k63f****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.