Tous les produits
Search
Centre de documentation

Auto Scaling:CreateScalingGroup

Dernière mise à jour :Sep 17, 2026

Crée un groupe de mise à l'échelle pour ajuster automatiquement votre capacité de calcul (le nombre d'instances) en fonction des changements métier et des stratégies, si vous devez augmenter ou diminuer automatiquement le nombre d'instances d'un type spécifié.

Description de l'opération

Un groupe de mise à l'échelle est un ensemble d'instances ECS qui servent les mêmes scénarios courants.

Le nombre de groupes de mise à l'échelle pouvant être créés dans une région dépend de votre utilisation d'Auto Scaling. Accédez au Centre de quotas pour consulter la valeur du quota pour le nombre total de groupes de mise à l'échelle.

Un groupe de mise à l'échelle ne prend pas effet immédiatement après sa création. Vous devez appeler l'opération EnableScalingGroup pour activer le groupe de mise à l'échelle avant qu'il ne puisse déclencher des activités de mise à l'échelle et exécuter des règles de mise à l'échelle.

Le groupe de mise à l'échelle, les instances Classic Load Balancer (CLB, anciennement SLB) associées et les instances ApsaraDB RDS associées doivent se trouver dans la même région. Pour plus d'informations, consultez la section Régions et zones.

Si vous associez une instance CLB au groupe de mise à l'échelle, le groupe de mise à l'échelle ajoute automatiquement les instances ECS qui rejoignent le groupe de mise à l'échelle au groupe de serveurs backend de l'instance CLB. Vous pouvez spécifier les groupes de serveurs auxquels les instances ECS sont ajoutées. Les deux types de groupes de serveurs suivants sont pris en charge :

  • Groupe de serveurs par défaut : utilisé pour accepter les requêtes frontend. Si aucun groupe de serveurs virtuel ou groupe de serveurs principal/secondaire n'est configuré pour un écouteur, les requêtes sont transmises par défaut aux instances ECS du groupe de serveurs par défaut.

  • Groupe de serveurs virtuel : utilisez un groupe de serveurs virtuel lorsque vous souhaitez transmettre différentes requêtes à différents serveurs backend, ou lorsque vous souhaitez transmettre des requêtes en fonction de noms de domaine ou d'URL.

Remarque

Si vous spécifiez à la fois le groupe de serveurs par défaut et plusieurs groupes de serveurs virtuels, les instances ECS sont ajoutées à tous ces groupes de serveurs.

Une fois qu'une instance est ajoutée au groupe de serveurs backend d'une instance CLB, le poids de l'instance est défini sur 50 par défaut. L'instance CLB doit remplir les conditions suivantes :

  • L'instance CLB doit être à l'état actif. Vous pouvez appeler l'opération DescribeLoadBalancers pour interroger l'état de l'instance CLB spécifiée.

  • Les bilans de santé doivent être activés pour tous les ports d'écouteur configurés sur l'instance CLB. Sinon, la création du groupe de mise à l'échelle échoue.

Si vous associez un groupe de serveurs Application Load Balancer (ALB), un groupe de serveurs Network Load Balancer (NLB) ou un groupe de serveurs Gateway Load Balancer (GWLB) au groupe de mise à l'échelle, le groupe de mise à l'échelle ajoute automatiquement les instances ECS qui rejoignent le groupe de mise à l'échelle en tant que serveurs backend du groupe de serveurs ALB, NLB ou GWLB pour traiter les requêtes d'accès distribuées par l'instance ALB, NLB ou GWLB. Vous pouvez spécifier plusieurs groupes de serveurs ALB, NLB ou GWLB, mais les groupes de serveurs doivent appartenir au même VPC que le groupe de mise à l'échelle. Pour plus d'informations, consultez AttachAlbServerGroups ou AttachServerGroups.

Si vous associez une instance ApsaraDB RDS au groupe de mise à l'échelle, le groupe de mise à l'échelle ajoute automatiquement les adresses IP internes des instances ECS qui rejoignent le groupe de mise à l'échelle à la liste blanche de l'instance ApsaraDB RDS. L'instance ApsaraDB RDS doit remplir les conditions suivantes :

  • L'instance ApsaraDB RDS doit être à l'état Running. Vous pouvez appeler l'opération DescribeDBInstances pour interroger l'état de l'instance ApsaraDB RDS spécifiée.

  • Le nombre d'adresses IP dans la liste blanche de l'instance ApsaraDB RDS ne doit pas dépasser la limite supérieure. Pour plus d'informations, consultez la section Configurer une liste blanche dans la documentation d'ApsaraDB RDS.

Si le paramètre MultiAZPolicy du groupe de mise à l'échelle est défini sur COST_OPTIMIZED :

  • Lorsque vous spécifiez les paramètres OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity et SpotInstancePools, la méthode d'allocation des instances dans le cadre de la stratégie d'optimisation des coûts est spécifiée, et cette méthode d'allocation est priorisée lors des événements de montée en charge et de descente en charge.

  • Lorsque vous ne spécifiez pas les paramètres OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity ou SpotInstancePools, la stratégie d'optimisation des coûts crée des instances uniquement de la manière la plus rentable. (Dans ce mode, les instances ne peuvent pas être créées à l'aide d'une garantie d'élasticité ou d'une réservation de capacité. Le paramètre vSwitch des contrôleurs d'interface réseau (NIC) secondaires n'est pas pris en charge.)

Si vous définissez des balises propagables pour le groupe de mise à l'échelle, c'est-à-dire que Tags.Propagate est défini sur true :

  • Les balises du groupe de mise à l'échelle sont propagées uniquement aux instances nouvellement créées, et non aux instances qui sont déjà en cours d'exécution dans le groupe de mise à l'échelle.

  • Si vous spécifiez des balises d'instance dans la configuration de mise à l'échelle et choisissez de propager les balises du groupe de mise à l'échelle à l'instance, toutes les balises coexistent.

  • Si une balise propagable sur le groupe de mise à l'échelle et une balise dans la configuration de mise à l'échelle ont la même clé de balise, la valeur de la balise dans la configuration de mise à l'échelle est prioritaire.

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

