Présentation des API - Auto Scaling - Centre de documentation Alibaba Cloud

Normes API et SDK multilingues prédéfinis

L'OpenAPI de ce produit (Ess/2014-08-28) utilise le style de signature RPC. Des SDK sont disponibles pour les langages de programmation courants. Les développeurs peuvent télécharger le SDK pour appeler directement l'OpenAPI de ce produit, sans se soucier des détails techniques. Si le SDK existant ne répond pas à vos besoins, utilisez le mécanisme de signature pour une intégration par auto-signature. L'auto-signature étant particulièrement complexe, comptez environ 5 jours ouvrables. Nous vous recommandons donc de rejoindre notre groupe d'assistance DingTalk (147535001692) pour bénéficier d'un accompagnement expert lors de l'intégration.

Avant d'utiliser l'API, préparez votre compte d'identité et votre clé d'accès (AccessKey) afin d'accéder efficacement à l'API via des outils clients (tels que SDK et CLI). Pour plus d'informations, consultez Obtenir un AccessKey.

Scénarios de signature personnalisée

Si votre scénario métier présente des exigences particulières et nécessite une intégration par auto-signature, consultez d'abord notre équipe de support technique (groupe d'assistance DingTalk : 147535001692) pour obtenir un accompagnement professionnel et garantir une intégration efficace.

Préparation du compte et de la sécurité

Les comptes Alibaba Cloud disposent de permissions administratives complètes sur l'ensemble des ressources. En cas de compromission d'un AccessKey, toutes les ressources associées sont exposées à un risque d'accès non autorisé. Pour garantir la sécurité, créez un utilisateur RAM disposant uniquement de permissions d'accès API et configurez son AccessKey. Appliquez ensuite des politiques RAM selon le principe du moindre privilège (PoLP). N'utilisez le compte Alibaba Cloud que dans les scénarios spécifiques où ses permissions sont explicitement requises.

Groupe de mise à l'échelle

