CreateScalingRule - Auto Scaling - Centre de documentation Alibaba Cloud

Crée une règle de mise à l'échelle.

Description de l'opération

Notez les informations suivantes concernant les paramètres :

Si AdjustmentType est défini sur TotalCapacity, le nombre d'instances ECS ou ECI dans le groupe de mise à l'échelle actuel est ajusté à la valeur spécifiée. La valeur AdjustmentValue correspondante doit être supérieure ou égale à 0.
Si AdjustmentType est défini sur QuantityChangeInCapacity ou PercentChangeInCapacity, une valeur AdjustmentValue positive indique que des instances ECS sont ajoutées, et une valeur négative indique que des instances ECS sont supprimées.
Si AdjustmentType est défini sur PercentChangeInCapacity, Auto Scaling calcule le nombre d'instances ECS ou ECI à ajouter ou supprimer en utilisant la formule suivante : Nombre actuel d'instances dans le groupe de mise à l'échelle (Capacité totale) × AdjustmentValue/100. Le résultat est arrondi à l'entier le plus proche.
Si un temps de refroidissement (Cooldown) est spécifié dans une règle de mise à l'échelle, le temps de refroidissement spécifié dans la règle de mise à l'échelle prend effet après la fin de l'activité de mise à l'échelle déclenchée par la règle. Si aucun temps de refroidissement n'est spécifié dans la règle de mise à l'échelle, le temps de refroidissement spécifié pour le groupe de mise à l'échelle (DefaultCooldown) prend effet.
Le nombre de règles de mise à l'échelle pouvant être créées dans un groupe de mise à l'échelle est limité. Pour plus d'informations, consultez Limites.
L'identifiant unique de la règle de mise à l'échelle (ScalingRuleAri) renvoyé peut être utilisé dans les opérations suivantes :
- Vous pouvez spécifier le paramètre ScalingRuleAri lorsque vous appelez l'opération ExecuteScalingRule pour exécuter manuellement la règle de mise à l'échelle.
- Vous pouvez spécifier le paramètre ScheduledAction lorsque vous appelez l'opération CreateScheduledTask pour exécuter la règle de mise à l'échelle selon une planification.

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:CreateScalingRule

create