create

*Groupe de mise à l'échelle.

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

ScalingGroupName

string

Non

Le nom du groupe de mise à l'échelle. Le nom doit être unique dans une région.

Le nom doit comporter de 2 à 64 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_), des traits d'union (-) et des points (.). Il doit commencer par un chiffre, une lettre ou un caractère chinois.

Valeur par défaut : la valeur de ScalingGroupId.

scalinggroup****

LaunchTemplateId

string

Non

L'identifiant du modèle de lancement à partir duquel le groupe de mise à l'échelle obtient les informations de configuration de lancement.

lt-m5e3ofjr1zn1aw7****

LaunchTemplateVersion

string

Non

La version du modèle de lancement. Valeurs valides :

  • Un numéro de version de modèle fixe.

  • Default : utilise toujours la version de modèle par défaut.

  • Latest : utilise toujours la dernière version de modèle.

Default

InstanceId

string

Non

L'identifiant de l'instance. Lorsque vous créez un groupe de mise à l'échelle, les informations de configuration requises sont obtenues à partir de l'instance spécifiée, et une configuration de mise à l'échelle est automatiquement créée.

i-28wt4****

RegionId

string

Oui

L'identifiant de la région du groupe de mise à l'échelle. Pour plus d'informations, consultez la section Régions et zones.

cn-qingdao

MinSize

integer

Oui

Le nombre minimum d'instances dans le groupe de mise à l'échelle. Lorsque le nombre d'instances dans le groupe de mise à l'échelle est inférieur à la valeur de MinSize, Auto Scaling crée automatiquement des instances.

Remarque

La valeur de MinSize doit être inférieure ou égale à la valeur de MaxSize.

2

MaxSize

integer

Oui

Le nombre maximum d'instances dans le groupe de mise à l'échelle. Lorsque le nombre d'instances dans le groupe de mise à l'échelle est supérieur à la valeur de MaxSize, Auto Scaling supprime automatiquement des instances.

Les valeurs valides de MaxSize dépendent de votre utilisation d'Auto Scaling. Accédez au Centre de quotas pour consulter la valeur du quota pour le Nombre maximum d'instances dans un groupe de mise à l'échelle.

Si la valeur du quota pour le Nombre maximum d'instances dans un groupe de mise à l'échelle est de 2000, les valeurs valides de MaxSize sont de 0 à 2000.

20

DefaultCooldown

integer

Non

