AttachInstances - Auto Scaling - Centre de documentation Alibaba Cloud

Notes d'utilisation

Avant d'appeler cette opération, assurez-vous que :
- Le groupe d'Auto Scaling est dans l'état Active.
- Aucune activité de mise à l'échelle n'est en cours pour le groupe d'Auto Scaling.
Lors de l'ajout d'instances ECS ou d'instances de conteneur élastique :
- Les instances doivent se trouver dans la même région que le groupe d'Auto Scaling.
- Les instances doivent être dans l'état Running.
- Les instances ne doivent pas faire partie d'un autre groupe d'Auto Scaling.
- L'instance doit utiliser la facturation par abonnement, paiement à l'utilisation ou spot.
- Si VswitchID est spécifié pour le groupe d'Auto Scaling, les instances du réseau classique ou d'un VPC différent ne peuvent pas être ajoutées.
- Si VswitchID n'est pas spécifié, les instances de type VPC ne peuvent pas être ajoutées.
Lors de l'ajout d'instances gérées :
- Les instances gérées doivent se trouver dans la même région que le groupe d'Auto Scaling.
- Les instances gérées ne doivent pas appartenir à un autre groupe d'Auto Scaling.
- Les instances gérées ne prennent pas en charge les hooks de cycle de vie, l'association SLB ni les vérifications d'intégrité.
- Après avoir ajouté une instance gérée à un groupe d'Auto Scaling de type ECS, le groupe ne gère pas son cycle de vie.
- Les instances gérées ne peuvent être ajoutées ou supprimées que manuellement. Les instances gérées supprimées ne sont pas libérées.
Considérations supplémentaires :
- Si aucune activité de mise à l'échelle n'est en cours, cette opération s'exécute sans attendre la période de refroidissement.
- Un appel réussi indique que la demande a été acceptée, mais ne garantit pas le succès de l'activité de mise à l'échelle. Vérifiez l'état à l'aide de l'identifiant ScalingActivityId renvoyé.
- Le nombre total d'instances après l'attachement ne doit pas dépasser MaxSize, sinon l'opération échoue.
- Les instances ajoutées manuellement via cette opération ne sont pas associées à la configuration de mise à l'échelle active.

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	AttachInstances	L'opération que vous souhaitez effectuer. Définissez la valeur sur AttachInstances.
ScalingGroupId	String	Yes	asg-bp18p2yfxow2dloq****	L'ID du groupe d'Auto Scaling.
Entrusted	Boolean	No	false	Indique si le groupe d'Auto Scaling gère le cycle de vie des instances ajoutées manuellement. Valeurs valides : true : Le groupe d'Auto Scaling gère les instances ajoutées manuellement de la même manière que celles créées automatiquement. Auto Scaling libère ces instances lorsqu'elles sont supprimées du groupe, à l'exception de celles supprimées via l'opération `DetachInstances`. false : Le groupe d'Auto Scaling ne gère pas le cycle de vie des instances ajoutées manuellement. Ces instances ne sont pas libérées lors de leur suppression. Remarque Vous ne pouvez pas spécifier ce paramètre pour les instances par abonnement, les instances gérées ou les instances arrêtées en mode économique. Valeur par défaut : false.
InstanceId.N	String	No	i-28wt4****	L'ID de l'instance N à ajouter. Peut être une instance ECS, une instance de conteneur élastique, une instance gérée ou une instance arrêtée en mode économique. Valeurs valides de N : 1 à 20. Exemples d'ID d'instance : Exemple d'ID d'une instance ECS : `i-28wt4**`. Exemple d'ID d'une instance de conteneur élastique : `eci-bp17gw49eu09yiwm*`. Exemple d'ID d'une instance gérée : `mi-2cx`. Exemple d'ID d'une instance arrêtée en mode économique : `i-2cd2f**`. Remarque** Vous ne pouvez ajouter que des instances du même type lors de chaque appel.
LoadBalancerWeight.N	Integer	No	50	Le poids d'équilibrage de charge de l'instance N. Valeurs valides de N : 1 à 20. Valeurs valides : 1 à 100. Remarque Vous ne pouvez pas spécifier ce paramètre pour les instances gérées ou les instances arrêtées en mode économique. Valeur par défaut : 50.
LifecycleHook	Boolean	No	false	Indique s'il faut déclencher un hook de cycle de vie lors de l'ajout d'instances au groupe d'Auto Scaling. Valeurs valides : true false Remarque Vous ne pouvez pas spécifier ce paramètre pour les instances gérées ou les instances arrêtées en mode économique. Valeur par défaut : false.
RegionId	String	No	cn-qingdao	L'ID de région du groupe d'Auto Scaling.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais il doit être unique pour toutes les requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères de longueur. Garantir l'idempotence.
IgnoreInvalidInstance	Boolean	No	false	Indique s'il faut ignorer les instances non valides lors de l'ajout d'instances par lot. Valeurs valides : true : Les instances non valides sont ignorées. Si des instances non valides existent et que des instances valides sont ajoutées, l'activité de mise à l'échelle passe à l'état Warning. Consultez les détails de l'activité de mise à l'échelle pour afficher les instances ignorées. false : L'opération échoue si des instances non valides existent dans le lot. Valeur par défaut : false.