*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 auquel la règle de mise à l'échelle appartient.	asg-bp1ffogfdauy0jw0****
ScalingRuleName	string	Non	Le nom de la règle de mise à l'échelle. Le nom doit comporter de 2 à 64 caractères et peut contenir des chiffres, des lettres majuscules, des lettres minuscules, des caractères chinois, des traits de soulignement (_), des traits d'union (-) et des points (.). Il doit commencer par un chiffre, une lettre ou un caractère chinois. Le nom de la règle de mise à l'échelle doit être unique dans la même région et le même groupe de mise à l'échelle sous le même compte. Remarque Si vous ne spécifiez pas ce paramètre, la valeur de ScalingRuleId est utilisée par défaut.	scalingrule****
Cooldown	integer	Non	Le temps de refroidissement de la règle de mise à l'échelle. Ce paramètre s'applique uniquement aux règles de mise à l'échelle simples. Valeurs valides : 0 à 86400. Unité : secondes. Valeur par défaut : vide.	60
MinAdjustmentMagnitude	integer	Non	Le nombre minimum d'instances à ajuster dans la règle de mise à l'échelle. Ce paramètre prend effet uniquement lorsque le type de règle de mise à l'échelle est SimpleScalingRule ou StepScalingRule et que AdjustmentType est défini sur PercentChangeInCapacity.	1
AdjustmentType	string	Non	La méthode d'ajustement de la règle de mise à l'échelle. Ce paramètre s'applique aux règles de mise à l'échelle simples et aux règles de mise à l'échelle par paliers, et est requis dans ce cas. Valeurs valides : QuantityChangeInCapacity : ajoute ou supprime un nombre spécifié d'instances ECS. PercentChangeInCapacity : ajoute ou supprime un pourcentage spécifié d'instances ECS. TotalCapacity : ajuste le nombre d'instances ECS dans le groupe de mise à l'échelle actuel à une valeur spécifiée.	QuantityChangeInCapacity
AdjustmentValue	integer	Non	La valeur d'ajustement de la règle de mise à l'échelle. Ce paramètre s'applique aux règles de mise à l'échelle simples et aux règles de mise à l'échelle par paliers, et est requis dans ce cas. Le nombre d'instances ECS ajustées lors d'une seule activité de mise à l'échelle ne peut pas dépasser 1 000. Les valeurs valides varient en fonction de la méthode d'ajustement : QuantityChangeInCapacity : -1000 à 1000. PercentChangeInCapacity : -100 à 10000. TotalCapacity : 0 à 2000.	100
ScalingRuleType	string	Non	Le type de la règle de mise à l'échelle. Valeurs valides : SimpleScalingRule : mise à l'échelle simple. Ajuste le nombre d'instances ECS ou ECI en fonction de la méthode d'ajustement (AdjustmentType) et de la valeur d'ajustement (AdjustmentValue). TargetTrackingScalingRule : règle de mise à l'échelle de suivi de cible. Calcule dynamiquement le nombre d'instances ECS ou ECI à mettre à l'échelle en fonction d'une métrique de surveillance prédéfinie (MetricName) et tente de maintenir la valeur des métriques de surveillance proche de la valeur cible (TargetValue). StepScalingRule : règle de mise à l'échelle par paliers. Fournit une extension par paliers en fonction des seuils et des valeurs de métrique. PredictiveScalingRule : règle de mise à l'échelle prédictive. Utilise l'apprentissage automatique pour analyser les données de surveillance historiques du groupe de mise à l'échelle, prédire les valeurs futures des métriques de surveillance et prendre en charge la création automatique de tâches planifiées pour définir les limites du groupe de mise à l'échelle. Valeur par défaut : SimpleScalingRule.	SimpleScalingRule
EstimatedInstanceWarmup	integer	Non	La période de préchauffage d'une instance. Ce paramètre s'applique aux règles de mise à l'échelle de suivi de cible et aux règles de mise à l'échelle par paliers. Une instance ECS en état de préchauffage est ajoutée au groupe de mise à l'échelle comme prévu, mais ne signale pas de données de surveillance à CloudMonitor pendant la période de préchauffage. Remarque Lorsque le nombre d'instances ECS à mettre à l'échelle est calculé dynamiquement, les instances en état de préchauffage ne sont pas comptabilisées dans le nombre actuel d'instances. Valeurs valides : 0 à 86400. Unité : secondes. Valeur par défaut : 300.	300
MetricName	string	Non	La métrique prédéfinie. Ce paramètre s'applique aux règles de mise à l'échelle de suivi de cible et aux règles de mise à l'échelle prédictives, et est requis dans ce cas. Valeurs valides pour les règles de mise à l'échelle de suivi de cible : CpuUtilizationAgent : (Agent) taux d'utilisation du processeur (recommandé). MemoryUtilization : (Agent) taux d'utilisation de la mémoire (recommandé). CpuUtilization : (ECS) taux d'utilisation moyen du processeur. IntranetTx : (ECS) trafic sortant moyen sur le réseau interne. IntranetRx : (ECS) trafic entrant moyen sur le réseau interne. VpcInternetTx : (ECS) trafic sortant moyen sur Internet. VpcInternetRx : (ECS) trafic entrant moyen sur Internet. LoadBalancerRealServerAverageQps : (ALB) QPS moyen par serveur dans un groupe de serveurs. Valeurs valides pour les règles de mise à l'échelle prédictives : CpuUtilization : (ECS) taux d'utilisation moyen du processeur. IntranetRx : (ECS) trafic entrant moyen sur le réseau interne. IntranetTx : (ECS) trafic sortant moyen sur le réseau interne. Pour plus d'informations, consultez Tâches déclenchées par des événements pour la surveillance du système.	CpuUtilization
TargetValue	number	Non	La valeur cible. Ce paramètre s'applique aux règles de mise à l'échelle de suivi de cible et aux règles de mise à l'échelle prédictives, et est requis dans ce cas. La valeur de TargetValue peut comporter jusqu'à trois décimales et doit être supérieure à 0.	0.125
DisableScaleIn	boolean	Non	Indique si la réduction de capacité doit être désactivée. Ce paramètre s'applique uniquement aux règles de mise à l'échelle de suivi de cible. Valeur par défaut : false.	false
ScaleInEvaluationCount	integer	Non	Après la création d'une règle de mise à l'échelle de suivi de cible, une tâche déclenchée par des événements est automatiquement créée. Ce paramètre spécifie le nombre de fois consécutives où le seuil conditionnel doit être atteint avant que la tâche déclenchée par des événements de réduction de capacité ne déclenche une alerte. Valeur par défaut : 15.	15
ScaleOutEvaluationCount	integer	Non	Après la création d'une règle de mise à l'échelle de suivi de cible, une tâche déclenchée par des événements est automatiquement créée. Ce paramètre spécifie le nombre de fois consécutives où le seuil conditionnel doit être atteint avant que la tâche déclenchée par des événements d'extension de capacité ne déclenche une alerte. Valeur par défaut : 3.	3
PredictiveScalingMode	string	Non	Le mode de la règle de mise à l'échelle prédictive. Valeurs valides : PredictAndScale : génère des résultats de prédiction et crée des tâches de prédiction. PredictOnly : génère des résultats de prédiction mais ne crée pas de tâches de prédiction. Valeur par défaut : PredictAndScale.	PredictAndScale
PredictiveValueBehavior	string	Non	La méthode utilisée pour gérer la valeur maximale pour la règle de mise à l'échelle prédictive. Valeurs valides : MaxOverridePredictiveValue : la valeur maximale initiale remplace la valeur prédite. Si la valeur prédite est supérieure à la valeur maximale initiale, la valeur maximale de la tâche de prédiction est définie sur la valeur maximale initiale. PredictiveValueOverrideMax : la valeur prédite remplace la valeur maximale initiale. Si la valeur prédite est supérieure à la valeur maximale initiale, la valeur maximale de la tâche de prédiction est définie sur la valeur prédite. PredictiveValueOverrideMaxWithBuffer : la valeur prédite est augmentée d'un pourcentage spécifié. La valeur prédite est augmentée en fonction du ratio PredictiveValueBuffer. Si la valeur augmentée est supérieure à la valeur maximale initiale, la valeur augmentée est utilisée. Valeur par défaut : MaxOverridePredictiveValue.	MaxOverridePredictiveValue
PredictiveValueBuffer	integer	Non	Ce paramètre prend effet lorsque PredictiveValueBehavior est défini sur PredictiveValueOverrideMaxWithBuffer. La valeur prédite est augmentée en fonction de ce ratio. Si la valeur augmentée est supérieure à la valeur maximale initiale, la valeur augmentée est utilisée. Valeurs valides : 0 à 100. Valeur par défaut : 0.	50
PredictiveTaskBufferTime	integer	Non	Les tâches de prédiction qui sont automatiquement créées par la règle de mise à l'échelle prédictive sont exécutées à l'heure pile par défaut. Vous pouvez configurer un temps de tampon pour exécuter les tâches de prédiction à l'avance afin de préparer les ressources en amont. Valeurs valides : 0 à 60. Unité : minutes. Valeur par défaut : 0.	30
InitialMaxSize	integer	Non	Le nombre maximal d'instances dans le groupe de mise à l'échelle. Ce paramètre est utilisé conjointement avec PredictiveValueBehavior. Valeur par défaut : la valeur de MaxSize du groupe de mise à l'échelle.	100
StepAdjustment	array<object>	Non	La collection d'informations d'ajustement par paliers pour la règle de mise à l'échelle par paliers.
	object	Non	La collection d'informations d'ajustement par paliers pour la règle de mise à l'échelle par paliers.
