Tous les produits
Search
Centre de documentation

Auto Scaling:ApplyScalingGroup

Dernière mise à jour :Oct 27, 2026

Crée et gère un groupe de mise à l'échelle à l'aide d'un fichier de configuration.

Description de l'opération

L'opération ApplyScalingGroup prend en charge le format de définition de ressource Kubernetes Deployment pour créer rapidement des groupes de mise à l'échelle Elastic Container Instance (ECI). Elle prend également en charge les annotations étendues ECI pour les fichiers YAML Kubernetes. Pour plus d'informations, consultez la section « Annotations prises en charge ».

Mappage entre les configurations YAML et les groupes de mise à l'échelle : le nom d'un groupe de mise à l'échelle est mappé par le tuple namespace, kind et name dans la définition YAML. Dans une même région, une même configuration YAML ne peut être mappée qu'au même groupe de mise à l'échelle. Exemple : si vous utilisez une configuration YAML de Deployment nommée nginx dans l'espace de noms par défaut, elle est mappée à un groupe de mise à l'échelle nommé k8s_default_Deployment_nginx dans la même région.

Logique de gestion des groupes de mise à l'échelle basée sur les configurations YAML :

  • Si le groupe de mise à l'échelle mappé à la configuration YAML existe, le groupe de mise à l'échelle est mis à jour en fonction de la configuration YAML.

  • Si le groupe de mise à l'échelle mappé à la configuration YAML n'existe pas, un groupe de mise à l'échelle correspondant est créé en fonction de la configuration YAML.

Précautions \n\n1. Si la configuration YAML ne spécifie pas les annotations VPC, vSwitch et groupe de sécurité, le système crée automatiquement un VPC par défaut, crée un vSwitch par défaut dans le VPC et crée le groupe de sécurité Auto Scaling par défaut ess-default-sg. Par défaut, la stratégie du groupe de sécurité autorise le trafic sur les ports TCP 22 et 3389, ainsi que le protocole ICMP (IPv4). Si vous avez d'autres exigences en matière de ports et de protocoles, vous pouvez modifier la stratégie du groupe de sécurité.\n2. Lorsque vous utilisez une image publique, vous devez activer l'accès au réseau public et configurer les paramètres de l'annotation de pod k8s.aliyun.com/eci-with-eip pour activer l'adresse IP élastique (EIP).\n3. Une fois que l'opération ApplyScalingGroup applique la configuration YAML, le groupe de mise à l'échelle et la configuration de mise à l'échelle prennent effet immédiatement. Si replicas est défini sur une valeur supérieure à 0, la création automatique de ressources est déclenchée.

Annotations prises en charge\nLes annotations sont référencées à partir de Annotation de pod ECI.\n|Paramètre|Exemple|Description|\n|-----|-----|-----|\n|k8s.aliyun.com/ess-scaling-group-min-size|1|Le nombre minimum d'instances dans le groupe de mise à l'échelle. Valeur par défaut : 0.\n|k8s.aliyun.com/ess-scaling-group-max-size|20|Le nombre maximum d'instances dans le groupe de mise à l'échelle. Valeur par défaut : max(replicas, 30).\n|k8s.aliyun.com/eci-ntp-server|100.100..|Le serveur NTP.\n|k8s.aliyun.com/eci-use-specs|2-4Gi|Les spécifications de l'instance, telles que 2 vCPU et 4 Gio de mémoire. Pour plus d'informations, consultez Créer un pod en utilisant plusieurs types d'instances.\n|k8s.aliyun.com/eci-vswitch|vsw-bp1xpiowfm5vo8o3c****|L'identifiant du vSwitch. Vous pouvez spécifier plusieurs vSwitch pour implémenter la fonctionnalité de zone multi-active.\n|k8s.aliyun.com/eci-security-group|sg-bp1dktddjsg5nktv****|L'identifiant du groupe de sécurité. Exigences :
  • Vous pouvez spécifier un ou plusieurs groupes de sécurité. Un maximum de cinq groupes de sécurité peut être spécifié.

  • Les groupes de sécurité spécifiés doivent appartenir au même VPC.

  • Les groupes de sécurité spécifiés doivent être du même type.