API	Titre	Description
CreateScalingGroup	Créer un groupe de mise à l'échelle.	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é.
DeleteScalingGroup	Suppression d'un groupe de mise à l'échelle.	Supprime un groupe de mise à l'échelle.
ModifyScalingGroup	Modifier un groupe de mise à l'échelle.	Si vous devez augmenter ou diminuer automatiquement le nombre d'instances d'un type spécifique en fonction des changements d'activité et des stratégies, vous pouvez configurer un groupe de mise à l'échelle pour ajuster automatiquement votre capacité de calcul (c'est-à-dire le nombre d'instances). Si les attributs actuels du groupe de mise à l'échelle ne répondent plus à vos besoins professionnels, vous pouvez appeler l'opération ModifyScalingGroup pour modifier les attributs du groupe de mise à l'échelle, tels que le nombre maximal d'instances, le nombre minimal d'instances ou le nombre attendu d'instances. Ainsi, vous n'avez pas besoin de créer à nouveau un groupe de mise à l'échelle ni de reconfigurer les attributs associés, ce qui permet d'économiser du temps et des ressources.
EnableScalingGroup	Activer un groupe de mise à l'échelle.	Active un groupe de mise à l'échelle.
DisableScalingGroup	Désactiver un groupe de mise à l'échelle.	Désactive un groupe de mise à l'échelle.
SetGroupDeletionProtection	Activer ou désactiver la protection contre la suppression d'un groupe de mise à l'échelle.	Active ou désactive la protection contre la suppression d'un groupe de mise à l'échelle.
AttachLoadBalancers	Ajout d'une ou plusieurs instances d'équilibreur de charge.	Ajoute une ou plusieurs instances d'équilibreur de charge.
DetachLoadBalancers	Suppression d'une ou plusieurs instances d'équilibreur de charge.	Supprime une ou plusieurs instances d'équilibreur de charge.
DetachDBInstances	Retirer une ou plusieurs instances RDS.	Retire une ou plusieurs instances ApsaraDB RDS.
AttachDBInstances	Ajout d'une ou plusieurs instances ApsaraDB RDS.	Ajoute une ou plusieurs instances ApsaraDB RDS.
AttachVServerGroups	Ajouter des groupes de serveurs virtuels à un groupe de mise à l'échelle.	Ajoute un ou plusieurs groupes de serveurs virtuels à une instance d'équilibrage de charge associée à un groupe de mise à l'échelle.
DetachVServerGroups	Supprimer un ou plusieurs groupes de serveurs virtuels.	Supprime un ou plusieurs groupes de serveurs virtuels.
DescribeScalingGroups	Consultation des groupes de mise à l'échelle.	Consulte les groupes de mise à l'échelle. Vous pouvez appeler cette opération pour afficher les informations de base sur les groupes de mise à l'échelle, les instances des groupes de mise à l'échelle et les configurations de mise à l'échelle.
DescribeScalingInstances	Consultation des instances ECS dans un groupe de mise à l'échelle.	Consulte la liste des instances ECS d'un groupe de mise à l'échelle et les informations sur les instances par identifiant de groupe de mise à l'échelle, y compris le nombre total d'instances spot en cours d'exécution, le nombre total d'instances ECS, l'état de préchauffage des instances ECS et l'état du cycle de vie dans le groupe de mise à l'échelle actuel. Vous pouvez également filtrer les instances ECS par état de contrôle de santé, état du cycle de vie ou type de création.
DescribeScalingActivities	Consultation des activités de mise à l'échelle.	Consulte les détails des activités de mise à l'échelle en appelant l'opération DescribeScalingActivities. Vous pouvez utiliser cette opération pour consulter les résultats des activités de mise à l'échelle déclenchées par des tâches planifiées, des tâches déclenchées par des événements ou l'exécution manuelle de règles de mise à l'échelle. Par exemple, vous pouvez consulter l'état, la cause et le nombre total d'instances après le changement pour une activité de mise à l'échelle.
DescribeScalingActivityDetail	Consultation des détails d'une activité de mise à l'échelle.	Consulte les détails d'une activité de mise à l'échelle.
DescribeLimitation	Consultation des limites de quota de ressources.	Consulte les limites de quota de ressources.
DescribeElasticStrength	Consultation de la force élastique d'un groupe de mise à l'échelle.	La validité de la configuration d'un groupe de mise à l'échelle détermine en grande partie le taux de réussite des opérations de montée en charge. Auto Scaling utilise la force élastique pour décrire la validité des configurations de mise à l'échelle, quantifiant ainsi la qualité de la configuration et vous aidant à optimiser les configurations de mise à l'échelle en conséquence.
VerifyAuthentication	Vérifie si Auto Scaling est autorisé à opérer sur les ressources ECS.	Vérifie si Auto Scaling est autorisé à opérer sur les ressources ECS.
SuspendProcesses	Suspendre les processus de mise à l'échelle spécifiés dans un groupe de mise à l'échelle.	Suspend les processus de mise à l'échelle spécifiés dans un groupe de mise à l'échelle.
ResumeProcesses	Reprise des processus de mise à l'échelle suspendus dans un groupe de mise à l'échelle.	Reprend les processus de mise à l'échelle suspendus dans un groupe de mise à l'échelle.
VerifyUser	Vérification de l'activation d'Auto Scaling.	Vérifie si Auto Scaling est activé.

Configuration de mise à l'échelle

