Utiliser Alibaba Cloud CLI pour gérer Auto Scaling - Auto Scaling

Cette rubrique explique comment utiliser Alibaba Cloud CLI pour appeler l'OpenAPI Auto Scaling. Nous utilisons l'opération DescribeScalingActivities du service Auto Scaling (ESS) comme exemple pour interroger les détails d'une activité de mise à l'échelle spécifique.

Concepts

Alibaba Cloud CLI (Alibaba Cloud Command Line Interface) est un outil en ligne de commande polyvalent basé sur OpenAPI. Utilisez Alibaba Cloud CLI pour automatiser la gestion du service Auto Scaling. Pour plus d'informations, consultez la rubrique Qu'est-ce qu'Alibaba Cloud CLI ?.

Étape 1 : Installer Alibaba Cloud CLI

Installez Alibaba Cloud CLI avant de l'utiliser. Des programmes d'installation sont disponibles pour Windows, Linux et macOS. Sélectionnez la méthode d'installation adaptée à votre système d'exploitation. Pour plus d'informations, consultez la rubrique Installer, mettre à jour et désinstaller Alibaba Cloud CLI.

Le service Cloud Shell intègre Alibaba Cloud CLI et configure automatiquement vos identifiants, ce qui élimine toute configuration manuelle. Déboguez les commandes Alibaba Cloud CLI directement dans Cloud Shell. Pour plus d'informations, consultez la rubrique Qu'est-ce que Cloud Shell ?.

Étape 2 : Configurer Alibaba Cloud CLI

Important

Un compte Alibaba Cloud dispose de toutes les autorisations sur les OpenAPI de tous les services, ce qui présente un risque de sécurité élevé. Nous vous recommandons vivement de créer un utilisateur RAM, d'accorder des autorisations selon le principe du moindre privilège et d'utiliser cet utilisateur RAM pour accéder aux OpenAPI. Pour connaître les politiques prises en charge par le service Auto Scaling, consultez les rubriques Politiques système pour Auto Scaling et Politiques personnalisées pour Auto Scaling.

Avant d'utiliser Alibaba Cloud CLI, configurez vos identifiants et l'ID de région. Alibaba Cloud CLI prend en charge plusieurs types d'identifiants. Pour plus d'informations, consultez la rubrique Types d'identifiants. Les étapes suivantes décrivent la configuration d'identifiants de type AK à l'aide de l'AccessKey d'un utilisateur RAM :

Créez un utilisateur RAM et une AccessKey. Pour plus d'informations, consultez les rubriques Créer un utilisateur RAM et Créer une paire de clés AccessKey.
Accordez des autorisations à l'utilisateur RAM. Cet exemple nécessite l'octroi d'autorisations en lecture seule pour le service Auto Scaling via la politique AliyunESSReadOnlyAccess. Pour plus d'informations, consultez la rubrique Accorder des autorisations à un utilisateur RAM.
Obtenez un ID de région disponible pour la configuration des identifiants. Alibaba Cloud CLI utilise la région que vous spécifiez pour initier les appels OpenAPI. Pour la liste des régions où le service Auto Scaling est disponible, consultez la rubrique Points de terminaison.

Remarque
Lorsque vous utilisez Alibaba Cloud CLI, spécifiez la région d'une commande à l'aide de l'option de ligne de commande --region. Cette option remplace les paramètres de région définis dans votre profil d'identifiants par défaut et dans les variables d'environnement. Pour plus d'informations, consultez la rubrique Options de ligne de commande.
Utilisez l'AccessKey de l'utilisateur RAM pour configurer un profil d'identifiants de type AK et nommez-le AkProfile. Pour plus d'informations, consultez la rubrique Exemples de configuration.

Étape 3 : Générer un exemple de commande CLI

Dans OpenAPI Explorer, accédez à la page de débogage de l'opération DescribeScalingActivities.
Sous l'onglet Parameter Configuration, saisissez les paramètres de requête. Cliquez sur l'onglet CLI Example pour afficher l'exemple de commande CLI généré.
Copiez l'exemple de commande CLI ou exécutez-le dans Cloud Shell :
- Cliquez sur le bouton Run Command pour ouvrir Cloud Shell et déboguer rapidement la commande.
- Cliquez sur le bouton Copy pour copier l'exemple de commande CLI dans le presse-papiers. Collez-le ensuite dans votre outil shell local pour l'exécuter ou l'utiliser pour modifier un script d'automatisation.
Remarque
Si vous copiez l'exemple de commande CLI dans un outil shell local pour le débogage, assurez-vous que le format des paramètres est correct. Pour plus d'informations sur les formats de paramètres des commandes Alibaba Cloud CLI, consultez la rubrique Formats de paramètres.