Le temps de refroidissement après la fin d'une activité de mise à l'échelle (ajout ou suppression d'instances). Valeurs valides : 0 à 86400. Unité : secondes.

Pendant le temps de refroidissement, le groupe de mise à l'échelle n'exécute pas d'autres activités de mise à l'échelle. Cette restriction s'applique uniquement aux activités de mise à l'échelle déclenchées par des tâches déclenchées par des événements CloudMonitor.

Valeur par défaut : 300.

300

LoadBalancerIds

string

Non

Les identifiants des instances CLB (anciennement SLB). La valeur peut être un tableau JSON composé de plusieurs identifiants d'instances CLB. Séparez les identifiants par des virgules (,).

Le nombre total d'instances CLB pouvant être associées à un seul groupe de mise à l'échelle dépend de votre utilisation d'Auto Scaling. Accédez au Centre de quotas pour consulter la valeur du quota pour le Nombre total d'instances d'équilibreur de charge pouvant être associées à un groupe de mise à l'échelle.

["lb-bp1u7etiogg38yvwz****", "lb-bp168cqrux9ai9l7f****", "lb-bp1jv3m9zvj22ufxp****"]

DBInstanceIds

string

Non

Les identifiants des instances ApsaraDB RDS. La valeur peut être un tableau JSON composé de plusieurs identifiants d'instances ApsaraDB RDS. Séparez les identifiants par des virgules (,).

Le nombre total d'instances ApsaraDB RDS pouvant être associées à un seul groupe de mise à l'échelle dépend de votre utilisation d'Auto Scaling. Accédez au Centre de quotas pour consulter la valeur du quota pour le Nombre total d'instances RDS pouvant être associées à un groupe de mise à l'échelle.

["rm-bp142f86de0t7****", "rm-bp18l1z42ar4o****", "rm-bp1lqr97h4aqk****"]

RemovalPolicy.1

string

Non

La stratégie de filtrage de premier tour pour la politique de descente en charge. Ce paramètre ne peut pas avoir la même valeur que RemovalPolicy.2 ou RemovalPolicy.3. Valeurs valides :

  • OldestInstance : supprime l'instance ECS qui a été ajoutée en premier au groupe de mise à l'échelle.

  • NewestInstance : supprime l'instance ECS qui a été ajoutée le plus récemment au groupe de mise à l'échelle.

  • OldestScalingConfiguration : supprime l'instance ECS qui a été créée à partir de la configuration de mise à l'échelle la plus ancienne.

  • CustomPolicy : supprime les instances ECS en fonction d'une politique de descente en charge personnalisée (Function).

La configuration de mise à l'échelle mentionnée dans OldestScalingConfiguration fait référence à la source de configuration d'instance dans le groupe de mise à l'échelle, y compris les configurations de mise à l'échelle et les modèles de lancement. CustomPolicy ne peut être défini que comme stratégie de descente en charge de premier tour. Lorsque vous spécifiez CustomPolicy, vous devez également spécifier le paramètre CustomPolicyARN.

Remarque

La suppression des instances ECS d'un groupe de mise à l'échelle est également affectée par la stratégie de mise à l'échelle (MultiAZPolicy) du groupe de mise à l'échelle. Pour plus d'informations, consultez Configurer une stratégie combinée pour la suppression d'instances.

OldestScalingConfiguration

RemovalPolicy.2

string

Non

La stratégie de filtrage de deuxième tour pour la politique de descente en charge. Ce paramètre ne peut pas avoir la même valeur que RemovalPolicy.1 ou RemovalPolicy.3. Valeurs valides :

  • OldestInstance : supprime l'instance ECS qui a été ajoutée en premier au groupe de mise à l'échelle.

  • NewestInstance : supprime l'instance ECS qui a été ajoutée le plus récemment au groupe de mise à l'échelle.

  • OldestScalingConfiguration : supprime l'instance ECS qui a été créée à partir de la configuration de mise à l'échelle la plus ancienne.

Remarque

La suppression des instances ECS d'un groupe de mise à l'échelle est également affectée par la stratégie de mise à l'échelle (MultiAZPolicy) du groupe de mise à l'échelle. Pour plus d'informations, consultez Configurer une stratégie combinée pour la suppression d'instances.

OldestInstance

RemovalPolicy.3

string

Non

La stratégie de filtrage de troisième tour pour la politique de descente en charge. Ce paramètre ne peut pas avoir la même valeur que RemovalPolicy.1 ou RemovalPolicy.2. Valeurs valides :

  • OldestInstance : supprime l'instance ECS qui a été ajoutée en premier au groupe de mise à l'échelle.

  • NewestInstance : supprime l'instance ECS qui a été ajoutée le plus récemment au groupe de mise à l'échelle.

  • OldestScalingConfiguration : supprime l'instance ECS qui a été créée à partir de la configuration de mise à l'échelle la plus ancienne.

Remarque

La suppression des instances ECS d'un groupe de mise à l'échelle est également affectée par la stratégie de mise à l'échelle (MultiAZPolicy) du groupe de mise à l'échelle. Pour plus d'informations, consultez Configurer une stratégie combinée pour la suppression d'instances.

NewestInstance

VSwitchId

string

Non

L'identifiant du vSwitch. Si vous spécifiez ce paramètre, le type de réseau du groupe de mise à l'échelle est VPC.

Remarque

Si ni VSwitchId ni VSwitchIds.N n'est spécifié pour le groupe de mise à l'échelle, le type de réseau du groupe de mise à l'échelle est par défaut le réseau classique.

vsw-bp14zolna43z266bq****

MultiAZPolicy

string

Non

La stratégie de mise à l'échelle pour les instances ECS dans un groupe de mise à l'échelle multi-zone. Valeurs valides :

  • PRIORITY : le vSwitch spécifié en premier (VSwitchIds.N) a la priorité la plus élevée. Auto Scaling tente en priorité de mettre à l'échelle les instances dans la zone du vSwitch ayant la priorité la plus élevée. Si la mise à l'échelle ne peut pas être effectuée, Auto Scaling tente automatiquement de mettre à l'échelle les instances dans la zone du vSwitch de priorité suivante.

  • COST_OPTIMIZED : lors des événements de montée en charge, Auto Scaling tente de créer des instances ECS par ordre croissant de prix unitaire de vCPU. Lors des événements de descente en charge, Auto Scaling tente de supprimer des instances ECS par ordre décroissant de prix unitaire de vCPU. Si la configuration de mise à l'échelle spécifie des méthodes de facturation préemptibles avec plusieurs types d'instances, les instances spot sont créées en priorité. Vous pouvez utiliser le paramètre CompensateWithOnDemand pour spécifier s'il faut créer automatiquement des instances à la demande lorsque des instances spot ne peuvent pas être créées en raison d'un stock insuffisant ou d'autres raisons.

    Remarque

    COST_OPTIMIZED ne prend effet que lorsque la configuration de mise à l'échelle spécifie plusieurs types d'instances ou utilise des instances spot.

  • BALANCE : les instances ECS sont réparties uniformément entre les multiples zones spécifiées pour le groupe de mise à l'échelle. Si les instances deviennent déséquilibrées entre les zones en raison d'un stock insuffisant ou d'autres raisons, vous pouvez appeler l'opération RebalanceInstance pour rééquilibrer les ressources.

  • COMPOSABLE : est une stratégie composable qui vous permet de combiner les stratégies de mise à l'échelle multi-zone précédentes pour les instances ECS. Vous pouvez également spécifier des paramètres supplémentaires pour un contrôle plus granulaire de la capacité du groupe de mise à l'échelle.

Valeur par défaut : PRIORITY.

PRIORITY

HealthCheckType

string

Non

Le mode de bilan de santé du groupe de mise à l'échelle. Valeurs valides :

  • NONE : aucun bilan de santé n'est effectué.

  • ECS : des bilans de santé sont effectués sur les instances du groupe de mise à l'échelle. (Les groupes de mise à l'échelle de type ECS et de type ECI utilisent cette valeur pour activer les bilans de santé des instances.)

  • LOAD_BALANCER : l'état de santé de l'instance est déterminé en fonction des résultats du bilan de santé de l'équilibreur de charge. (L'équilibrage de charge de type CLB n'est pas pris en charge.)

Valeur par défaut : ECS.

Remarque

Pour activer à la fois les bilans de santé des instances et les bilans de santé de l'équilibreur de charge, utilisez le paramètre HealthCheckTypes.

ECS

ScalingPolicy

string

Non

