Tous les produits
Search

Ce produit

    Auto Scaling:RemoveInstances

    Centre de documentation

    Auto Scaling:RemoveInstances

    Dernière mise à jour :Aug 18, 2026

    Supprime une ou plusieurs instances d'un groupe de mise à l'échelle. Si votre groupe de mise à l'échelle est activé et qu'aucune activité de mise à l'échelle n'est en cours, appelez l'opération RemoveInstances pour retirer les instances dont vous n'avez plus besoin du groupe.

    Notes d'utilisation

    • Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

      • Le groupe de mise à l'échelle est dans l'état Active.

      • Aucune activité de mise à l'échelle n'est en cours pour le groupe.

    Si aucune activité de mise à l'échelle n'est en cours, vous pouvez appeler l'opération même pendant la période de temporisation (cooldown).

    • Si une instance Elastic Compute Service (ECS) est créée automatiquement par Auto Scaling, ou si elle est ajoutée manuellement à un groupe de mise à l'échelle et gérée par ce dernier, l'instance ECS passe en mode économique (Economical Mode) ou est libérée lors de son retrait du groupe.

    • Si une instance ECS est ajoutée manuellement à un groupe de mise à l'échelle sans être gérée par celui-ci, l'instance n'est ni arrêtée ni libérée lors de son retrait.

    • L'appel échoue si la différence entre le nombre d'instances ECS existantes spécifié par TotalCapacity et le nombre d'instances ECS à supprimer est inférieure à la valeur de MinSize.

    Un appel réussi indique uniquement qu'Auto Scaling a accepté la demande. Il ne garantit pas le succès de l'activité de mise à l'échelle. Consultez la valeur de ScalingActivityId dans la réponse pour obtenir le statut de l'activité.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

    Paramètres de requête

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    RemoveInstances

    Opération à effectuer. Définissez la valeur sur RemoveInstances.

    ScalingGroupId

    String

    Yes

    asg-bp18p2yfxow2dloq****

    ID du groupe de mise à l'échelle.

    RemovePolicy

    String

    No

    release

    Action qu'Auto Scaling doit effectuer après le retrait des instances ECS du groupe de mise à l'échelle. Valeurs valides :

    • recycle : place les instances ECS en mode économique (Economical Mode).

      Remarque

      Ce paramètre prend effet uniquement si vous définissez ScalingPolicy sur recycle.

    • release : libère les instances ECS.

      ScalingPolicy dans l'opération CreateScalingGroup spécifie le mode de récupération du groupe de mise à l'échelle. RemovePolicy dans l'opération RemoveInstances spécifie l'action spécifique sur une instance lors de sa suppression. Exemples :

      • Si vous définissez ScalingPolicy et RemovePolicy sur recycle, les instances ECS passent en mode économique (Economical Mode) lorsqu'elles sont supprimées.

      • Si vous définissez ScalingPolicy sur recycle et RemovePolicy sur release, les instances ECS sont libérées lorsqu'elles sont supprimées.

      • Si vous définissez ScalingPolicy sur release et RemovePolicy sur recycle, les instances ECS sont libérées lorsqu'elles sont supprimées.

      • Si vous définissez ScalingPolicy et RemovePolicy sur release, les instances ECS sont libérées lorsqu'elles sont supprimées.

    Valeur par défaut : release.

    DecreaseDesiredCapacity

    Boolean

    No

    true

    Indique s'il faut modifier le nombre attendu d'instances ECS dans le groupe de mise à l'échelle. Valeurs valides :

    • true : après le retrait des instances ECS du groupe de mise à l'échelle, le nombre attendu d'instances ECS dans le groupe diminue.

    • false : après le retrait des instances ECS du groupe de mise à l'échelle, le nombre attendu d'instances ECS dans le groupe reste inchangé.

    Valeur par défaut : true.

    IgnoreInvalidInstance

    Boolean

    No

    false

    Indique s'il faut ignorer les instances non valides lors de la suppression d'un lot d'instances du groupe de mise à l'échelle. Valeurs valides :

    • true : ignore les instances non valides.

      Si le lot d'instances comprend des instances non valides, telles que des instances dans l'état Adding, et que les instances valides sont correctement supprimées du groupe de mise à l'échelle, l'activité de mise à l'échelle correspondante passe à l'état Warning. Accédez à la page des détails de l'activité de mise à l'échelle pour afficher les instances non valides.

    • false : n'ignore pas les instances non valides.

      Si le lot d'instances comprend des instances non valides, telles que des instances dans l'état Adding, une erreur est signalée.

    Valeur par défaut : false.

    InstanceId.N

    String

    No

    i-28wt4****

    ID de l'instance ECS N à supprimer. Valeurs valides pour N : 1 à 20.

    RegionId

    String

    No

    cn-qingdao

    ID de la région où réside le groupe de mise à l'échelle.

    ClientToken

    String

    No

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

    Jeton client utilisé pour garantir l'idempotence de la requête.

    Vous pouvez utiliser le client pour générer le jeton, mais assurez-vous qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Garantir l'idempotence.

    StopInstanceTimeout

    Integer

    No

    60

    Durée requise pour que chaque instance ECS passe à l'état Stopped (Arrêté) pendant le processus de réduction de capacité (scale-in). Unité : secondes.

    Valeurs valides : 30 à 240.

    Remarque

    • Par défaut, ce paramètre hérite de la valeur spécifiée pour le groupe de mise à l'échelle. Vous pouvez également modifier la valeur lors de l'appel de l'opération RemoveInstances.

    • Ce paramètre prend effet uniquement si vous définissez RemovePolicy sur release.

    • Si vous spécifiez ce paramètre, le système poursuit le processus de réduction de capacité uniquement après la fin de la période spécifiée par StopInstanceTimeout. Dans ce cas, l'opération de réduction de capacité se poursuit indépendamment du fait que l'instance ECS passe ou non à l'état Stopped.

    • Si vous ne spécifiez pas ce paramètre, le système poursuit le processus de réduction de capacité uniquement après que l'instance ECS est passée à l'état Stopped. Si l'instance ECS ne parvient pas à passer à l'état Stopped, le processus de réduction de capacité est annulé et l'opération de réduction de capacité est considérée comme ayant échoué.

    LifecycleHookContext

    Object

    No

    Contexte du hook de cycle de vie.

    DisableLifecycleHook

    Boolean

    No

    false

    Indique s'il faut désactiver la fonctionnalité de hook de cycle de vie. Valeurs valides :

    • true

    • false

    IgnoredLifecycleHookIds

    Array of String

    No

    ash-bp14zolna43z266bq***

    ID des hooks de cycle de vie à désactiver.

    Paramètres de réponse

    Parameter

    Type

    Example

    Description

    ScalingActivityId

    String

    asa-bp175o6f6ego3r2j****

    ID de l'activité de mise à l'échelle.

    RequestId

    String

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

    ID de la requête.

    Exemples

    Exemples de requêtes

    http(s)://ess.aliyuncs.com/?Action=RemoveInstances
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&RemovePolicy=release
&DecreaseDesiredCapacity=true
&IgnoreInvalidInstance=false
&InstanceId=["i-28wt4****"]
&RegionId=cn-qingdao
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>

    Exemples de réponses réussies

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<RemoveInstancesResponse>
    <ScalingActivityId>asa-bp175o6f6ego3r2j****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</RemoveInstancesResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

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

    Codes d'erreur

    Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.

    HTTP status code

    Error code

    Error message

    Description

    404

    InvalidScalingGroupId.NotFound

    The specified scaling group does not exist.

    Le groupe de mise à l'échelle spécifié n'existe pas dans le compte Alibaba Cloud.

    404

    InvalidInstanceId.NotFound

    Instance "XXX" does not exist.

    L'instance ECS spécifiée n'existe pas dans le groupe de mise à l'échelle.

    400

    InvalidParameter

    The specified group does not support the specified RemovePolicy.

    Le groupe de mise à l'échelle spécifié ne prend pas en charge le paramètre RemovePolicy.

    403

    Forbidden.Unauthorized

    A required authorization for the specified action is not supplied.

    Auto Scaling n'est pas autorisé à appeler l'opération.

    400

    IncorrectScalingGroupStatus

    The current status of the specified scaling group does not support this action.

    Le groupe de mise à l'échelle n'est pas dans l'état Active.

    400

    ScalingActivityInProgress

    You cannot delete a scaling group or launch a new scaling activity while there is a scaling activity in progress for the specified scaling group.

    Une activité de mise à l'échelle est en cours pour le groupe de mise à l'échelle.

    400

    IncorrectLoadBalancerStatus

    The current status of the specified load balancer does not support this action.

    L'instance Server Load Balancer (SLB) du groupe de mise à l'échelle auquel appartient la règle de mise à l'échelle spécifiée n'est pas dans l'état Active.

    400

    IncorrectDBInstanceStatus

    The current status of DB instance "XXX" does not support this action.

    L'instance ApsaraDB RDS du groupe de mise à l'échelle auquel appartient la règle de mise à l'échelle spécifiée n'est pas dans l'état Running.

    400

    IncorrectCapacity.MinSize

    To remove the instances, the total capacity will be lesser than the MinSize.

    La différence entre le nombre d'instances ECS existantes spécifié par TotalCapacity et le nombre d'instances ECS à supprimer est inférieur à la valeur de MinSize.