Elastic Compute Service:CLI reference

Use o cli do alibaba cloud

instale e configure o alibaba cloud cli

Use o alibaba cloud cli para invocar operações da API do ECS

Após instale e configure o alibaba cloud cli, execute comandos no seguinte formato para invocar 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 descreve como usar o alibaba cloud cli para invocar operações da API do ECS.

crie uma instância do ECS

O exemplo a seguir descreve como crie uma instância ECS de assinatura a partir de uma imagem do alibaba cloud Linux na região China (Hangzhou) com o alibaba cloud cli.

1. Prepare o ambiente.

   Antes de crie 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ócios, pule esta etapa.

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

      Neste exemplo, você cria uma VPC na região China (Hangzhou) e a associa 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 do comando de exemplo

        {
          "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 crie um vSwitch na VPC.

      Neste exemplo, você cria um vSwitch na VPC cujo id é vpc-bp1d9v4763ym2hlzt e o associa 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 do comando de exemplo

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

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

      • Comando de exemplo

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

      • Saída do comando de exemplo

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

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

      Neste exemplo, você adiciona uma regra de grupo de segurança de entrada que permite tráfego TCP na porta 22 ao grupo de segurança cujo 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 do comando de exemplo

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

2. crie uma instância do ECS.

   Chame a operação **RunInstances** para crie uma instância ECS de assinatura.

   1. Cenário de exemplo

      Parâmetro	Descrição e exemplo
      RegionId	O id da região onde você deseja crie a instância do ECS. Exemplo: cn-hangzhou.
      ImageId	O id da imagem. Recomendamos selecione a imagem do alibaba cloud Linux cujo id é aliyun_3_x64_20G_alibase_20240528.vhd.
      InstanceType	O tipo de instância. Exemplos: Para aplicações pessoais, recomendamos selecione o tipo de instância ecs.e-c1m1.large, que possui 2 vCPUs e 2 GiB de memória. Para aplicações de pequenas e médias empresas, recomendamos selecione o tipo de instância ecs.c7.large, que possui 2 vCPUs e 4 GiB de memória.
      SecurityGroupId	O id do grupo de segurança. Obtenha o valor na resposta da operação CreateSecurityGroup. Exemplo: sg-bp18z2q1jg4gq95t****.
      VSwitchId	O id do vSwitch. Obtenha o valor na resposta da operação CreateVSwitch. Exemplo: vsw-bp11hf5r945gewysp****.
      InstanceName	O nome da instância do ECS. Exemplo: ecs_cli_demo.
      InstanceChargeType	O método de faturamento da instância do ECS. Para crie uma instância ECS de assinatura, defina o valor como PrePaid. Nota Certifique-se de que o saldo da sua conta seja suficiente.
      PeriodUnit	A unidade da duração da assinatura. Exemplo: Month.
      Period	A duração da assinatura. Exemplo: 1.
      InternetMaxBandwidthOut	A largura de banda pública máxima de saída. Exemplo: 1.
      Password	A 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	A categoria do disco do sistema. Exemplo: cloud_essd.
      SystemDisk.Size	O 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 do comando de exemplo

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

Conecte-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 o endereço IP público da instância. 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 do comando de exemplo

     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>

   

Inicie uma instância do ECS

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

• Cenário de exemplo: Inicie uma instância do ECS cujo id é i-bp1aq39j2yul5y01**** na região China (Hangzhou) (cn-hangzhou) após uma simulação (dry run) e não execute a solução de problemas durante a inicialização da instância.

• Comando de exemplo

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

• Saída do comando de exemplo

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

Consulte os detalhes das instâncias do ECS

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

crie um snapshot

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

• Cenário de exemplo: crie um snapshot para um Enterprise SSD (ESSD) cujo 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 do comando de exemplo

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

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

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

• Cenário de exemplo

  Parâmetro	Descrição e exemplo
  InstanceId	O id da instância do ECS. Exemplo: i-bp1aq39j2yul5y01****.
  Platform	A distribuição do sistema operacional do disco do sistema na imagem personalizada. Exemplo: Aliyun, que indica o alibaba cloud Linux.
  RegionId	O id da região onde você criará a imagem personalizada. Exemplo: cn-hangzhou.

• Comando de exemplo

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

• Saída do comando de exemplo

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

Pare uma instância do ECS

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

• Cenário de exemplo: Pare uma instância do ECS cujo 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 do comando de exemplo

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

Referências

Este tópico descreve operações específicas da API. Para mais informações sobre outras operações da API, consulte API overview.

No alibaba cloud cli, é possível especifique opções de linha de comando para alterar o comportamento dos comandos ou implementar recursos estendidos com base nas suas necessidades de negócios. Para mais informações, consulte Command-line options.