All Products
Search

This Product

    Auto Scaling:DetachAlbServerGroups

    Document Center

    Auto Scaling:DetachAlbServerGroups

    Last Updated:Sep 10, 2026

    Removes one or more Application Load Balancer (ALB) server groups from a scaling group.

    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
    RegionId

    string

    Yes

    The region ID of the scaling group, such as ap-southeast-1. For more information, see Regions and zones.

    cn-hangzhou
    ScalingGroupId

    string

    Yes

    The ID of the scaling group.

    asg-bp18p2yfxow2dloq****
    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****
    ForceDetach

    boolean

    No

    Specifies whether to remove existing ECS instances from the ALB server groups to be detached.

    • true: removes the instances and returns a ScalingActivityId. You can check the scaling activity ID to determine whether the existing instances are removed.

    • false: does not remove the instances.

    Default value: false.

    false
    AlbServerGroup

    array<object>

    Yes

    The list of ALB server groups.

    object

    No

    AlbServerGroupId

    string

    Yes

    The ID of the ALB server group. N specifies the sequence number of the ALB server group.

    sgp-ddwb0y0g6y9bjm****
    Port

    integer

    Yes

    The port number used by ECS instances in the ALB server group. N specifies the sequence number of the ALB server group.

    22

    Response elements

    Element

    Type

    Description

    Example

    object

    ScalingActivityId

    string

    The ID of the scaling activity that is triggered when the ALB server groups are removed along with the ECS instances in the ALB server groups. This parameter is returned only when ForceDetach is set to true.

    asa-2ze6wxj8vsohn6j9****
    RequestId

    string

    The request ID.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    Examples

    Success response

    JSON format

    {
  "ScalingActivityId": "asa-2ze6wxj8vsohn6j9****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.