Elastic Compute Service:CLI reference

Uso de Alibaba Cloud CLI

Instalación y configuración de Alibaba Cloud CLI

Invocación de operaciones de API de ECS con Alibaba Cloud CLI

Una vez que instale y configure Alibaba Cloud CLI, ejecute comandos con el siguiente formato para invocar las operaciones de API de ECS:

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

Ejemplos de uso

A continuación se describe cómo usar Alibaba Cloud CLI para invocar operaciones de API de ECS.

Creación de una instancia de ECS

En el siguiente ejemplo se muestra cómo crear una instancia de ECS de suscripción a partir de una imagen de Alibaba Cloud Linux en la región China (Hangzhou) mediante Alibaba Cloud CLI.

1. Prepare los recursos necesarios.

   Antes de crear una instancia de ECS, cree una red privada virtual (VPC), un vSwitch y un security group; luego obtenga los identificadores de estos recursos.

   Nota

   Si ya creó estos recursos y cumplen con los requisitos de su negocio, omita este paso.

   1. Invoque la operación **CreateVpc** para crear una VPC.

      En este ejemplo se crea una VPC en la región China (Hangzhou) y se asocia con el bloque CIDR 192.168.0.0/16.

      • Comando de ejemplo

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

      • Salida de ejemplo del comando

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

   2. Invoque la operación **CreateVSwitch** para crear un vSwitch en la VPC.

      En este ejemplo se crea un vSwitch en la VPC cuyo identificador es vpc-bp1d9v4763ym2hlzt y se asocia con el bloque CIDR 192.168.0.0/24.

      • Comando de ejemplo

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

      • Salida de ejemplo del comando

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

   3. Invoque la operación **CreateSecurityGroup** para crear un security group en la VPC.

      • Comando de ejemplo

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

      • Salida de ejemplo del comando

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

   4. Invoque la operación **AuthorizeSecurityGroup** para crear una regla de security group.

      En este ejemplo se agrega una regla de entrada al security group con identificador sg-bp18z2q1jg4gq95t**** que permite el tráfico TCP en el puerto 22.

      • Comando de ejemplo

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

      • Salida de ejemplo del comando

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

2. Cree la instancia de ECS.

   Invoque la operación **RunInstances** para crear una instancia de ECS de suscripción.

   1. Escenario de ejemplo

      Parámetro	Descripción y ejemplo
      RegionId	Identificador de la región donde desea crear la instancia de ECS. Ejemplo: cn-hangzhou.
      ImageId	Identificador de la imagen. Se recomienda seleccionar la imagen de Alibaba Cloud Linux cuyo identificador es aliyun_3_x64_20G_alibase_20240528.vhd.
      InstanceType	Tipo de instancia. Ejemplos: Para aplicaciones personales, se recomienda elegir el tipo de instancia ecs.e-c1m1.large, que cuenta con 2 vCPU y 2 GiB de memoria. Para aplicaciones de pequeñas y medianas empresas, se recomienda elegir el tipo de instancia ecs.c7.large, que cuenta con 2 vCPU y 4 GiB de memoria.
      SecurityGroupId	Identificador del security group. Obtenga este valor en la respuesta de la operación CreateSecurityGroup. Ejemplo: sg-bp18z2q1jg4gq95t****.
      VSwitchId	Identificador del vSwitch. Obtenga este valor en la respuesta de la operación CreateVSwitch. Ejemplo: vsw-bp11hf5r945gewysp****.
      InstanceName	Nombre de la instancia de ECS. Ejemplo: ecs_cli_demo.
      InstanceChargeType	Método de facturación de la instancia de ECS. Para crear una instancia de suscripción, establezca el valor en PrePaid. Nota Asegúrese de que el saldo de su cuenta sea suficiente.
      PeriodUnit	Unidad de duración de la suscripción. Ejemplo: Month.
      Period	Duración de la suscripción. Ejemplo: 1.
      InternetMaxBandwidthOut	Ancho de banda público saliente máximo. Ejemplo: 1.
      Password	Contraseña de inicio de sesión de la instancia de ECS. Ejemplo: <yourPassword>. Nota Para garantizar la seguridad de la instancia, debe especificar una contraseña compleja.
      SystemDisk.Category	Categoría del disco del sistema. Ejemplo: cloud_essd.
      SystemDisk.Size	Tamaño del disco del sistema. Ejemplo: 40.

   2. Comando de ejemplo

      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. Salida de ejemplo del comando

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

Conexión a una instancia de ECS

1. Obtenga la dirección IP pública de la instancia de ECS.

   Invoque la operación DescribeInstances con el identificador de la instancia de ECS para consultar su dirección IP pública. En este ejemplo, el identificador de la instancia de ECS es i-bp1ducce5hs1jm98****.

   • Comando de ejemplo

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

   • Salida de ejemplo del comando

     El parámetro PublicIpAddresses indica la dirección IP pública de la instancia de ECS.

     

2. Conéctese a la instancia de ECS.

   ssh <Username>@<Public IP address>

   

Inicio de una instancia de ECS

Invoque la operación StartInstance para iniciar una instancia de ECS.

• Escenario de ejemplo: inicie una instancia de ECS con el identificador i-bp1aq39j2yul5y01**** en la región China (Hangzhou) (cn-hangzhou) después de una ejecución de prueba, sin aplicar solución de problemas durante el arranque.

• Comando de ejemplo

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

• Salida de ejemplo del comando

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

Consulta de los detalles de instancias de ECS

Invoque la operación DescribeInstances para consultar los detalles de una o más instancias de ECS.

Creación de una instantánea

Invoque la operación CreateSnapshot para crear una instantánea de un disco.

• Escenario de ejemplo: cree una instantánea para un disco SSD empresarial (ESSD) con el identificador d-bp14bjlwo3t3owin****. Establezca el nombre de la instantánea en demoname, la descripción en demo y el periodo de retención en tres días.

• Comando de ejemplo

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

• Salida de ejemplo del comando

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

Creación de una imagen personalizada a partir de una instancia de ECS

Invoque la operación CreateImage para crear una imagen personalizada a partir de una instancia de ECS.

• Escenario de ejemplo

  Parámetro	Descripción y ejemplo
  InstanceId	Identificador de la instancia de ECS. Ejemplo: i-bp1aq39j2yul5y01****.
  Platform	Distribución del sistema operativo del disco del sistema en la imagen personalizada. Ejemplo: Aliyun, que corresponde a Alibaba Cloud Linux.
  RegionId	Identificador de la región donde se creará la imagen personalizada. Ejemplo: cn-hangzhou.

• Comando de ejemplo

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

• Salida de ejemplo del comando

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

Detención de una instancia de ECS

Invoque la operación StopInstance con el parámetro ForceStop establecido en false y StoppedMode en KeepCharging para detener una instancia de ECS en estado Running (Running) después de una ejecución de prueba. La instancia de ECS se detiene en modo estándar y su facturación continúa.

• Escenario de ejemplo: detenga una instancia de ECS con el identificador i-bp1aq39j2yul5y01**** en la región China (Hangzhou) (cn-hangzhou).

• Comando de ejemplo

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

• Salida de ejemplo del comando

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

Referencias

Este tema describe operaciones de API específicas. Para obtener información sobre otras operaciones de API, consulte API overview.

En Alibaba Cloud CLI, puede especificar opciones de línea de comandos para modificar el comportamiento de los comandos o implementar funciones extendidas según los requisitos de su negocio. Para obtener más información, consulte Command-line options.