DetachInstances - Auto Scaling - Centre de documentation Alibaba Cloud

Notes d'utilisation

Avant d'appeler l'opération DetachInstances, vérifiez que les conditions suivantes sont remplies :
- Le groupe de mise à l'échelle spécifié est activé.
- Aucune activité de mise à l'échelle n'est en cours pour le groupe de mise à l'échelle spécifié.
  
  Remarque
  Si aucune activité de mise à l'échelle n'est en cours pour le groupe de mise à l'échelle spécifié, l'opération peut contourner la période de temporisation du groupe et déclencher immédiatement des activités de mise à l'échelle.
Lors de l'appel de cette opération, tenez compte des points suivants :
- Une fois retirée du groupe de mise à l'échelle spécifié, l'instance ECS, l'instance de conteneur élastique ou l'instance tierce gérée par Alibaba Cloud peut fonctionner de manière indépendante. Vous pouvez également appeler l'opération AttachInstances pour ajouter l'instance à un autre groupe de mise à l'échelle.
- Le retrait d'une instance ECS, d'une instance de conteneur élastique ou d'une instance tierce gérée par Alibaba Cloud du groupe de mise à l'échelle spécifié n'entraîne ni l'arrêt ni la libération de l'instance.
- Un appel réussi indique uniquement qu'Auto Scaling a accepté la demande, mais ne garantit pas le succès de l'activité de mise à l'échelle. Consultez la valeur de retour ScalingActivityId pour obtenir le statut de l'activité de mise à l'échelle.
- Après le retrait d'instances ECS, d'instances de conteneur élastique ou d'instances tierces gérées par Alibaba Cloud du groupe de mise à l'échelle spécifié, le nombre d'instances restantes doit être supérieur ou égal au nombre minimal d'instances requis dans le groupe. Dans le cas contraire, l'opération échoue et une erreur est renvoyée.

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	DetachInstances	Opération à effectuer. Définissez la valeur sur DetachInstances.
ScalingGroupId	String	Yes	asg-bp1igpak5ft1flyp****	ID du groupe de mise à l'échelle.
DecreaseDesiredCapacity	Boolean	No	true	Indique s'il faut modifier le nombre attendu d'instances dans le groupe de mise à l'échelle. Valeurs possibles : true : après le retrait d'instances ECS, d'instances de conteneur élastique ou d'instances tierces gérées par Alibaba Cloud du groupe de mise à l'échelle spécifié, le nombre attendu d'instances diminue. false : après le retrait d'instances ECS, d'instances de conteneur élastique ou d'instances tierces gérées par Alibaba Cloud du groupe de mise à l'échelle spécifié, le nombre attendu d'instances reste inchangé. Valeur par défaut : true.
IgnoreInvalidInstance	Boolean	No	false	Indique s'il faut ignorer les instances non valides lors du retrait d'un lot d'instances du groupe de mise à l'échelle. Valeurs possibles : 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 retiré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 consulter 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 renvoyée. Valeur par défaut : false.
DetachOption	String	No	both	Indique s'il faut retirer les instances ECS ou les instances de conteneur élastique du groupe de serveurs par défaut et des groupes de serveurs virtuels des instances Server Load Balancer (SLB) associées, et s'il faut supprimer leurs adresses IP privées des listes d'autorisation d'adresses IP des instances ApsaraDB RDS associées. Si vous définissez ce paramètre sur both, les instances sont retirées des groupes de serveurs par défaut et des groupes de serveurs virtuels des instances SLB associées, et leurs adresses IP sont supprimées des listes d'autorisation d'adresses IP des instances ApsaraDB RDS associées. Remarque Ce paramètre n'est pas disponible lorsque vous appelez cette opération pour retirer des instances tierces gérées par Alibaba Cloud du groupe de mise à l'échelle.
InstanceId.N	String	No	i-bp109k5j3dum1ce6****	ID de l'instance ECS N, de l'instance de conteneur élastique N ou de l'instance tierce gérée par Alibaba Cloud N à retirer du groupe de mise à l'échelle. Valeurs possibles pour N : 1 à 20. Exemples : Exemple d'ID d'instance ECS : `i-bp109k5j3dum1ce6**`. Exemple d'ID d'instance de conteneur élastique : `eci-bp17gw49eu09yiwm`. Exemple d'ID d'instance gérée : `mi-d23fsd`. Remarque** Vous ne pouvez retirer qu'un seul type d'instances à la fois via cette opération.
LifecycleHook	Boolean	No	false	Indique s'il faut déclencher un hook de cycle de vie lors de l'appel de cette opération. Valeurs possibles : true false Remarque Ce paramètre n'est pas disponible lorsque vous appelez cette opération pour retirer des instances tierces gérées par Alibaba Cloud du groupe de mise à l'échelle. Valeur par défaut : false.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	Jeton client utilisé pour garantir l'idempotence de la requête. Générez le jeton via le client, en veillant à son unicité pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Garantir l'idempotence.

Paramètres de réponse

Parameter

Type

Example

Description

ScalingActivityId

String

asa-bp1gbswjhjrw8tko****

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

RequestId

String

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

ID de la requête.

Exemples

Exemple de requête

http(s)://ess.aliyuncs.com/?Action=DetachInstances
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&DecreaseDesiredCapacity=true
&IgnoreInvalidInstance=false
&DetachOption=both
&InstanceId=["i-bp109k5j3dum1ce6****"]
&LifecycleHook=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<DetachInstancesResponse>
    <ScalingActivityId>asa-bp1gbswjhjrw8tko****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</DetachInstancesResponse>

JSON format

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

{
  "ScalingActivityId" : "asa-bp1gbswjhjrw8tko****",
  "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

400

IncorrectScalingGroupStatus

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

Le groupe de mise à l'échelle spécifié n'est pas activé.

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 spécifié.

400

IncorrectLoadBalancerStatus

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

L'instance SLB 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 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.

Le nombre d'instances ECS ou d'instances de conteneur élastique dans le groupe de mise à l'échelle est inférieur à la valeur de MinSize si le nombre spécifié d'instances est supprimé.

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

Vous n'êtes pas autorisé à appeler cette opération.

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 ou l'instance de conteneur élastique spécifiée n'existe pas dans le compte Alibaba Cloud.