Kelola Auto Scaling dengan Alibaba Cloud CLI - Auto Scaling

Topik ini menggunakan operasi Auto Scaling (ESS) DescribeScalingActivities sebagai contoh untuk menjelaskan cara memanggil operasi OpenAPI Auto Scaling dengan Alibaba Cloud CLI.

Latar Belakang

Alibaba Cloud Command Line Interface (CLI) adalah alat umum untuk Auto Scaling yang dibangun di atas OpenAPI. Anda dapat menggunakan Alibaba Cloud CLI untuk mengotomatiskan pengelolaan dan pemeliharaan Auto Scaling. Untuk informasi selengkapnya, lihat Apa itu Alibaba Cloud CLI.

Langkah 1: Instal Alibaba Cloud CLI

CLI dapat diinstal pada Windows, Linux, dan macOS. Pilih metode instalasi sesuai sistem operasi Anda.

Windows: Instal Alibaba Cloud CLI di Windows.
Linux: Instal Alibaba Cloud CLI di Linux.
macOS: Instal Alibaba Cloud CLI di macOS.

Cloud Shell telah dilengkapi Alibaba Cloud CLI yang pra-instal dan konfigurasi Cloud Shell Anda dikonfigurasi secara otomatis, sehingga tidak perlu pengaturan manual. Anda dapat melakukan debug perintah Alibaba Cloud CLI langsung di Cloud Shell. Untuk informasi selengkapnya, lihat Apa itu Cloud Shell?.

Langkah 2: Konfigurasi Alibaba Cloud CLI

Penting

Akun Alibaba Cloud memiliki izin akses dan pengelolaan penuh terhadap OpenAPI semua Produk, yang menimbulkan risiko keamanan tinggi. Kami sangat menyarankan agar Anda membuat RAM user, memberikan izin kepada RAM user tersebut berdasarkan prinsip hak istimewa minimal, lalu menggunakan RAM user tersebut untuk mengakses OpenAPI. Untuk informasi lebih lanjut mengenai kebijakan yang didukung oleh Auto Scaling, lihat Kebijakan sistem untuk Auto Scaling dan Kebijakan kustom untuk Auto Scaling.

Sebelum menggunakan Alibaba Cloud CLI, Anda harus mengonfigurasi informasi seperti kredensial identitas dan ID wilayah. Alibaba Cloud CLI mendukung beberapa jenis kredensial identitas. Untuk informasi selengkapnya, lihat Jenis kredensial identitas. Anda dapat menggunakan AccessKey dari RAM user untuk mengonfigurasi kredensial jenis AK. Langkah-langkahnya sebagai berikut:

Buat RAM user dan AccessKey untuk mengonfigurasi kredensial identitas. Untuk informasi selengkapnya, lihat Buat RAM user dan Buat AccessKey.
Berikan izin AliyunESSReadOnlyAccess kepada RAM user untuk akses read-only ke Auto Scaling. Untuk informasi selengkapnya, lihat Kelola izin RAM user.
Dapatkan ID wilayah yang tersedia. Alibaba Cloud CLI menggunakan wilayah yang ditentukan untuk melakukan panggilan OpenAPI. Untuk daftar wilayah yang tersedia untuk Auto Scaling, lihat Endpoints.
Catatan
Pada Alibaba Cloud CLI, gunakan opsi --region untuk menentukan wilayah dalam pemanggilan perintah. Opsi ini menggantikan wilayah yang ditentukan dalam konfigurasi kredensial identitas default maupun dalam variabel lingkungan. Untuk informasi selengkapnya, lihat Opsi command-line.
Gunakan AccessKey RAM user untuk mengonfigurasi kredensial jenis AK. Beri nama file konfigurasi tersebut AkProfile. Untuk informasi selengkapnya, lihat Contoh konfigurasi.

Langkah 3: Hasilkan contoh perintah CLI

Di OpenAPI Explorer, buka halaman debug DescribeScalingActivities.
Pada bagian Parameter Configuration, masukkan parameter permintaan. Klik tab CLI Example untuk melihat contoh CLI yang dihasilkan.
Salin contoh CLI atau jalankan di Cloud Shell:
- Klik tombol Run Command untuk membuka Cloud Shell dan lakukan debug perintah.
- Klik tombol Copy untuk menyalin contoh CLI ke clipboard. Tempel contoh tersebut ke tool shell lokal untuk menjalankannya, atau gunakan untuk menyusun skrip command-line otomatis.
Catatan
Saat menyalin contoh CLI ke tool shell lokal untuk debugging, perhatikan format parameternya. Untuk informasi selengkapnya mengenai format parameter perintah Alibaba Cloud CLI, lihat Format parameter.
OpenAPI Explorer secara default menambahkan opsi --region ke contoh yang dihasilkan. Saat Anda menyalin perintah tersebut untuk dijalankan secara lokal, Alibaba Cloud CLI akan mengabaikan informasi wilayah dalam konfigurasi kredensial identitas default dan variabel lingkungan, serta menggunakan wilayah yang ditentukan dalam opsi tersebut. Anda dapat menghapus atau mempertahankan opsi ini sesuai kebutuhan.

Langkah 4: Panggil OpenAPI Auto Scaling

Catatan

Alibaba Cloud CLI mengintegrasikan versi OpenAPI Auto Scaling yang lebih lama. Gunakan opsi --force dan --version untuk memanggil OpenAPI Auto Scaling versi 2022-02-22. Untuk informasi selengkapnya, lihat Paksa pemanggilan API.
OpenAPI Explorer secara otomatis menambahkan opsi --force dan --version saat menghasilkan contoh perintah untuk OpenAPI Auto Scaling versi 2022-02-22. Tidak diperlukan perubahan manual.
Untuk informasi selengkapnya mengenai API yang tersedia, lihat Ikhtisar API.

Contoh berikut menunjukkan cara menggunakan Alibaba Cloud CLI untuk memanggil API Auto Scaling DescribeScalingActivities dan melihat detail aktivitas penskalaan tertentu. Untuk informasi selengkapnya mengenai API ini, lihat DescribeScalingActivities - Kueri aktivitas penskalaan.

Jalankan perintah.

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

Output berikut dikembalikan.

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

Catatan

Jika terjadi kesalahan setelah memanggil OpenAPI Auto Scaling, periksa parameter permintaan dan nilainya berdasarkan kode kesalahan yang dikembalikan.

Catat RequestID atau pesan kesalahan SDK yang dikembalikan dari pemanggilan tersebut. Gunakan Alibaba Cloud OpenAPI Diagnostic Platform untuk menjalankan diagnosis mandiri.