MetricIntervalUpperBound	number	Non	La limite supérieure de l'ajustement par paliers. Ce paramètre s'applique uniquement aux règles de mise à l'échelle par paliers. Valeurs valides : -9.999999E18 à 9.999999E18.	5.0
ScalingAdjustment	integer	Non	Le nombre d'instances à mettre à l'échelle pour l'ajustement par paliers. Ce paramètre s'applique uniquement aux règles de mise à l'échelle par paliers.	1
MetricIntervalLowerBound	number	Non	La limite inférieure de l'ajustement par paliers. Ce paramètre s'applique uniquement aux règles de mise à l'échelle par paliers. Valeurs valides : -9.999999E18 à 9.999999E18.	1.0
RegionId	string	Non	L'identifiant de la région du groupe de mise à l'échelle.	cn-hangzhou
AlarmDimension	array<object>	Non	Les informations de dimension associées à la métrique. Ce paramètre s'applique aux règles de mise à l'échelle de suivi de cible. Définissez ce paramètre lorsque la métrique nécessite des informations de dimension supplémentaires. Par exemple, la métrique LoadBalancerRealServerAverageQps nécessite les informations de dimension rulePool.
	object	Non	Les informations de dimension associées à la métrique. Ce paramètre s'applique aux règles de mise à l'échelle de suivi de cible. Définissez ce paramètre lorsque la métrique nécessite des informations de dimension supplémentaires. Par exemple, la métrique LoadBalancerRealServerAverageQps nécessite les informations de dimension rulePool.