Le mode de récupération du groupe de mise à l'échelle. Valeurs valides :

  • recycle : le groupe de mise à l'échelle utilise le mode d'arrêt et de récupération.

  • release : le groupe de mise à l'échelle utilise le mode de libération.

  • forcerelease : le groupe de mise à l'échelle utilise le mode de libération forcée.

    Remarque

    Si vous sélectionnez forcerelease, les instances en cours d'exécution sont libérées de force lors des activités de descente en charge. Une libération forcée équivaut à une opération de mise hors tension, qui efface les données temporaires dans la mémoire et le stockage de l'instance. Les données ne peuvent pas être récupérées. Procédez avec prudence.

  • forcerecycle : le groupe de mise à l'échelle utilise le mode d'arrêt forcé et de récupération.

    Remarque

    Si vous sélectionnez forcerecycle, les instances en cours d'exécution sont arrêtées de force lors des activités de descente en charge. Un arrêt forcé équivaut à une opération de mise hors tension, qui efface les données temporaires dans la mémoire et le stockage de l'instance. Les données ne peuvent pas être récupérées. Procédez avec prudence.

ScalingPolicy spécifie le mode de récupération du groupe de mise à l'échelle. Cependant, l'action spécifique entreprise lorsqu'une instance est supprimée du groupe de mise à l'échelle est déterminée par le paramètre RemovePolicy de RemoveInstances. Pour plus d'informations, consultez RemoveInstances.

recycle

ClientToken

string

Non

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

Générez une valeur à partir de votre client qui soit unique parmi les différentes requêtes. La valeur ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.

123e4567-e89b-12d3-a456-42665544****

OnDemandBaseCapacity

integer

Non

Le nombre minimum d'instances à la demande requis dans le groupe de mise à l'échelle. Valeurs valides : 0 à 1000. Lorsque le nombre d'instances à la demande est inférieur à cette valeur, les instances à la demande sont créées en priorité.

Lorsque le paramètre MultiAZPolicy est défini sur COMPOSABLE, la valeur par défaut est 0.

30

OnDemandPercentageAboveBaseCapacity

integer

Non

Le pourcentage d'instances à la demande parmi les instances excédentaires après que le nombre minimum d'instances à la demande (OnDemandBaseCapacity) est atteint. Valeurs valides : 0 à 100.

Lorsque le paramètre MultiAZPolicy est défini sur COMPOSABLE, la valeur par défaut est 100.

20

SpotInstanceRemedy

boolean

Non

Indique s'il faut compléter les instances spot. Si cette fonctionnalité est activée, Auto Scaling tente de créer une nouvelle instance pour remplacer une instance spot lorsque le système envoie une notification indiquant que l'instance spot est sur le point d'être récupérée.

true

CompensateWithOnDemand

boolean

Non

Indique s'il faut créer automatiquement des instances à la demande pour répondre au nombre requis d'instances ECS lorsque des instances spot ne peuvent pas être créées en raison de prix ou de stock. Ce paramètre ne prend effet que lorsque MultiAZPolicy est défini sur COST_OPTIMIZED. Valeurs valides :

  • true : autorise la création automatique.

  • false : n'autorise pas la création automatique.

Valeur par défaut : true.

true

SpotInstancePools

integer

Non

Le nombre de types d'instances disponibles. Auto Scaling crée uniformément des instances spot de plusieurs types offrant le coût le plus bas. Valeurs valides : 1 à 10.

Lorsque le paramètre MultiAZPolicy est défini sur COMPOSABLE, la valeur par défaut est 2.

5

DesiredCapacity

integer

Non

Le nombre attendu d'instances dans le groupe de mise à l'échelle. Le groupe de mise à l'échelle maintient automatiquement le nombre d'instances ECS au nombre attendu d'instances. La valeur ne peut pas être supérieure à MaxSize ou inférieure à MinSize.

5

GroupDeletionProtection

boolean

Non

Indique s'il faut activer la protection contre la suppression pour le groupe de mise à l'échelle. Valeurs valides :

  • true : active la protection contre la suppression. Le groupe de mise à l'échelle ne peut pas être supprimé.

  • false : désactive la protection contre la suppression.

Valeur par défaut : false.

true

GroupType

string

Non

Le type d'instances gérées par le groupe de mise à l'échelle. Valeurs valides :

  • ECS : le groupe de mise à l'échelle gère des instances ECS.

  • ECI : le groupe de mise à l'échelle gère des instances Elastic Container Instance (ECI).

Valeur par défaut : ECS.

ECS

ContainerGroupId

string

Non

L'identifiant d'instance de l'instance ECI, qui est l'identifiant du groupe de conteneurs.

eci-uf6fonnghi50u374****

VSwitchIds

array

Non

Les identifiants d'un ou plusieurs vSwitches. Si vous spécifiez le paramètre VSwitchIds, le paramètre VSwitchId est ignoré. Si vous spécifiez ce paramètre, le type de réseau du groupe de mise à l'échelle est VPC.

Lorsque vous spécifiez plusieurs vSwitches :

  • Les vSwitches doivent appartenir au même VPC.

  • Les vSwitches peuvent appartenir à différentes zones.

  • La priorité des vSwitches est déterminée par ordre numérique croissant, où 1 indique la priorité la plus élevée. Lorsqu'une instance ECS ne peut pas être créée dans la zone d'un vSwitch de priorité supérieure, le vSwitch de priorité suivante est automatiquement sélectionné.

Remarque

Si ni VSwitchId ni VSwitchIds n'est spécifié pour le groupe de mise à l'échelle, le type de réseau du groupe de mise à l'échelle est par défaut le réseau classique.

vsw-bp14zolna43z266bq****

string

Non

Les identifiants d'un ou plusieurs vSwitches. Si vous spécifiez le paramètre VSwitchIds.N, le paramètre VSwitchId est ignoré. Si vous spécifiez ce paramètre, le type de réseau du groupe de mise à l'échelle est VPC.

