RemoveInstances - Auto Scaling - Centre de documentation Alibaba Cloud

Supprime une ou plusieurs instances inutiles d'un groupe de mise à l'échelle. Vous pouvez appeler l'opération API RemoveInstances pour supprimer des instances lorsque le groupe de mise à l'échelle est à l'état activé et qu'aucune activité de mise à l'échelle n'est en cours.

Description de l'opération

Avant d'appeler cette opération, assurez-vous que les conditions suivantes sont remplies :
- Le groupe de mise à l'échelle est dans l'état activé (Active).
- Aucune activité de mise à l'échelle n'est en cours dans le groupe de mise à l'échelle.

Remarque

Si aucune activité de mise à l'échelle n'est en cours dans le groupe de mise à l'échelle, le système peut contourner le délai de temporisation (DefaultCooldown) et exécuter directement cette opération.

Si une instance ECS a été créée par Auto Scaling, ou a été ajoutée manuellement mais est gérée par le groupe de mise à l'échelle, l'instance ECS active le mode économique ou est libérée lorsque vous la retirez du groupe de mise à l'échelle.
Si une instance ECS a été ajoutée manuellement et n'est pas gérée par le groupe de mise à l'échelle, elle n'est ni arrêtée ni libérée lorsque vous la retirez du groupe de mise à l'échelle.
Si le nombre actuel d'instances dans le groupe de mise à l'échelle (TotalCapacity) moins le nombre d'instances spécifié dans cette opération est inférieur au nombre minimum d'instances (MinSize) du groupe de mise à l'échelle, l'appel de l'opération échoue.

Une réponse réussie indique uniquement que le service Auto Scaling a accepté la requête et que l'activité de mise à l'échelle peut être exécutée. Cela ne signifie pas que l'activité de mise à l'échelle sera exécutée avec succès. Vous devez utiliser le ScalingActivityId renvoyé pour vérifier l'état d'exécution de l'activité de mise à l'échelle.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ess:DetachInstances

update

*Groupe de mise à l'échelle.

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ScalingGroupId	string	Oui	L'identifiant du groupe de mise à l'échelle.	asg-bp18p2yfxow2dloq****
RemovePolicy	string	Non	Spécifie l'action à effectuer sur les instances ECS retirées. Valeurs valides : recycle : les instances ECS déclenchent le mode économique. Remarque Cette valeur prend effet uniquement lorsque ScalingPolicy est défini sur recycle. release : les instances ECS sont libérées. Le paramètre ScalingPolicy de CreateScalingGroup spécifie le mode de récupération du groupe de mise à l'échelle, mais l'action spécifique effectuée lorsqu'une instance est retirée est déterminée par le paramètre RemovePolicy de RemoveInstances. Exemples : Si ScalingPolicy est défini sur recycle et RemovePolicy sur recycle, les instances ECS déclenchent le mode économique. Si ScalingPolicy est défini sur recycle et RemovePolicy sur release, les instances ECS sont libérées. Si ScalingPolicy est défini sur release et RemovePolicy sur recycle, les instances ECS sont libérées. Si ScalingPolicy est défini sur release et RemovePolicy sur release, les instances ECS sont libérées. Valeur par défaut : release.	release
DecreaseDesiredCapacity	boolean	Non	Indique si le nombre d'instances attendu doit être modifié. Valeurs valides : true : après le retrait des instances ECS du groupe de mise à l'échelle, le nombre d'instances attendu est réduit du nombre d'instances retirées. false : après le retrait des instances ECS du groupe de mise à l'échelle, le nombre d'instances attendu reste inchangé. Valeur par défaut : true.	true
IgnoreInvalidInstance	boolean	Non	Indique si les instances non valides doivent être ignorées lors du retrait d'un lot d'instances du groupe de mise à l'échelle. Valeurs valides :\n- true : les instances non valides sont ignorées lors du retrait d'un lot d'instances du groupe de mise à l'échelle. S'il existe des instances non valides et que les instances valides sont retirées avec succès, l'état d'exécution de l'activité de mise à l'échelle s'affiche comme Warning. Vous pouvez consulter les instances non valides dans les détails de l'activité de mise à l'échelle.\n- false : les instances non valides ne sont pas ignorées lors du retrait d'un lot d'instances du groupe de mise à l'échelle. S'il existe des instances non valides dans le lot, une erreur est signalée.\n\nValeur par défaut : false.	false
InstanceIds	array	Oui	Les identifiants des instances ECS à retirer.
	string	Non	Les identifiants des instances ECS à retirer.	i-28wt4****
RegionId	string	Non	L'identifiant de la région du groupe de mise à l'échelle.	cn-qingdao
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer que la valeur est unique parmi les différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.	123e4567-e89b-12d3-a456-42665544****
StopInstanceTimeout	integer	Non	Le délai d'attente pour que les instances ECS s'arrêtent avec succès pendant le processus de réduction. Unité : secondes.\nValeurs valides : 30 à 240.\n\n> - Par défaut, ce paramètre hérite de sa valeur du groupe de mise à l'échelle. Vous pouvez également le réinitialiser lorsque vous appelez RemoveInstances.\n> - Ce paramètre prend effet uniquement pendant le processus de réduction lorsque RemovePolicy est défini sur release.\n> - Si ce paramètre est défini, le système attend au maximum la période StopInstanceTimeout pour que les instances s'arrêtent avec succès. Après le délai d'attente, le processus de réduction se poursuit, que les instances s'arrêtent avec succès ou non.\n> - Si ce paramètre n'est pas défini, le système attend indéfiniment que les instances s'arrêtent avec succès. Le processus de réduction ne se poursuit qu'après l'arrêt réussi des instances. Si les instances ne parviennent pas à s'arrêter, le processus de réduction est annulé et la réduction échoue.	60
LifecycleHookContext	object	Non	Les informations de contexte du crochet de cycle de vie.
DisableLifecycleHook	boolean	Non	Indique si tous les crochets de cycle de vie doivent être désactivés pour l'activité de mise à l'échelle. Valeurs valides :\n- true : désactive tous les crochets de cycle de vie.\n- false : ne désactive pas les crochets de cycle de vie.	false
IgnoredLifecycleHookIds	array	Non	Les identifiants des crochets de cycle de vie désactivés pour l'activité de mise à l'échelle.
	string	Non	Les identifiants des crochets de cycle de vie désactivés pour l'activité de mise à l'échelle.	ash-bp14zolna43z266bq***
LifecycleHookResult	string	Non

Éléments de réponse

Élément	Type	Description	Exemple
	object
ScalingActivityId	string	L'identifiant de l'activité de mise à l'échelle.	asa-bp175o6f6ego3r2j****
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
IgnoredInstances	array<object>	La liste des instances non valides ignorées dans la requête.
	object
InstanceId	string	L'identifiant de l'instance ignorée.
Code	string	Le code indiquant la raison pour laquelle l'instance a été ignorée.
Message	string	La description de la raison pour laquelle l'instance a été ignorée.

Exemples

JSON format

{
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "IgnoredInstances": [
    {
      "InstanceId": "",
      "Code": "",
      "Message": ""
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
500	InternalError	The request processing has failed due to some unknown error, exception or failure.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.