Elastic Compute Service：Referensi CLI

Menggunakan Alibaba Cloud CLI

Instal dan konfigurasikan Alibaba Cloud CLI

Menggunakan Alibaba Cloud CLI untuk memanggil operasi API ECS

Setelah Anda menginstal dan mengonfigurasi Alibaba Cloud CLI, Anda dapat menjalankan perintah dalam format berikut untuk memanggil operasi API ECS:

aliyun ecs <Nama Operasi API> --<Nilai Parameter 1> --<Nilai Parameter 2> ...

Contoh penggunaan

Contoh berikut menjelaskan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi API ECS.

Buat instance ECS

Contoh berikut menjelaskan cara membuat instance ECS berlangganan dari gambar Alibaba Cloud Linux di wilayah China (Hangzhou) menggunakan Alibaba Cloud CLI.

1. Buat persiapan.

   Sebelum Anda membuat instance ECS, buat virtual private cloud (VPC), vSwitch, dan grup keamanan, serta dapatkan ID sumber daya yang disebutkan sebelumnya.

   Catatan

   Jika Anda sudah membuat sumber daya yang disebutkan sebelumnya dan sumber daya tersebut memenuhi kebutuhan bisnis Anda, lewati langkah ini.

   1. Panggil operasi CreateVpc untuk membuat VPC.

      Dalam contoh ini, VPC dibuat di wilayah China (Hangzhou) dan dikaitkan dengan blok CIDR 192.168.0.0/16.

      • Perintah Contoh

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

      • Output Perintah Contoh

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

   2. Panggil operasi CreateVSwitch untuk membuat vSwitch di VPC.

      Dalam contoh ini, vSwitch dibuat di VPC dengan ID vpc-bp1d9v4763ym2hlzt**** dan dikaitkan dengan blok CIDR 192.168.0.0/24.

      • Perintah Contoh

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

      • Output Perintah Contoh

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

   3. Panggil operasi CreateSecurityGroup untuk membuat grup keamanan di VPC.

      • Perintah Contoh

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

      • Output Perintah Contoh

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

   4. Panggil operasi AuthorizeSecurityGroup untuk membuat aturan grup keamanan di grup keamanan.

      Dalam contoh ini, aturan grup keamanan arah masuk yang mengizinkan lalu lintas TCP pada port 22 ditambahkan ke grup keamanan dengan ID sg-bp18z2q1jg4gq95t****.

      • Perintah Contoh

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

      • Output Perintah Contoh

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

2. Buat instance ECS.

   Panggil operasi RunInstances untuk membuat instance ECS berlangganan.

   1. Skenario Contoh

      Parameter	Deskripsi dan contoh
      RegionId	ID wilayah tempat Anda ingin membuat instance ECS. Contoh: cn-hangzhou.
      ImageId	ID gambar. Kami sarankan Anda memilih gambar Alibaba Cloud Linux dengan ID aliyun_3_x64_20G_alibase_20240528.vhd.
      InstanceType	Tipe instans. Contoh: Untuk aplikasi pribadi, kami sarankan Anda memilih tipe instans ecs.e-c1m1.large yang memiliki 2 vCPU dan 2 GiB memori. Untuk aplikasi usaha kecil dan menengah, kami sarankan Anda memilih tipe instans ecs.c7.large yang memiliki 2 vCPU dan 4 GiB memori.
      SecurityGroupId	ID grup keamanan. Dapatkan nilai dari respons operasi CreateSecurityGroup. Contoh: sg-bp18z2q1jg4gq95t****.
      VSwitchId	ID vSwitch. Dapatkan nilai dari respons operasi CreateVSwitch. Contoh: vsw-bp11hf5r945gewysp****.
      InstanceName	Nama instance ECS. Contoh: ecs_cli_demo.
      InstanceChargeType	Metode penagihan instance ECS. Untuk membuat instance ECS berlangganan, atur nilainya menjadi PrePaid. Catatan Pastikan saldo akun Anda mencukupi.
      PeriodUnit	Satuan durasi langganan. Contoh: Month.
      Period	Durasi langganan. Contoh: 1.
      InternetMaxBandwidthOut	Bandwidth publik maksimum keluar. Contoh: 1.
      Password	Kata sandi logon instance ECS. Contoh: <kataSandiAnda>. Catatan Untuk memastikan keamanan instans, Anda harus menentukan kata sandi yang kompleks.
      SystemDisk.Category	Kategori disk sistem. Contoh: cloud_essd.
      SystemDisk.Size	Ukuran disk sistem. Contoh: 40.

   2. Perintah Contoh

      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 <kataSandiAnda>  \
      --SystemDisk.Category cloud_essd \
      --SystemDisk.Size 40

   3. Output Perintah Contoh

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