Lorsque vous spécifiez plusieurs vSwitches :

  • Les vSwitches doivent appartenir au même VPC.

  • Les vSwitches peuvent appartenir à différentes zones.

  • La priorité des vSwitches est déterminée par ordre numérique croissant, où 1 indique la priorité la plus élevée. Lorsqu'une instance ECS ne peut pas être créée dans la zone d'un vSwitch de priorité supérieure, le vSwitch de priorité suivante est automatiquement sélectionné.

Remarque

Si ni VSwitchId ni VSwitchIds.N n'est spécifié pour le groupe de mise à l'échelle, le type de réseau du groupe de mise à l'échelle est par défaut le réseau classique.

vsw-bp14zolna43z266bq****

LifecycleHook

array<object>

Non

Les informations du crochet de cycle de vie.

object

Non

Les informations du crochet de cycle de vie.

DefaultResult

string

Non

L'action à entreprendre après la fin de l'état d'attente. Valeurs valides :

  • CONTINUE : continue de répondre à l'événement de montée en charge ou de descente en charge.

  • ABANDON : libère l'instance ECS créée lors de l'événement de montée en charge, ou supprime directement l'instance ECS du groupe de mise à l'échelle lors de l'événement de descente en charge.

Lorsqu'un événement de descente en charge (SCALE_IN) se produit dans le groupe de mise à l'échelle et déclenche plusieurs crochets de cycle de vie, si l'état d'attente d'un crochet de cycle de vie avec DefaultResult défini sur ABANDON se termine, les états d'attente des autres crochets de cycle de vie correspondants se terminent prématurément. Dans les autres cas, l'action est déterminée par le dernier crochet de cycle de vie dont l'état d'attente se termine.

Valeur par défaut : CONTINUE.

CONTINUE

LifecycleHookName

string

Non

Le nom du crochet de cycle de vie. Une fois le nom spécifié, il ne peut pas être modifié. S'il n'est pas spécifié, le nom prend par défaut l'identifiant du crochet de cycle de vie.

lifecyclehook****

LifecycleTransition

string

Non

Le type d'activité de mise à l'échelle auquel le crochet de cycle de vie s'applique. Valeurs valides :

  • SCALE_OUT : événements de montée en charge du groupe de mise à l'échelle.

  • SCALE_IN : événements de descente en charge du groupe de mise à l'échelle.

Remarque

Si des crochets de cycle de vie sont spécifiés pour le groupe de mise à l'échelle, ce paramètre est requis. Les autres paramètres associés sont facultatifs.

SCALE_OUT

NotificationMetadata

string

Non

Les informations de chaîne fixe pour l'état d'attente de l'activité de mise à l'échelle. La valeur du paramètre ne peut pas dépasser 128 caractères. Chaque fois qu'Auto Scaling envoie un message au destinataire de la notification, il envoie également la valeur du paramètre NotificationMetadata que vous avez spécifiée, ce qui vous aide à gérer et à marquer différentes catégories d'informations de notification. Ce paramètre ne prend effet que lorsque le paramètre NotificationArn est également spécifié.

Test

NotificationArn

string

Non

L'identifiant du destinataire de la notification pour le crochet de cycle de vie. Les types d'objets de notification suivants sont pris en charge : les files d'attente et les sujets Simple Message Queue (anciennement MNS). Spécifiez la valeur du paramètre au format suivant : acs:ess:{region}:{account-id}:{resource-relative-id}.

  • region : la région où réside le groupe de mise à l'échelle.

  • account-id : l'identifiant du compte Alibaba Cloud.

Exemples :

  • File d'attente MNS : acs:ess:{region}:{account-id}:queue/{queuename}.

  • Sujet MNS : acs:ess:{region}:{account-id}:topic/{topicname}.

acs:ess:cn-hangzhou:1111111111:queue/queue2

HeartbeatTimeout

integer

Non

Le temps d'attente défini par le crochet de cycle de vie pour l'activité du groupe de mise à l'échelle. L'action suivante est effectuée après l'expiration du délai d'attente. Valeurs valides : 30 à 21600. Unité : secondes.

Une fois qu'un crochet de cycle de vie est créé, vous pouvez appeler RecordLifecycleActionHeartbeat pour prolonger le temps d'attente de l'instance ECS, ou appeler CompleteLifecycleAction pour mettre fin prématurément à l'état d'attente de l'activité de mise à l'échelle.

Valeur par défaut : 600.

600

VServerGroup

array<object>

Non

Les informations sur les groupes de serveurs virtuels associés au groupe de mise à l'échelle.

array<object>

Non

Les informations sur les groupes de serveurs virtuels associés au groupe de mise à l'échelle.

VServerGroupAttribute

array<object>

Non

Les attributs du groupe de serveurs backend.

object

Non

Les attributs du groupe de serveurs backend.

VServerGroupId

string

Non

L'identifiant du groupe de serveurs virtuel.

Pour plus d'informations, consultez AttachVServerGroups.

rsp-bp1443g77****

Weight

integer

Non

Le poids de l'instance en tant que serveur backend après qu'Auto Scaling a ajouté l'instance au groupe de serveurs virtuel. Un poids plus élevé indique que l'instance se voit attribuer davantage de requêtes d'accès. Si le poids est de 0, l'instance ne reçoit pas de requêtes d'accès. Valeurs valides : 0 à 100. Valeur par défaut : 50.

Pour plus d'informations, consultez AttachVServerGroups.

100

Port

integer

Non

Le numéro de port utilisé par l'instance après qu'Auto Scaling a ajouté l'instance au groupe de serveurs virtuel. Valeurs valides : 1 à 65535.

Pour plus d'informations, consultez AttachVServerGroups.

22

LoadBalancerId

string

Non

L'identifiant de l'instance CLB (anciennement SLB) à laquelle le groupe de serveurs virtuel appartient.

Pour plus d'informations, consultez AttachVServerGroups.

lb-bp1u7etiogg38yvwz****

Tag

array<object>

Non