API	Titre	Description
CreateScalingConfiguration	Création d'une configuration de mise à l'échelle.	Crée une configuration de mise à l'échelle de type ECS pour un groupe de mise à l'échelle en appelant l'opération CreateScalingConfiguration avec l'identifiant du groupe de mise à l'échelle, le type d'instance, l'image d'instance et d'autres informations.
DeleteScalingConfiguration	Supprimer une configuration de mise à l'échelle.	Supprime une configuration de mise à l'échelle.
ModifyScalingConfiguration	Modifier une configuration de mise à l'échelle de type ECS.	Modifie une configuration de mise à l'échelle de type ECS (le modèle d'instance ECS pour la montée en charge) si la configuration de mise à l'échelle actuelle ne répond pas à vos exigences métier. Vous pouvez appeler cette opération d'API pour modifier la configuration de mise à l'échelle.
DescribeScalingConfigurations	Consultation des configurations de mise à l'échelle de type ECS.	Consulte les informations relatives aux configurations de mise à l'échelle de type ECS, notamment les types d'instances et les images, afin de vous aider à comprendre à l'avance les détails des modèles d'instances ECS utilisés pour la montée en charge.
DeactivateScalingConfiguration	Désactivation d'une configuration de mise à l'échelle spécifiée.	Désactive une configuration de mise à l'échelle spécifiée.

Règle de mise à l'échelle

API	Titre	Description
CreateScalingRule	Créer une règle de mise à l'échelle.	Crée une règle de mise à l'échelle.
DeleteScalingRule	Supprimer une règle de mise à l'échelle.	Supprime une règle de mise à l'échelle.
ModifyScalingRule	Modification d'une règle de mise à l'échelle.	Modifie une règle de mise à l'échelle.
DescribeScalingRules	Consultation des règles de mise à l'échelle.	Consulte les règles de mise à l'échelle d'un groupe de mise à l'échelle et renvoie des informations sur ces règles.

Tâche déclenchée par un événement

API	Titre	Description
AttachInstances	Ajouter manuellement des instances ECS à un groupe de mise à l'échelle.	Ajoute manuellement des instances ECS à un groupe de mise à l'échelle.
DetachInstances	Retirer une ou plusieurs instances ECS d'un groupe de mise à l'échelle.	Retire une ou plusieurs instances ECS d'un groupe de mise à l'échelle.
ExecuteScalingRule	Exécuter une règle de mise à l'échelle.	Exécute une règle de mise à l'échelle.
RemoveInstances	Suppression d'une ou plusieurs instances ECS d'un groupe de mise à l'échelle.	Supprime une ou plusieurs instances ECS d'un groupe de mise à l'échelle.

Tâche planifiée

API	Titre	Description
CreateScheduledTask	Créer une tâche planifiée.	Crée une tâche planifiée.
DeleteScheduledTask	Suppression d'une tâche planifiée.	Supprime une tâche planifiée.
ModifyScheduledTask	Modifier une tâche planifiée.	Modifie les informations d'une tâche planifiée.
DescribeScheduledTasks	Consultation des informations sur les tâches planifiées.	Consulte les informations sur les tâches planifiées.

Hook de cycle de vie

API	Titre	Description
CreateLifecycleHook	Créer un ou plusieurs hooks de cycle de vie pour un groupe de mise à l'échelle.	Crée un ou plusieurs hooks de cycle de vie pour un groupe de mise à l'échelle.
DeleteLifecycleHook	Supprimer un hook de cycle de vie.	Supprime un hook de cycle de vie.
ModifyLifecycleHook	Modification d'un crochet de cycle de vie.	Modifie les informations d'un crochet de cycle de vie.
DescribeLifecycleActions	Consultation des jetons de cycle de vie.	Consulte les jetons de cycle de vie par identifiant et état d'activité de mise à l'échelle.
DescribeLifecycleHooks	Consultation des détails des hooks de cycle de vie.	Consulte les informations relatives aux hooks de cycle de vie par identifiant de hook de cycle de vie ou identifiant de groupe de mise à l'échelle, y compris l'action par défaut après la fin de l'état d'attente, le type d'activité de mise à l'échelle associé au hook de cycle de vie, l'identifiant de l'objet de notification et le délai d'attente de suspension.
RecordLifecycleActionHeartbeat	Prolongation du temps d'attente après le déclenchement d'un hook de cycle de vie.	Prolonge le temps d'attente d'une instance ECS qui est suspendue après le déclenchement d'un hook de cycle de vie.
CompleteLifecycleAction	Mettre fin de manière anticipée à l'état d'attente d'une activité de mise à l'échelle.	Met fin de manière anticipée à l'état d'attente d'une activité de mise à l'échelle.

Notification d'événement

API	Titre	Description
CreateNotificationConfiguration	Création de notifications pour les événements Auto Scaling et les changements de ressources.	Crée des notifications pour les événements Auto Scaling et les changements de ressources.
DeleteNotificationConfiguration	Suppression d'une notification d'événement de mise à l'échelle automatique et de changement de ressource.	Supprime une notification d'événement de mise à l'échelle automatique et de changement de ressource.
ModifyNotificationConfiguration	Modification d'une notification pour les événements Auto Scaling et les changements de ressources.	Modifie une notification pour les événements Auto Scaling et les changements de ressources.
DescribeNotificationConfigurations	Consultation des événements de mise à l'échelle automatique et des notifications de changement de ressources.	Consulte les événements de mise à l'échelle automatique et les notifications de changement de ressources que vous avez créés.
DescribeNotificationTypes	Types d'événements Auto Scaling et de notifications de changement de ressources.	Consulte les types d'événements Auto Scaling et de notifications de changement de ressources.

Instance

API	Titre	Description
SetInstancesProtection	Activer ou désactiver la protection des instances ECS dans un groupe de mise à l'échelle.	Active ou désactive la protection d'une ou plusieurs instances ECS dans un groupe de mise à l'échelle.
SetInstanceHealth	Définir l'état de santé d'une instance ECS dans un groupe de mise à l'échelle.	Définit l'état de santé d'une instance ECS dans un groupe de mise à l'échelle.
EnterStandby	Mise en état de veille des instances ECS d'un groupe de mise à l'échelle.	Place les instances ECS d'un groupe de mise à l'échelle en état de veille.
ExitStandby	Transition des instances en veille vers l'état en cours d'exécution.	Fait passer les instances ECS en état de veille d'un groupe de mise à l'échelle à l'état en cours d'exécution.
RebalanceInstances	Rééquilibrage de la distribution des instances ECS.	Rééquilibre la distribution des instances ECS entre les zones d'un groupe de mise à l'échelle multizone.

Région

API	Titre	Description
DescribeRegions	Consultation des régions où Auto Scaling est disponible.	Consulte les régions où Auto Scaling est disponible.

Balise

API	Titre	Description
ListTagResources	Consultation des balises associées aux ressources Auto Scaling.	Consulte les balises associées à une ou plusieurs ressources Auto Scaling.
ListTagKeys	Consultation des clés de balise des ressources Auto Scaling.	Consulte la liste des clés de balise des ressources Auto Scaling.
ListTagValues	Consultation des valeurs de balise des ressources Auto Scaling par clé de balise.	Consulte les valeurs de balise correspondant à une clé de balise des ressources Auto Scaling.
TagResources	Créer et associer des balises à une liste de ressources.	Crée et associe des balises à une liste de ressources Auto Scaling spécifiées.
UntagResources	Dissocier des balises des ressources Auto Scaling spécifiées.	Une fois une balise dissociée, celle-ci est automatiquement supprimée si elle n'est associée à aucune autre ressource.

Alerte

API	Titre	Description
CreateAlarm	Créer une tâche déclenchée par événement.	Crée une tâche déclenchée par événement.
DeleteAlarm	Supprimer une tâche déclenchée par événement.	Supprime une tâche déclenchée par événement.
DisableAlarm	Désactivation d'une tâche déclenchée par événement.	Désactive une tâche déclenchée par événement.
EnableAlarm	Activer une tâche déclenchée par événement.	Active une tâche déclenchée par événement.
ModifyAlarm	Modification d'une tâche déclenchée par événement.	Modifie une tâche déclenchée par événement.
DescribeAlarms	Consultation des informations sur les tâches déclenchées par événement.	Consulte les informations sur les tâches déclenchées par événement.

Autre

API	Titre	Description
AttachAlbServerGroups	Ajouter un ou plusieurs groupes de serveurs ALB.	Ajoute un ou plusieurs groupes de serveurs Application Load Balancer (ALB) à un groupe de mise à l'échelle.
CreateEciScalingConfiguration	Créer une configuration de mise à l'échelle.	Crée une configuration de mise à l'échelle de type Elastic Container Instance (ECI).
DeleteEciScalingConfiguration	Suppression d'une configuration de mise à l'échelle.	Supprime une configuration de mise à l'échelle de type Elastic Container Instance (ECI).
DescribeEciScalingConfigurations	Consultation des informations de configuration de mise à l'échelle.	Consulte les configurations de mise à l'échelle de type ECI.
DetachAlbServerGroups	Supprimer un ou plusieurs groupes de serveurs ALB.	Supprime un ou plusieurs groupes de serveurs Application Load Balancer (ALB) d'un groupe de mise à l'échelle.
ModifyEciScalingConfiguration	Modifier une configuration de mise à l'échelle.	Modifie une configuration de mise à l'échelle de type Elastic Container Instance (ECI).
ScaleWithAdjustment	Déclencher la mise à l'échelle élastique en fonction d'une règle d'ajustement spécifiée.	Déclenche la mise à l'échelle élastique en fonction d'une règle d'ajustement spécifiée.
ChangeResourceGroup	Modifier le groupe de ressources d'un groupe de mise à l'échelle.	Ajoute un groupe de mise à l'échelle en tant que ressource à un groupe de ressources.
AttachServerGroups	Ajouter un ou plusieurs groupes de serveurs d'équilibreur de charge.	Ajoute un ou plusieurs groupes de serveurs d'équilibreur de charge à un groupe de mise à l'échelle. Les types de groupes de serveurs pris en charge incluent l'Application Load Balancer (ALB) et le Network Load Balancer (NLB).
DetachServerGroups	Retirer un ou plusieurs groupes de serveurs d'équilibreur de charge.	Retire un ou plusieurs groupes de serveurs d'équilibreur de charge d'un groupe de mise à l'échelle. Les types de groupes de serveurs pris en charge incluent l'Application Load Balancer (ALB) et le Network Load Balancer (NLB).
ModifyInstanceAttribute	Modification partielle des informations d'une instance ECS dans un groupe de mise à l'échelle.	Modifie une partie des informations d'une instance ECS dans un groupe de mise à l'échelle en appelant l'API ModifyInstanceAttribute. Actuellement, seule la propriété de gestion du cycle de vie des instances ajoutées manuellement à un groupe de mise à l'échelle peut être modifiée, ce qui permet à Auto Scaling de gérer les instances ECS du groupe de mise à l'échelle de manière plus flexible.
DescribePatternTypes	Recherche des types d'instance par attributs d'instance.	Consulte les types d'instance correspondant aux attributs d'instance spécifiés, tels que le nombre de vCPU, la taille de la mémoire, le niveau de la famille d'instances et le prix maximum acceptable, lors de la définition d'une configuration de mise à l'échelle en spécifiant des attributs d'instance. Cette opération appelle l'API DescribePatternTypes.
ApplyScalingGroup	Gérer les groupes de mise à l'échelle à l'aide d'un fichier de configuration.	Crée et gère des groupes de mise à l'échelle basés sur Elastic Container Instance (ECI) à l'aide d'un fichier de configuration. Vous pouvez appeler l'opération ApplyScalingGroup pour implémenter cette fonctionnalité.
ModifyAlertConfiguration	Configuration des états des activités de mise à l'échelle pour les notifications par message dans un groupe de mise à l'échelle.	Configure les états des activités de mise à l'échelle pour lesquels Auto Scaling envoie des notifications par SMS et par e-mail au sein d'un groupe de mise à l'échelle. Lorsqu'une activité de mise à l'échelle réussit, échoue ou est rejetée, Auto Scaling peut envoyer des notifications par SMS ou par e-mail. Vous devez traiter les événements associés après avoir reçu les notifications. Vous pouvez appeler l'opération ModifyAlertConfiguration pour définir les états des activités de mise à l'échelle qui déclenchent les notifications par SMS et par e-mail dans un groupe de mise à l'échelle, afin de rester informé des changements d'activités de mise à l'échelle et de réagir rapidement pour améliorer l'efficacité de la mise à l'échelle.
DescribeAlertConfiguration	État des activités de mise à l'échelle pour les notifications dans un groupe de mise à l'échelle.	Lorsqu'une activité de mise à l'échelle réussit, échoue ou est rejetée, Auto Scaling peut envoyer des notifications par SMS et par e-mail. Vous devez traiter les événements associés après la réception des notifications. Vous pouvez appeler l'opération DescribeAlertConfiguration pour interroger l'état des activités de mise à l'échelle pour lesquelles des notifications par SMS et par e-mail sont envoyées dans un groupe de mise à l'échelle. Cela vous permet de rester informé des changements liés aux activités de mise à l'échelle et de réagir rapidement pour améliorer l'efficacité de la mise à l'échelle.
SuspendInstanceRefresh	Suspension d'une tâche d'actualisation d'instance.	Suspend une tâche d'actualisation d'instance. Pendant l'exécution d'une tâche d'actualisation d'instance, si vous soupçonnez que la configuration présente des problèmes sans être certain qu'un retour en arrière soit nécessaire, vous pouvez appeler cette opération pour suspendre la tâche d'actualisation d'instance. Pendant la suspension, vous pouvez vérifier si la configuration est correcte.
ResumeInstanceRefresh	Reprendre une tâche de rafraîchissement d'instances suspendue.	Reprend une tâche de rafraîchissement d'instances à l'état suspendu.
CancelInstanceRefresh	Annuler une tâche de rafraîchissement d'instances.	Annule une tâche de rafraîchissement d'instances. Les instances qui ont déjà été remplacées ou ajoutées lors de l'extension sont conservées.
DescribeInstanceRefreshes	Consultation des tâches d'actualisation des instances.	Consulte les tâches d'actualisation des instances d'un groupe de mise à l'échelle, y compris les informations de base et la progression des tâches.
RollbackInstanceRefresh	Annulation d'une tâche de rafraîchissement d'instances.	Annule une tâche de rafraîchissement d'instances en cours d'exécution. Si la configuration souhaitée ne répond plus à vos exigences pendant une tâche de rafraîchissement d'instances, appelez cette opération pour annuler la tâche. Lors de l'annulation, le système crée de nouvelles instances basées sur la configuration actuellement active du groupe de mise à l'échelle afin de remplacer les instances créées selon la configuration souhaitée.
StartInstanceRefresh	Démarrer une tâche d'actualisation des instances.	Actualise les instances d'un groupe de mise à l'échelle lorsque vous devez appliquer une nouvelle configuration de mise à l'échelle ou mettre à jour l'image des instances du groupe de mise à l'échelle.