Tous les produits
Search
Centre de documentation

Auto Scaling:ExecuteScalingRule

Dernière mise à jour :Aug 18, 2026

Exécute une règle de mise à l'échelle. Vous pouvez exécuter manuellement des règles de mise à l'échelle pour ajuster le nombre d'instances ECS ou d'instances de conteneur élastique. Vous pouvez également configurer Auto Scaling pour qu'il exécute automatiquement ces règles. Vous devez appeler manuellement l'opération ExecuteScalingRule pour exécuter les règles de mise à l'échelle simples et les règles de mise à l'échelle par paliers. Auto Scaling ne peut exécuter que les règles de suivi de cible et les règles de mise à l'échelle prédictives.

Notes d'utilisation

Avant d'appeler l'opération ExecuteScalingRule, assurez-vous que les conditions suivantes sont remplies :

  • Les exigences suivantes doivent être satisfaites :

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

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

  • Si aucune activité de mise à l'échelle n'est en cours pour le groupe, l'opération peut déclencher des activités même avant l'expiration de la période de temporisation du groupe.

  • Si l'ajout d'un nombre spécifique d'instances Elastic Compute Service (ECS) au groupe de mise à l'échelle entraîne un dépassement du nombre maximal autorisé d'instances ECS, Auto Scaling cesse d'ajouter des instances dès que le nombre total atteint cette limite maximale.

  • Si la suppression d'un nombre spécifique d'instances ECS du groupe de mise à l'échelle fait tomber le nombre total d'instances en dessous du minimum autorisé, Auto Scaling cesse de supprimer des instances dès que le nombre total atteint cette limite minimale.

Un appel réussi indique qu'Auto Scaling a accepté la demande. Toutefois, l'activité de mise à l'échelle elle-même peut encore échouer. Vous pouvez obtenir le statut d'une activité de mise à l'échelle en vous basant sur la valeur de ScalingActivityId dans la réponse.

Remarque

Vous ne pouvez ajouter ou supprimer qu'un nombre limité d'instances ECS à la fois. Pour plus d'informations, consultez le paramètre AdjustmentValue dans CreateScalingRule.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre 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

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

ExecuteScalingRule

L'opération que vous souhaitez effectuer. Définissez la valeur sur ExecuteScalingRule.

ScalingRuleAri

String

Oui

ari:acs:ess:cn-hangzhou:140692647406**:scalingrule/asr-bp1dvirgwkoowxk7**

L'identifiant unique de la règle de mise à l'échelle.

Remarque

Vous pouvez utiliser cette opération pour exécuter uniquement les règles de mise à l'échelle simples et les règles de mise à l'échelle par paliers. Si vous souhaitez exécuter une règle de mise à l'échelle par paliers, vous devez spécifier BreachThreshold et MetricValue.

ClientToken

String

Non

123e4567-e89b-12d3-a456-426655440000

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

Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer qu'il est unique 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.

BreachThreshold

Float

Non

1.0

Le seuil de dépassement de la règle de mise à l'échelle par paliers. Valeurs valides : -9.999999E18 à 9.999999E18.

MetricValue

Float

Non

1.0

La valeur de métrique de la règle de mise à l'échelle par paliers. Valeurs valides : -9.999999E18 à 9.999999E18.

RegionId

String

Non

cn-qingdao

L'ID de région de la règle de mise à l'échelle.

Paramètres de réponse

Paramètre

Type

Exemple

Description

ScalingActivityId

String

asa-bp13o672yeautiil****

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

RequestId

String

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

L'ID de la requête.

Exemples

Exemple de requête

http(s)://ess.aliyuncs.com/?Action=ExecuteScalingRule
&ScalingRuleAri=ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&BreachThreshold=1.0
&MetricValue=1.0
&RegionId=cn-qingdao
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<ExecuteScalingRuleResponse>
    <ScalingActivityId>asa-bp13o672yeautiil****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ExecuteScalingRuleResponse>

JSON format

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

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

Codes d'erreur

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

HttpCode

Code d'erreur

Message d'erreur

Description

404

InvalidScalingRuleAri.NotFound

The specified scaling rule Ari does not exist.

La règle de mise à l'échelle spécifiée n'existe pas dans le 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 de mise à l'échelle auquel appartient la règle spécifiée 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.

Le groupe de mise à l'échelle de la règle spécifiée a une activité de mise à l'échelle en cours.

400

InsufficientBalance

Your account does not have enough balance.

Le solde de votre compte Alibaba Cloud est insuffisant.

400

QuotaExceed.Instance

Living instance quota exceeded.

Le nombre maximal d'instances ECS a été atteint.

400

IncorrectLoadBalancerStatus

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

L'équilibreur de charge associé au groupe de mise à l'échelle de la règle spécifiée 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é Health Check n'est pas activée pour l'équilibreur de charge associé au groupe de mise à l'échelle de la règle spécifiée.

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 associée à l'équilibreur de charge utilisé diffère du type de réseau du groupe de mise à l'échelle.

400

InvalidLoadBalancerId.VPCMismatch

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

Une instance ECS associé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 de mise à l'échelle de la règle spécifiée 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 de l'instance ApsaraDB RDS associée au groupe de mise à l'échelle de la règle spécifiée a été atteint.

400

QuotaExceeded.SecurityGroupInstance

Instance quota exceeded in the specified security group.

Le nombre maximal d'instances ECS associées au groupe de sécurité spécifié a été atteint.

400

IncorrectCapacity.NoChange

To execute the specified scaling rule, the total capacity will not change.

Le nombre d'instances dans le groupe de mise à l'échelle reste inchangé après l'exécution de la règle.

400

QuotaExceeded.ScalingInstance

Scaling instance quota exceeded.

Le nombre maximal d'instances ECS autorisé a été atteint.

400

QuotaExceeded.AfterpayInstance

Living afterpay instance quota exceeded.

Le nombre maximal d'instances ECS à la demande autorisé a été atteint.

400

ResourceNotAvailable.ECS

The specified region or zone does not offer the specified disk or instance category.

Les instances ECS du type d'instance spécifié ou utilisant la catégorie de disque spécifiée ne peuvent pas être créées dans la région spécifiée.

400

ScalingRule.InvalidScalingRuleType

Specific scaling rule type: %s can not be executed.

Le type de règle de mise à l'échelle spécifié ne peut pas être exécuté.

400

InvalidStepAdjustments.NoStepFound

No adjustment step found for a metric value of: %s.

Aucune étape d'ajustement correspondante n'a été trouvée pour la métrique spécifiée.

400

MissingParameter.MetricValue

Metric value must be specified for StepScalingRule.

Aucune valeur de métrique n'est spécifiée pour la règle de mise à l'échelle par paliers.

400

MissingParameter.BreachThreshold

Breach threshold must be specified for StepScalingRule.

Aucun seuil n'est spécifié pour la règle de mise à l'échelle par paliers.

400

MetricValueBeyondPermitRange

Specific parameter "%s" beyond permit range.

La valeur de métrique spécifiée n'est pas valide.

400

BreachThresholdBeyondPermitRange

Specific parameter "%s" beyond permit range.

Le seuil spécifié n'est pas valide.