Par défaut, OpenAPI Explorer ajoute l'option --region à l'exemple généré. Lorsque vous copiez la commande et l'exécutez localement, Alibaba Cloud CLI utilise la région spécifiée dans cette option et ignore la région définie dans votre profil d'identifiants par défaut et les variables d'environnement. Supprimez ou conservez cette option selon vos besoins.

Étape 4 : Appeler l'OpenAPI Auto Scaling****

Remarque

Alibaba Cloud CLI inclut une ancienne version de l'OpenAPI Auto Scaling. Nous vous recommandons d'utiliser les options --force et --version pour garantir l'appel de la version 2022-02-22 de l'OpenAPI Auto Scaling. Pour plus d'informations, consultez la rubrique Forcer l'appel d'une opération API.
Lorsqu'OpenAPI Explorer génère un exemple de commande pour la version 2022-02-22 de l'OpenAPI Auto Scaling, il ajoute automatiquement les options --force et --version. Vous n'avez pas besoin de les ajouter manuellement.
Pour plus d'informations sur les opérations API disponibles, consultez la rubrique Liste des opérations par fonction.

L'exemple suivant montre comment utiliser Alibaba Cloud CLI pour appeler l'opération DescribeScalingActivities du service Auto Scaling afin d'afficher les détails d'une activité de mise à l'échelle spécifique. Pour plus d'informations sur cette opération, consultez la rubrique DescribeScalingActivities.

Exécutez la commande.

aliyun ess DescribeScalingActivities --RegionId 'cn-hangzhou' --ScalingGroupId 'asg-bp18p2yfxow2dloq****' --version 2022-02-22 --method POST --force

Le résultat suivant s'affiche.

{
  "RequestId": "CC107349-57B7-4405-B1BF-9BF5AF7F****",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "ScalingActivities": [
    {
      "Progress": 100,
      "ScalingInstanceNumber": 1,
      "AttachedCapacity": "0",
      "TotalCapacity": "2",
      "ScalingGroupId": "asg-bp18p2yfxow2dloq****",
      "AutoCreatedCapacity": "2",
      "EndTime": "2020-09-10T09:54Z",
      "StartTime": "2020-09-10T09:54Z",
      "Description": "Add \\\"1\\\" ECS instance",
      "StatusCode": "Successful",
      "Cause": "A user requests to execute scaling rule \\\"asr-bp12tcnol686y1ik****\\\", changing the Total Capacity from \\\"1\\\" to \\\"2\\\".",
      "ScalingActivityId": "asa-bp161xudmuxdzofe****",
      "StatusMessage": "\\\"1\\\" ECS instances are added",
      "CreatedCapacity": 1,
      "DestroyedCapacity": 1,
      "StartedCapacity": 1,
      "StoppedCapacity": 1,
      "CreatedInstances": [
        "[\"i-abc1\",\"i-abc2\"]"
      ],
      "DestroyedInstances": [
        "[\n      \"i-abc1\",\n      \"i-abc2\"\n]"
      ],
      "StartedInstances": [
        "[\n      \"i-abc1\",\n      \"i-abc2\"\n]"
      ],
      "StoppedInstances": [
        "[\n      \"i-abc1\",\n      \"i-abc2\"\n]"
      ],
      "ErrorCode": "OperationDenied.NoStock",
      "ErrorMessage": "The specified ECS resource is out of stock in this region. Please try again later.",
      "Detail": "\"new ECS instances \"i-j6c8ilerw, i-j6c8iler4mx\" are created.\"",
      "TriggerSourceType": "Api",
      "TriggerSourceId": "2346366580*****",
      "LifecycleHookContext": {
        "DisableLifecycleHook": false,
        "IgnoredLifecycleHookIds": [
          "ash-bp14zolna43z266bq***\n"
        ]
      },
      "ActivityMetadata": "{\\\"goatscaler.io/managed\\\":\\\"true\\\"}",
      "InstanceRefreshTaskId": "ir-asdf12adsxg*****"
    }
  ]
}

Remarque

Si une erreur se produit lors de l'appel à une OpenAPI Auto Scaling, vérifiez vos paramètres de requête et leurs valeurs en fonction du code d'erreur renvoyé.

Enregistrez le RequestID ou le message d'erreur SDK issu de la réponse et utilisez l'outil OpenAPI Troubleshoot pour diagnostiquer le problème.