CVM Removal Protection

Last updated: 2020-06-04 16:33:41


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

    1. API Description

    This API (SetCvmProtectedDetach) is used to set the sub-machine removal protection.
    Domain for API request:

    When the submachine is protected from removal, it will not be scaled down when replacement of unhealthy sub-machines, alarm policy and expected change trigger the scale-down.

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

    Parameter Name Required Type Description
    scalingGroupId Yes String ID of the scaling group of the submachine to be protected from removal. It can be queried by calling API Query Scaling Group List (DescribeScalingGroup).
    instanceIds.n Yes String An array containing the IDs of submachine to be protected from removal. Array subscript starts from 0.
    protectedFromDetach Yes Int Flag bit of removal protection, 1: to set sub-machine removal protection; 0: to cancel sub-machine removal protection.

    3. Output Parameters

    Parameter Name Type Description
    code Int Common error code; 0: Succeeded; other values: Failed. For more information, please refer to Common Error Codes on the Error Code page.
    codeDesc String Error code at business side. If the task succeeds, it will return "Success"; if the task fails, the specific business error reason will be returned.
    message String Module error message description depending on API.
    ## 4. Error Codes
    The following error codes only include the business logic error codes for this API. For additional common error codes, refer to AS Error Code.
    Error Code Description
    InvalidParameter.ScalingGroupIdError Incorrect scalingGroupId
    InvalidParameter.ProtectedFromDetach Error in setting flag bit of removal protection. 0: to cancel removal protection; 1: to set removal protection
    InvalidParameter.InstanceIdError Invalid submachine ID

    5. Example
    &<Common request parameters>

    Example of returned result is as below:


    Was this page helpful?

    Was this page helpful?

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