\n|k8s.aliyun.com/eci-sls-enable|"false"|Indique si la collecte des journaux doit être désactivée. La valeur false indique que la collecte des journaux est désactivée.

Lorsque vous collectez des journaux à l'aide de CRD Simple Log Service, si vous n'avez pas besoin de collecter des journaux pour des pods spécifiques, vous pouvez configurer cette annotation pour désactiver la fonctionnalité de collecte des journaux. Cela empêche le système de créer automatiquement Logtail et de gaspiller des ressources.

\n|k8s.aliyun.com/eci-spot-strategy|SpotAsPriceGo|La stratégie d'enchère pour l'instance spot. Valeurs valides :
  • SpotWithPriceLimit : vous utilisez des paramètres personnalisés pour le prix horaire maximum de l'instance spot. Dans ce cas, vous devez définir k8s.aliyun.com/eci-spot-price-limit.

  • SpotAsPriceGo : le système place automatiquement des enchères en fonction du prix réel du marché actuel.

\n|k8s.aliyun.com/eci-spot-price-limit|"0.5"|Le prix horaire maximum pour l'instance spot. La valeur est précise à trois décimales près.

Ce paramètre prend effet uniquement lorsque les paramètres de k8s.aliyun.com/eci-spot-strategy sont SpotWithPriceLimit.

\n|k8s.aliyun.com/eci-with-eip|"true"|Indique si une EIP doit être créée et attachée automatiquement. La valeur true indique qu'une EIP est automatiquement créée et attachée.\n|k8s.aliyun.com/eci-data-cache-bucket|default|Le compartiment de DataCache. Ce paramètre est requis lorsque vous utilisez DataCache pour créer un pod.\n|k8s.aliyun.com/eci-data-cache-pl|PL1|Le niveau de performance (PL) du disque cloud créé sur la base de DataCache.

Par défaut, un SSD standard ESSD est utilisé, et le PL par défaut est PL1.

\n|k8s.aliyun.com/eci-data-cache-provisionedIops|"40000"|Les IOPS de lecture et d'écriture provisionnés du disque cloud ESSD AutoPL. Valeurs valides : 0 à min{50000, 1000 × Capacité - Performance de base}. Performance de base = min{1800 + 50 × Capacité, 50000}. Pour plus d'informations, consultez Disques cloud ESSD AutoPL.

Si cette annotation est ajoutée, le disque cloud créé sur la base de DataCache est un disque cloud ESSD AutoPL.

\n|k8s.aliyun.com/eci-data-cache-burstingEnabled|"true"|Indique si la fonctionnalité de rafale doit être activée pour le disque cloud ESSD AutoPL. Pour plus d'informations, consultez Disques cloud ESSD AutoPL.

Si cette annotation est ajoutée, le disque cloud créé sur la base de DataCache est un disque cloud ESSD AutoPL.

\n|k8s.aliyun.com/eci-custom-tags|"env:test,name:alice"|La chaîne d'étiquette attachée au pod. Vous pouvez attacher jusqu'à trois étiquettes. Séparez la clé d'étiquette et la valeur d'étiquette par un caractère deux-points demi-chasse, et séparez plusieurs étiquettes par un caractère virgule demi-chasse.

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

create

*Toutes les ressources.

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Content

string

Oui

Le contenu du fichier de configuration.

apiVersion: apps/v1 kind: Deployment metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 selector: matchLabels: app: nginx template: metadata: labels: app: nginx annotations: k8s.aliyun.com/eip-bandwidth: 10 k8s.aliyun.com/eci-with-eip: true spec: containers: - name: nginx image: nginx:1.14.2 ports: - containerPort: 80

RegionId

string

Non

L'identifiant de la région.

cn-hangzhou

Éléments de réponse

Élément

Type

Description

Exemple

object

Schéma de la réponse.

RequestId

string

L'identifiant de la requête.

CC107349-57B7-4405-B1BF-9BF5AF7F****

ScalingGroupId

string

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

asg-bp1igpak5ft1flyp****

Exemples

JSON format

{
  "RequestId": "CC107349-57B7-4405-B1BF-9BF5AF7F****",
  "ScalingGroupId": "asg-bp1igpak5ft1flyp****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.