Les balises du groupe de mise à l'échelle.

object

Non

Les balises du groupe de mise à l'échelle.

Key

string

Non

La clé de balise du groupe de mise à l'échelle.

Department

Value

string

Non

La valeur de balise du groupe de mise à l'échelle.

Finance

Propagate

boolean

Non

Indique si la balise est une balise propagable. Valeurs valides :

  • true : les balises du groupe de mise à l'échelle sont propagées uniquement aux instances nouvellement créées, et non aux instances qui sont déjà en cours d'exécution dans le groupe de mise à l'échelle.

  • false : les balises du groupe de mise à l'échelle ne sont pas propagées aux instances.

Valeur par défaut : false.

false

LaunchTemplateOverride

array<object>

Non

Les informations de substitution du modèle de lancement.

object

Non

Les informations de substitution du modèle de lancement.

InstanceType

string

Non

Pour mettre à l'échelle le groupe de mise à l'échelle en fonction de la capacité des types d'instances, spécifiez à la fois ce paramètre et LaunchTemplateOverride.N.WeightedCapacity.

Ce paramètre spécifie le type d'instance et remplace le type d'instance dans le modèle de lancement. Vous pouvez spécifier N valeurs pour ce paramètre afin d'étendre le modèle de lancement pour prendre en charge N types d'instances. Valeurs valides de N : 1 à 20.

Remarque

Ce paramètre ne prend effet que lorsque le paramètre LaunchTemplateId spécifie un modèle de lancement.

Valeurs valides de InstanceType : types d'instances ECS disponibles à l'achat. Pour plus d'informations, consultez Familles d'instances.

ecs.c5.xlarge

WeightedCapacity

integer

Non

Pour dimensionner le groupe de mise à l'échelle en fonction de la capacité des types d'instances, spécifiez ce paramètre après avoir spécifié LaunchTemplateOverride.N.InstanceType. Ces deux paramètres sont liés et la valeur de N doit être identique pour les deux.

Ce paramètre définit le poids du type d'instance, qui représente la capacité d'une instance unique de ce type au sein du groupe de mise à l'échelle. Plus le poids est élevé, moins il faut d'instances de ce type pour atteindre la capacité souhaitée.

Les types d'instances présentant des différences en termes de métriques de performances, telles que le nombre de vCPU et la taille de la mémoire, vous pouvez attribuer des poids différents aux différents types d'instances en fonction de vos besoins.

Exemple :

  • Capacité actuelle : 0.

  • Capacité attendue : 6.

  • Capacité de ecs.c5.xlarge : 4.

Pour atteindre la capacité attendue, le groupe de mise à l'échelle ajoute 2 instances ecs.c5.xlarge.

Remarque

Lors des opérations d'extension, la capacité du groupe de mise à l'échelle ne peut pas dépasser la somme de la capacité maximale (MaxSize) et du poids maximal des types d'instances.

Valeurs valides de WeightedCapacity : 1 à 500.

4

SpotPriceLimit

number

Non

Le prix d'offre maximum pour le type d'instance spécifié par LaunchTemplateOverride.N.InstanceType. Vous pouvez spécifier N valeurs pour ce paramètre afin d'étendre le modèle de lancement pour prendre en charge N types d'instances. Valeurs valides de N : 1 à 20.

Remarque

Ce paramètre ne prend effet que lorsque le paramètre LaunchTemplateId spécifie un modèle de lancement.

0.025

AlbServerGroup

array<object>

Non

Les informations sur les groupes de serveurs ALB.

object

Non

Les informations sur les groupes de serveurs ALB.

AlbServerGroupId

string

Non

L'identifiant du groupe de serveurs ALB.

N spécifie le numéro du groupe de serveurs ALB. Le nombre de groupes de serveurs ALB pouvant être associés à un groupe de mise à l'échelle est limité. Pour consulter ou demander une augmentation de quota, accédez au Centre de quotas.

sgp-ddwb0y0g6y9bjm****

Weight

integer

Non

Le poids de l'instance en tant que serveur backend après qu'Auto Scaling a ajouté l'instance au groupe de serveurs ALB. Un poids plus élevé indique que l'instance reçoit davantage de requêtes. Si le poids est de 0, l'instance ne reçoit aucune requête. Valeurs valides : 0 à 100.

N spécifie le numéro du groupe de serveurs ALB.

100

Port

integer

Non

Le numéro de port utilisé par l'instance après qu'Auto Scaling a ajouté l'instance au groupe de serveurs ALB. Valeurs valides : 1 à 65535.

N spécifie le numéro du groupe de serveurs ALB.

Remarque

Si les valeurs de N sont identiques mais que les valeurs de Port sont différentes, le système associe le groupe de serveurs ALB au groupe de mise à l'échelle plusieurs fois avec des ports différents.

22

ServerGroup

array<object>

Non

Les informations sur les groupes de serveurs d'équilibrage de charge.

Remarque

Vous ne pouvez pas définir les mêmes informations de groupe de serveurs à la fois dans AlbServerGroups et ServerGroups.

object

Non

Les informations sur les groupes de serveurs d'équilibrage de charge.

ServerGroupId

string

Non

L'identifiant du groupe de serveurs.

sgp-5yc3bd9lfyh*****

Type

string

Non

Le type du groupe de serveurs. Valeurs valides :

  • ALB : Application Load Balancer (ALB).

  • NLB : Network Load Balancer (NLB).

  • GWLB : Gateway Load Balancer (GWLB).

ALB

Weight

integer

Non

Le poids de l'instance en tant que serveur backend après qu'Auto Scaling a ajouté l'instance au groupe de serveurs. Valeurs valides : 0 à 100.

Un poids plus élevé indique que l'instance se voit allouer davantage de requêtes d'accès. Si le poids est de 0, l'instance ne reçoit pas de requêtes d'accès.

