Elastic Compute Service:CLI reference

Usar a CLI do Alibaba Cloud

Instalar e configurar a Alibaba Cloud CLI

Usar a Alibaba Cloud CLI para chamar operações da API do ECS

Após instalar e configurar a Alibaba Cloud CLI, execute comandos no seguinte formato para chamar operações da API do ECS:

aliyun ecs <API operation name> --<Parameter 1 Value 1> --<Parameter 2 Value 2> ...

Exemplos de uso

O exemplo a seguir demonstra como usar a Alibaba Cloud CLI para chamar operações da API do ECS.

Criar uma instância do ECS

Este exemplo mostra como criar uma instância do ECS por assinatura a partir de uma imagem do Alibaba Cloud Linux na região China (Hangzhou) usando a Alibaba Cloud CLI.

1. Prepare o ambiente.

   Antes de criar uma instância do ECS, crie uma Virtual Private Cloud (VPC), um vSwitch e um grupo de segurança, e obtenha os IDs desses recursos.

   Nota

   Se você já criou os recursos mencionados e eles atendem aos seus requisitos de negócio, pule esta etapa.

   1. Chame a operação **CreateVpc** para criar uma VPC.

      Neste exemplo, uma VPC é criada na região China (Hangzhou) e associada ao bloco CIDR 192.168.0.0/16.

      • Comando de exemplo

        aliyun vpc CreateVpc \
        --RegionId cn-hangzhou \
        --CidrBlock 192.168.0.0/16 

      • Saída de exemplo do comando

        {
          "RequestId": "EC94C73B-8103-4B86-B353-E65C7C9E****",
          "ResourceGroupId": "rg-acfmzw2jz2z****",
          "RouteTableId": "vtb-bp1jxpr9ji5wcn4yv****",
          "VRouterId": "vrt-bp1dyxemup2q4ouga****",
          "VpcId": "vpc-bp1d9v4763ym2hlzt****"
        }

   2. Chame a operação **CreateVSwitch** para criar um vSwitch na VPC.

      Neste exemplo, um vSwitch é criado na VPC com ID vpc-bp1d9v4763ym2hlzt e associado ao bloco CIDR 192.168.0.0/24.

      • Comando de exemplo

        aliyun vpc CreateVSwitch \
        --CidrBlock 192.168.0.0/24 \
        --VpcId vpc-bp1d9v4763ym2hlzt**** \
        --ZoneId=cn-hangzhou-i

      • Saída de exemplo do comando

        {
                "RequestId": "AF1787C4-0D81-44F0-A324-D5C54EA0****",
                "VSwitchId": "vsw-bp11hf5r945gewysp****"
        }

   3. Chame a operação **CreateSecurityGroup** para criar um grupo de segurança na VPC.

      • Comando de exemplo

        aliyun ecs CreateSecurityGroup \
        --RegionId cn-hangzhou \
        --VpcId vpc-bp1d9v4763ym2hlzt****

      • Saída de exemplo do comando

        {
                "RequestId": "B1C25C34-9B84-49E3-9E50-FB7D7970****",
                "SecurityGroupId": "sg-bp18z2q1jg4gq95t****"
        }

   4. Chame a operação **AuthorizeSecurityGroup** para criar uma regra de grupo de segurança.

      Neste exemplo, uma regra de entrada que permite tráfego TCP na porta 22 é adicionada ao grupo de segurança com ID sg-bp18z2q1jg4gq95t****.

      • Comando de exemplo

        aliyun ecs AuthorizeSecurityGroup \
        --RegionId cn-hangzhou \
        --SecurityGroupId sg-bp18z2q1jg4gq95t**** \
        --IpProtocol tcp \
        --SourceCidrIp 0.0.0.0/0 \
        --PortRange 22/22

      • Saída de exemplo do comando

        {
         "RequestId": "FA8B1E61-C9C9-4D91-9628-64B8E2F4****"
        }

2. Crie uma instância do ECS.

   Chame a operação **RunInstances** para criar uma instância do ECS por assinatura.

   1. Cenário de exemplo

      Parâmetro	Descrição e exemplo
      RegionId	ID da região onde a instância do ECS será criada. Exemplo: cn-hangzhou.
      ImageId	ID da imagem. Recomendamos selecionar a imagem do Alibaba Cloud Linux com ID aliyun_3_x64_20G_alibase_20240528.vhd.
      InstanceType	Tipo da instância. Exemplos: Para aplicações pessoais, recomendamos o tipo ecs.e-c1m1.large, com 2 vCPUs e 2 GiB de memória. Para aplicações de pequenas e médias empresas, indicamos o tipo ecs.c7.large, com 2 vCPUs e 4 GiB de memória.
      SecurityGroupId	ID do grupo de segurança. Obtenha este valor na resposta da operação CreateSecurityGroup. Exemplo: sg-bp18z2q1jg4gq95t****.
      VSwitchId	ID do vSwitch. Obtenha este valor na resposta da operação CreateVSwitch. Exemplo: vsw-bp11hf5r945gewysp****.
      InstanceName	Nome da instância do ECS. Exemplo: ecs_cli_demo.
      InstanceChargeType	Método de faturamento da instância do ECS. Para criar uma instância por assinatura, defina o valor como PrePaid. Nota Certifique-se de que o saldo da sua conta seja suficiente.
      PeriodUnit	Unidade da duração da assinatura. Exemplo: Month.
      Period	Duração da assinatura. Exemplo: 1.
      InternetMaxBandwidthOut	Largura de banda pública de saída máxima. Exemplo: 1.
      Password	Senha de login da instância do ECS. Exemplo: <yourPassword>. Nota Para garantir a segurança da instância, especifique uma senha complexa.
      SystemDisk.Category	Categoria do disco do sistema. Exemplo: cloud_essd.
      SystemDisk.Size	Tamanho do disco do sistema. Exemplo: 40.

   2. Comando de exemplo

      aliyun ecs RunInstances \
      --RegionId cn-hangzhou \
      --ImageId aliyun_3_x64_20G_alibase_20240528.vhd \
      --InstanceType ecs.c7.large \
      --SecurityGroupId sg-bp18z2q1jg4gq95t**** \
      --VSwitchId vsw-bp11hf5r945gewys**** \
      --InstanceName ecs_cli_demo \
      --InstanceChargeType PrePaid \
      --PeriodUnit Month \
      --Period 1 \
      --InternetMaxBandwidthOut 1 \
      --Password <yourPassword>  \
      --SystemDisk.Category cloud_essd \
      --SystemDisk.Size 40

   3. Saída de exemplo do comando

      { 
              "InstanceIdSets": {
                      "InstanceIdSet": [
                              "i-bp1de173dp87k5uv****"
                      ]
              },
              "OrderId": 23577729747****,
              "RequestId": "B0855F1A-279F-5153-BAA9-C245E073****",
              "TradePrice": ****
      }