DimensionKey	string	Non	La clé de la dimension associée à la métrique.	rulePool
DimensionValue	string	Non	La valeur de la dimension associée à la métrique.	sgp-l1cbirz451yxu2****
MetricType	string	Non	Le type de la métrique. Valeurs valides : system : utilise les métriques système de CloudMonitor. custom : utilise les métriques personnalisées signalées à CloudMonitor. hybrid : utilise les métriques de Hybrid Cloud Monitoring.	system
HybridMonitorNamespace	string	Non	L'identifiant du référentiel de métriques de surveillance de Hybrid Cloud Monitoring. Pour gérer les référentiels de métriques, consultez Gérer les référentiels de métriques.	aliyun-test
HybridMetrics	array<object>	Non	Les paramètres des métriques de surveillance de Hybrid Cloud Monitoring. Pour plus d'informations sur la configuration de ce paramètre, consultez Utiliser des règles de mise à l'échelle de suivi de cible personnalisées basées sur des formules.
	array<object>	Non
Id	string	Non	L'identifiant de référence de la métrique dans l'expression de la métrique.	a
Expression	string	Non	L'expression de métrique pour plusieurs métriques de Hybrid Cloud Monitoring. Le résultat du calcul de l'expression est utilisé pour déclencher des activités de mise à l'échelle. L'expression doit être conforme à la spécification de la notation polonaise inverse (RPN), et seuls les opérateurs + - * / sont pris en charge.	(a+b)/2
MetricName	string	Non	Le nom de la métrique de surveillance dans le référentiel de métriques de surveillance de Hybrid Cloud Monitoring.	AliyunSmq_NumberOfMessagesVisible
Statistic	string	Non	La méthode statistique de la métrique. Valeurs valides : Average : la moyenne de tous les points de données dans l'intervalle spécifié. Minimum : la valeur minimale de tous les points de données dans l'intervalle spécifié. Maximum : la valeur maximale de tous les points de données dans l'intervalle spécifié.	Average
Dimensions	array<object>	Non	Les dimensions de la métrique. Spécifie les ressources à surveiller pour la métrique.
	object	Non
DimensionKey	string	Non	La clé de la dimension de la métrique.	queue
DimensionValue	string	Non	La valeur de la dimension de la métrique.	testQueue
AlarmOptions	object	Non	La définition des propriétés de l'alerte.
Period	integer	Non	La période statistique pour les données de surveillance dans la règle de mise à l'échelle de suivi de cible. Unité : secondes. Valeurs valides : Remarque Valeur par défaut : 60.	60

Éléments de réponse

Élément	Type	Description	Exemple
	object
ScalingRuleAri	string	L'identifiant unique de la règle de mise à l'échelle.	ari:acs:ess:cn-hangzhou:140692647406**:scalingrule/asr-bp1dvirgwkoowxk7**
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ScalingRuleId	string	L'identifiant de la règle de mise à l'échelle. L'identifiant est généré par le système et est globalement unique.	asr-bp1dvirgwkoowxk7****

Exemples

JSON format

{
  "ScalingRuleAri": "ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingRuleId": "asr-bp1dvirgwkoowxk7****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.