Auto Scaling:Use the Alibaba Cloud CLI to call Auto Scaling OpenAPI operations

Pré-requisitos

Antes de começar, verifique se você tem:

• Uma conta Alibaba Cloud

• Um usuário RAM com as permissões necessárias (criado na Etapa 2)

Etapa 1: Instale a CLI do Alibaba Cloud

Escolha uma das opções a seguir:

Opção A: Usar o Cloud Shell (sem instalação)

O Cloud Shell já vem com a CLI do Alibaba Cloud pré-instalada e configurada automaticamente com suas credenciais de identidade. Use o Cloud Shell para executar comandos da CLI imediatamente ou testá-los antes da execução local.

Para mais informações, consulte O que é o Cloud Shell?

Opção B: Instalação local

Instale a CLI do Alibaba Cloud em sua máquina local. Selecione o guia correspondente ao seu sistema operacional:

• Windows

• Linux

• macOS

Etapa 2: Configure a CLI do Alibaba Cloud

Configure suas credenciais e região antes de fazer chamadas à API. A CLI do Alibaba Cloud suporta vários tipos de credenciais. Os passos abaixo utilizam credenciais AccessKey com um usuário RAM, a abordagem mais comum para automação.

1. Crie um usuário RAM e gere um par de AccessKey. Consulte Criar um usuário RAM e Criar um par de AccessKey.

2. Anexe a política AliyunESSReadOnlyAccess ao usuário RAM para conceder acesso somente leitura ao Auto Scaling. Consulte Conceder permissões a um usuário RAM.

3. Identifique o ID da região dos seus recursos do Auto Scaling. Consulte Endpoints para obter a lista de regiões suportadas.

   Nota

   Use a opção --region para especificar uma região por comando. Essa opção substitui a configuração padrão de credenciais e as definições de variáveis de ambiente. Consulte Opções de linha de comando para chamadas de API.

4. Configure um perfil de credencial AccessKey chamado AkProfile com o par de AccessKey do usuário RAM. Consulte Exemplos de configuração.

Para outros tipos de credenciais, como credenciais temporárias STS, consulte Tipos de credenciais.

Etapa 3: Gerar um comando da CLI

O OpenAPI Explorer gera comandos da CLI prontos para execução para qualquer operação da API do Auto Scaling.

1. Abra a página DescribeScalingActivities no OpenAPI Explorer.

   

2. Na aba Parameters, preencha os parâmetros. Em seguida, clique em CLI Example para visualizar o comando gerado.

3. Copie ou execute o comando:

   • Clique em para copiar o comando para a área de transferência. Cole-o no shell local para executá-lo ou adicione-o a um script de automação.

   • Clique em para abrir o Cloud Shell e executar o comando diretamente no navegador.

   Nota

   Ao executar o comando localmente, verifique se os valores dos parâmetros correspondem aos formatos esperados pela CLI do Alibaba Cloud. Consulte Formatos de parâmetros. Por padrão, o OpenAPI Explorer inclui --region no comando gerado. Mantenha ou remova essa opção conforme sua configuração.

Etapa 4: Chamar a API do Auto Scaling

O exemplo a seguir chama DescribeScalingActivities para recuperar detalhes de uma atividade de dimensionamento. Consulte DescribeScalingActivities para obter a referência completa de parâmetros.

Execute o comando:

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

Uma resposta bem-sucedida tem o seguinte formato:

{
  "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*****"
    }
  ]
}

Se a resposta retornar um erro, verifique se os parâmetros de entrada e os valores correspondem à descrição do código de erro. Para diagnósticos de autoatendimento usando o ID da solicitação ou informações de erro, consulte Diagnóstico de problemas da OpenAPI.

Próximos passos

• Consulte todas as operações disponíveis da API do Auto Scaling: Lista de operações por função

• Saiba mais sobre os recursos da CLI do Alibaba Cloud: O que é a CLI do Alibaba Cloud?