Hubungkan ke instance ECS

1. Dapatkan alamat IP publik instance ECS.

   Panggil operasi DescribeInstances dengan ID instance ECS untuk menanyakan alamat IP publik instans tersebut. Dalam contoh ini, ID instance ECS adalah i-bp1ducce5hs1jm98****.

   • Perintah Contoh

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

   • Output Perintah Contoh

     Parameter PublicIpAddresses menunjukkan alamat IP publik instance ECS.

     

2. Hubungkan ke instance ECS.

   ssh <Username>@<Alamat IP Publik>

   

Mulai instance ECS

Panggil operasi StartInstance untuk memulai instance ECS.

• Skema Contoh: Mulai instance ECS dengan ID i-bp1aq39j2yul5y01**** di wilayah China (Hangzhou) (cn-hangzhou) setelah uji coba kering, dan jangan lakukan pemecahan masalah selama startup instans.

• Perintah Contoh

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

• Output Perintah Contoh

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

Query detail instance ECS

Panggil operasi DescribeInstances untuk menanyakan detail satu atau lebih instance ECS.

Buat snapshot

Panggil operasi CreateSnapshot untuk membuat snapshot untuk disk.

• Skema Contoh: Buat snapshot untuk Enterprise SSD (ESSD) dengan ID d-bp14bjlwo3t3owin****. Atur nama snapshot menjadi demoname, deskripsi menjadi demo, dan periode retensi menjadi tiga hari.

• Perintah Contoh

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

• Output Perintah Contoh

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

Buat gambar kustom dari instance ECS

Panggil operasi CreateImage untuk membuat gambar kustom dari instance ECS.

• Skema Contoh

  Parameter	Deskripsi dan contoh
  InstanceId	ID instance ECS. Contoh: i-bp1aq39j2yul5y01****.
  Platform	Distribusi sistem operasi untuk disk sistem dalam gambar kustom. Contoh: Aliyun, yang menunjukkan Alibaba Cloud Linux.
  RegionId	ID wilayah tempat membuat gambar kustom. Contoh: cn-hangzhou.

• Perintah Contoh

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

• Output Perintah Contoh

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

Hentikan instance ECS

Panggil operasi StopInstance dengan parameter ForceStop disetel ke false dan StoppedMode disetel ke KeepCharging untuk menghentikan instance ECS dalam status Running (Running). Instance ECS dihentikan dalam mode standar, dan penagihan untuk instance ECS terus berlanjut.

• Skema Contoh: Hentikan instance ECS dengan ID i-bp1aq39j2yul5y01**** di wilayah China (Hangzhou) (cn-hangzhou).

• Perintah Contoh

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

• Output Perintah Contoh

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

Referensi

Topik ini menjelaskan operasi API tertentu. Untuk informasi tentang operasi API lainnya, lihat Daftar Operasi Berdasarkan Fungsi.

Dalam Alibaba Cloud CLI, Anda dapat menentukan opsi baris perintah untuk mengubah perilaku perintah atau mengimplementasikan fitur tambahan perintah berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.