Remarque

Ce paramètre est requis pour les groupes de serveurs d'équilibrage de charge ALB et NLB. Vous ne pouvez pas définir ce paramètre pour les groupes de serveurs d'équilibrage de charge GWLB.

100

Port

integer

Non

Le numéro de port utilisé par l'instance après qu'Auto Scaling a ajouté l'instance au groupe de serveurs. Valeurs valides : 1 à 65535.

Remarque

Ce paramètre est requis pour les groupes de serveurs d'équilibrage de charge ALB et NLB. Vous ne pouvez pas définir ce paramètre pour les groupes de serveurs d'équilibrage de charge GWLB. La valeur par défaut pour GWLB est 6081.

22

AzBalance

boolean

Non

Indique si la capacité du groupe de mise à l'échelle doit être répartie uniformément sur plusieurs zones. Ce paramètre prend effet uniquement lorsque MultiAZPolicy est défini sur COMPOSABLE. Valeurs valides :

  • true : la capacité du groupe de mise à l'échelle est répartie uniformément sur plusieurs zones.

  • false : la capacité du groupe de mise à l'échelle n'est pas répartie uniformément sur plusieurs zones.

Valeur par défaut : false.

false

AllocationStrategy

string

Non

La stratégie d'allocation de capacité qui détermine la manière dont le groupe de mise à l'échelle sélectionne les types d'instances disponibles pour répondre aux exigences de capacité. La stratégie d'allocation de capacité s'applique à la fois aux capacités à la demande et aux capacités spot. Ce paramètre prend effet uniquement lorsque MultiAZPolicy est défini sur COMPOSABLE. Valeurs valides :

  • priority : les instances sont créées en fonction de l'ordre des types d'instances configurés.

  • lowestPrice : les instances sont créées en fonction du prix unitaire par vCPU des types d'instances, par ordre croissant.

Valeur par défaut : priority.

priority

SpotAllocationStrategy

string

Non

La stratégie d'allocation pour la capacité spot. Vous pouvez utiliser ce paramètre pour spécifier séparément la stratégie d'allocation pour la capacité spot. Ce paramètre prend effet uniquement lorsque MultiAZPolicy est défini sur COMPOSABLE. Valeurs valides :

  • priority : les instances sont créées en fonction de l'ordre des types d'instances configurés.

  • lowestPrice : les instances sont créées en fonction du prix unitaire par vCPU des types d'instances, par ordre croissant.

Valeur par défaut : priority.

lowestPrice

MaxInstanceLifetime

integer

Non

La durée maximale pendant laquelle une instance peut exister dans le groupe de mise à l'échelle. Unité : secondes.

Valeurs valides : [86400, Integer.maxValue].

Valeur par défaut : null.

Remarque

Ce paramètre n'est pas pris en charge pour les groupes de mise à l'échelle de type Elastic Container Instance (ECI) ou les groupes de mise à l'échelle avec le mode économique activé.

86400

CustomPolicyARN

string

Non

L'Alibaba Cloud Resource Name (ARN) de la fonction de stratégie de réduction personnalisée China. Ce paramètre prend effet uniquement lorsque la première stratégie de suppression dans RemovalPolicies est définie sur CustomPolicy.

acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name

ResourceGroupId

string

Non

L'identifiant du groupe de ressources auquel le groupe de mise à l'échelle appartient.

Remarque

Le groupe de mise à l'échelle nouvellement créé est ajouté au groupe de ressources spécifié. Si vous ne spécifiez pas ce paramètre, le groupe de mise à l'échelle est ajouté au groupe de ressources par défaut.

rg-123****

LoadBalancerConfig

array<object>

Non

Les configurations des instances Classic Load Balancer (CLB, anciennement SLB).

object

Non

Les configurations des instances Classic Load Balancer (CLB, anciennement SLB).

LoadBalancerId

string

Non

L'identifiant de l'instance Classic Load Balancer (CLB, anciennement SLB).

147b46d767c-cn-qingdao-cm5****

Weight

integer

Non

Le poids de l'instance en tant que serveur backend après qu'Auto Scaling a ajouté l'instance au groupe de serveurs CLB (anciennement SLB). Un poids plus élevé indique que l'instance se voit allouer davantage de requêtes d'accès. Si le poids est de 0, l'instance ne reçoit pas de requêtes d'accès.

Valeurs valides : 0 à 100.

10

HealthCheckTypes

array

Non

Les modes de vérification de l'état du groupe de mise à l'échelle.

Remarque

Vous pouvez utiliser ce paramètre pour spécifier plusieurs modes de vérification de l'état. Si le paramètre HealthCheckType est spécifié, ce paramètre est ignoré.

string

Non

Les modes de vérification de l'état du groupe de mise à l'échelle. Valeurs valides :

  • NONE : les vérifications de l'état sont désactivées.

  • ECS : les vérifications de l'état sont effectuées sur les instances du groupe de mise à l'échelle. Cette valeur s'applique aux groupes de mise à l'échelle de type ECS et de type ECI.

  • LOAD_BALANCER : l'état de santé des instances est déterminé en fonction des résultats de vérification de l'état de l'équilibrage de charge. L'équilibrage de charge de type CLB n'est pas pris en charge.

Valeur par défaut : ECS.

ECS

DBInstance

array<object>

Non

Les bases de données associées au groupe de mise à l'échelle.

object

Non

La configuration des bases de données associées au groupe de mise à l'échelle.

DBInstanceId

string

Non

L'identifiant d'instance de la base de données.

rm-m5eqju85s45mu0***

Type

string

Non

Le type de la base de données. Valeurs valides :

  • RDS.

  • Redis.

  • MongoDB.

Valeur par défaut : RDS.

RDS

AttachMode

string

Non