Conectar-se a uma instância do ECS

1. Obtenha o endereço IP público de uma instância do ECS.

   Chame a operação DescribeInstances com o ID de uma instância do ECS para consultar seu endereço IP público. Neste exemplo, o ID da instância do ECS é i-bp1ducce5hs1jm98****.

   • Comando de exemplo

     aliyun ecs DescribeInstances \
     --RegionId cn-hangzhou \
     --InstanceIds '["i-bp1ducce5hs1jm98****"]'

   • Saída de exemplo do comando

     O parâmetro PublicIpAddresses indica o endereço IP público da instância do ECS.

     

2. Conecte-se à instância do ECS.

   ssh <Username>@<Public IP address>

   

Iniciar uma instância do ECS

Chame a operação StartInstance para iniciar uma instância do ECS.

• Cenário de exemplo: Iniciar uma instância do ECS com ID i-bp1aq39j2yul5y01**** na região China (Hangzhou) (cn-hangzhou) após uma simulação (dry run), sem realizar solução de problemas durante a inicialização.

• Comando de exemplo

  aliyun ecs StartInstance \
  --RegionId cn-hangzhou \
  --InstanceId i-bp1aq39j2yul5y01**** \
  --InitLocalDisk false \
  --DryRun false

• Saída de exemplo do comando

  {
   "RequestId": "2DD09CBD-1F4D-4923-94C7-F3BD67137BBE"
  }

Consultar detalhes de instâncias do ECS

Chame a operação DescribeInstances para consultar os detalhes de uma ou mais instâncias do ECS.

Criar um snapshot

Chame a operação CreateSnapshot para criar um snapshot de um disco.

• Cenário de exemplo: Criar um snapshot para um Enterprise SSD (ESSD) com ID d-bp14bjlwo3t3owin****. Defina o nome do snapshot como demoname, a descrição como demo e o período de retenção como três dias.

• Comando de exemplo

  aliyun ecs CreateSnapshot \
  --DiskId d-bp14bjlwo3t3owin**** \
  --SnapshotName demoname \
  --Description demo \
  --RetentionDays 3

• Saída de exemplo do comando

  {
   "RequestId": "DFB0B01F-420D-4932-911E-7328920C2012",
   "SnapshotId": "s-bp1eyr9nxxoo9icj****"
  }

Criar uma imagem personalizada a partir de uma instância do ECS

Chame a operação CreateImage para criar uma imagem personalizada a partir de uma instância do ECS.

• Cenário de exemplo

  Parâmetro	Descrição e exemplo
  InstanceId	ID da instância do ECS. Exemplo: i-bp1aq39j2yul5y01****.
  Platform	Distribuição do sistema operacional para o disco do sistema na imagem personalizada. Exemplo: Aliyun, que indica Alibaba Cloud Linux.
  RegionId	ID da região onde a imagem personalizada será criada. Exemplo: cn-hangzhou.

• Comando de exemplo

  aliyun ecs CreateImage \
  --RegionId cn-hangzhou \
  --InstanceId i-bp1aq39j2yul5y01**** \
  --ImageName demoimage \
  --Description demoimage \
  --Platform Aliyun

• Saída de exemplo do comando

  {
   "ImageId": "m-bp1503ydxxrppctb****",
   "RequestId": "011AE447-20CE-4043-81AC-7AF2BBC4****"
  }

Parar uma instância do ECS

Chame a operação StopInstance com o parâmetro ForceStop definido como false e StoppedMode como KeepCharging para parar uma instância do ECS no estado Running (Running) após uma simulação (dry run). A instância do ECS é parada no modo padrão e o faturamento continua.

• Cenário de exemplo: Parar uma instância do ECS com ID i-bp1aq39j2yul5y01**** na região China (Hangzhou) (cn-hangzhou).

• Comando de exemplo

  aliyun ecs StopInstance \
  --RegionId cn-hangzhou \
  --InstanceId i-bp1aq39j2yul5y01**** \
  --ForceStop false \
  --StoppedMode KeepCharging \
  --DryRun false

• Saída de exemplo do comando

  {
      "RequestId": "121B5745-4983-57B1-BC97-C3A3536E****"
  }

Referências

Este tópico descreve operações específicas da API. Para informações sobre outras operações, consulte a Lista de operações por função.

Na Alibaba Cloud CLI, você pode especificar opções de linha de comando para alterar o comportamento dos comandos ou implementar recursos estendidos conforme suas necessidades de negócio. Para obter mais informações, consulte Opções de linha de comando.