Paramètres de réponse

Parameter

Type

Example

Description

ScalingActivityId

String

asa-bp1crxor24s28xf1****

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

RequestId

String

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

L'ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

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

<AttachInstancesResponse>
    <ScalingActivityId>asa-bp1crxor24s28xf1****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachInstancesResponse>

JSON format

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

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

Codes d'erreur

Consultez les Service error codes pour obtenir la liste des codes d'erreur.

HTTP status code

Error code

Error message

Description

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

Le groupe d'Auto Scaling spécifié n'existe pas au sein du compte Alibaba Cloud.

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 d'Auto Scaling spécifié n'est pas dans l'état Active.

404

InvalidInstanceId.NotFound

Instance "XXX" does not exist.

L'instance ECS ou l'instance de conteneur élastique spécifiée n'existe pas au sein du compte Alibaba Cloud.

400

InvalidInstanceId. RegionMismatch

Instance "XXX" and the specified scaling group are not in the same Region.

L'instance ECS ou l'instance de conteneur élastique spécifiée ne réside pas dans la même région que le groupe d'Auto Scaling spécifié.

400

InvalidInstanceId.InstanceTypeMismatch

Instance "XXX" and existing Active scaling configurations have different instance types.

Le type d'instance de l'instance ECS ou de l'instance de conteneur élastique spécifiée diffère du type d'instance dans la configuration de mise à l'échelle active.

400

IncorrectInstanceStatus

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

L'instance ECS ou l'instance de conteneur élastique spécifiée n'est pas dans l'état Running.

400

InvalidInstanceId. NetworkTypeMismatch

The network type of instance "XXX" does not support this action.

Le type de réseau de l'instance ECS ou de l'instance de conteneur élastique spécifiée diffère du type de réseau du groupe d'Auto Scaling.

400

InvalidInstanceId.VPCMismatch

Instance "XXX" and the specified scaling group are not in the same VPC.

L'instance ECS ou l'instance de conteneur élastique spécifiée que vous souhaitez ajouter ne réside pas dans le même VPC que le groupe d'Auto Scaling spécifié.

400

InvalidInstanceId.InUse

Instance "XXX" is already attached to another scaling group.

L'instance ECS ou l'instance de conteneur élastique spécifiée appartient à un autre groupe d'Auto Scaling.

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.

Le groupe d'Auto Scaling spécifié a des activités de mise à l'échelle en cours.

400

IncorrectLoadBalancerStatus

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

L'équilibreur de charge associé au groupe d'Auto Scaling spécifié n'est pas dans l'état Active.

400

IncorrectLoadBalancerHealthCheck

The current health check type of specified load balancer does not support this action.

La fonctionnalité de vérification d'intégrité est désactivée pour l'équilibreur de charge associé au groupe d'Auto Scaling spécifié.

400

InvalidLoadBalancerId.IncorrectInstanceNetworkType

The network type of the instance in specified load balancer does not support this action.

Le type de réseau d'une instance ECS ou d'une instance de conteneur élastique attachée à l'équilibreur de charge spécifié diffère du type de réseau du groupe d'Auto Scaling.

400

InvalidLoadBalancerId.VPCMismatch

The specified virtual switch and the instance in specified load balancer are not in the same VPC.

Une instance ECS ou une instance de conteneur élastique attachée à l'équilibreur de charge spécifié ne réside pas dans le même VPC que le vSwitch spécifié par VSwitchId.

400

IncorrectDBInstanceStatus

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

L'instance ApsaraDB RDS associée au groupe d'Auto Scaling spécifié n'est pas dans l'état Running.

400

QuotaExceeded.DBInstanceSecurityIP

Security IP quota exceeded in DB instance "XXX".

Le nombre maximal d'adresses IP dans la liste d'autorisation d'adresses IP de l'instance ApsaraDB RDS associée au groupe d'Auto Scaling spécifié a été atteint.

400

QuotaExceeded.SecurityGroupInstance

Instance quota exceeded in the specified security group.

Le nombre maximal d'instances ECS ou d'instances de conteneur élastique pouvant être associées au groupe de sécurité spécifié a été atteint.

400

IncorrectCapacity.MaxSize

To attach the instances, the total capacity will be greater than the MaxSize.

Le nombre total d'instances ECS ou d'instances de conteneur élastique spécifié par Total Capacity dépasse la valeur de MaxSize.