Le mode selon lequel le groupe de mise à l'échelle est associé à la base de données. Valeurs valides :

  • SecurityIp : mode liste blanche d'adresses IP. Les instances ajoutées lors des événements de mise à l'échelle vers le haut sont automatiquement ajoutées à la liste blanche d'adresses IP de la base de données. Seules les bases de données RDS sont prises en charge.

  • SecurityGroup : mode groupe de sécurité. Le groupe de sécurité spécifié dans la configuration de mise à l'échelle est ajouté à la liste blanche de groupes de sécurité de la base de données, ce qui permet aux instances du groupe de sécurité d'accéder à la base de données.

SecurityIp

StopInstanceTimeout

integer

Non

Le délai d'attente pour l'arrêt d'une instance ECS lors d'un processus de réduction d'échelle. Unité : secondes. Valeurs valides : 30 à 240.

Remarque
  • Ce paramètre prend effet uniquement lors des processus de réduction d'échelle lorsque ScalingPolicy est défini sur release.

  • Si ce paramètre est spécifié, le système attend l'arrêt de l'instance pendant une durée maximale correspondant à StopInstanceTimeout. Après l'expiration du délai, le processus de réduction d'échelle se poursuit, que l'instance se soit arrêtée ou non.

  • Si ce paramètre n'est pas spécifié, le système attend indéfiniment l'arrêt de l'instance. Le processus de réduction d'échelle ne se poursuit qu'après l'arrêt de l'instance. Si l'instance ne parvient pas à s'arrêter, le processus de réduction d'échelle est annulé et échoue.

60

CapacityOptions

object

Non

Les options de capacité.

OnDemandBaseCapacity

integer

Non

Le nombre minimum d'instances à la demande requis dans le groupe de mise à l'échelle. Si le nombre d'instances à la demande dans le groupe de mise à l'échelle est inférieur à cette valeur, le système crée en priorité des instances à la demande. Valeurs valides : 0 à 1000.

Lorsque MultiAZPolicy est défini sur COMPOSABLE, la valeur par défaut est 0.

30

OnDemandPercentageAboveBaseCapacity

integer

Non

Le pourcentage d'instances à la demande parmi les instances supplémentaires qui dépassent la valeur OnDemandBaseCapacity. Valeurs valides : 0 à 100.

Lorsque MultiAZPolicy est défini sur COMPOSABLE, la valeur par défaut est 100.

20

CompensateWithOnDemand

boolean

Non

Indique s'il faut créer automatiquement des instances à la demande pour répondre au nombre requis d'instances ECS lorsque des instances spot ne peuvent pas être créées en raison de prix ou de stock. Ce paramètre ne prend effet que lorsque MultiAZPolicy est défini sur COST_OPTIMIZED. Valeurs valides :

  • true : autorise la création automatique.

  • false : n'autorise pas la création automatique.

Valeur par défaut : true.

true

SpotAutoReplaceOnDemand

boolean

Non

Indique si des instances spot doivent être utilisées pour remplacer les instances à la demande lorsque le ratio d'instances à la demande dépasse la valeur OnDemandPercentageAboveBaseCapacity après l'activation de CompensateWithOnDemand. Un scénario courant est celui où les instances spot sont rétrogradées en instances à la demande en raison de problèmes de stock ou de tarification spot causés par CompensateWithOnDemand. Pour éviter que les instances à la demande ne persistent pendant une période prolongée, le système tente de remplacer la capacité excédentaire à la demande par des instances spot. Valeurs valides :

  • true : autorisé.

  • false : non autorisé.

Valeur par défaut : false.

false

PriceComparisonMode

string

Non

Le mode de comparaison des prix pour la stratégie d'optimisation des coûts du groupe de mise à l'échelle. Valeurs valides :

  • PricePerUnit : compare les prix en fonction du prix par unité de capacité.

    La capacité d'une instance dans le groupe de mise à l'échelle est égale au poids configuré pour le type d'instance. Le poids par défaut est 1, ce qui signifie qu'une instance ECS occupe une capacité de 1.

  • PricePerVCpu : compare les prix en fonction du prix par vCPU.

Valeur par défaut : PricePerUnit.

PricePerUnit

BalanceMode

string

Non

Le mode d'équilibrage des zones. Ce paramètre prend effet uniquement lorsque l'équilibrage des zones est activé. Valeurs valides :

  • BalancedBestEffort : Si la création de ressources échoue dans une zone, le système se rabat sur d'autres zones pour garantir la fourniture des ressources au mieux.

  • BalancedOnly : Si la création de ressources échoue dans une zone, le système ne se rabat pas sur d'autres zones. L'activité de mise à l'échelle réussit partiellement pour éviter un déséquilibre excessif des ressources entre les zones.

Valeur par défaut : BalancedBestEffort.

BalancedBestEffort

AutoRebalance

boolean

Non

Indique si le rééquilibrage automatique doit être activé pour le groupe de mise à l'échelle. Ce paramètre prend effet uniquement lorsque BalancedOnly est activé pour un groupe de mise à l'échelle avec équilibrage des zones. Valeurs valides :

  • false : le rééquilibrage automatique est désactivé.

  • true : lorsque le rééquilibrage automatique est activé, le groupe de mise à l'échelle surveille automatiquement la capacité entre les zones. Si la capacité est déséquilibrée entre les zones, le groupe de mise à l'échelle effectue de manière proactive des opérations de mise à l'échelle vers le haut et vers le bas pour rééquilibrer la capacité.

Valeur par défaut : false.

false

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

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

ScalingGroupId

string

L'identifiant du groupe de mise à l'échelle.

asg-bp14wlu85wrpchm0****

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroupId": "asg-bp14wlu85wrpchm0****"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

404 ResourceNotAvailable.VPCNetwork The specified zone does not support vpc network or sold out.

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

Notes de version

Consultez Notes de version pour la liste complète.