Gunakan Alibaba Cloud CLI untuk mengelola Auto Scaling - Auto Scaling

Topik ini menjelaskan cara menggunakan Alibaba Cloud Command Line Interface (CLI) untuk memanggil API Auto Scaling. Dalam topik ini, operasi DescribeScalingActivities digunakan sebagai contoh. Anda dapat memanggil operasi ini untuk menanyakan detail aktivitas penskalaan tertentu.

Informasi latar belakang

Alibaba Cloud CLI adalah alat baris perintah serbaguna yang dikembangkan berdasarkan API. Anda dapat menggunakan Alibaba Cloud CLI untuk secara otomatis mengelola dan memelihara sumber daya Auto Scaling. Untuk informasi lebih lanjut, lihat Apa itu Alibaba Cloud CLI?.

Langkah 1: Instal Alibaba Cloud CLI

Sebelum menggunakan Alibaba Cloud CLI, Anda harus menginstalnya. Anda dapat menginstal Alibaba Cloud CLI di sistem operasi Windows, Linux, dan macOS. Pilih paket instalasi sesuai dengan sistem operasi perangkat Anda. Untuk informasi lebih lanjut, lihat topik-topik berikut:

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

Alibaba Cloud CLI sudah terinstal sebelumnya di Cloud Shell. Cloud Shell secara otomatis mengonfigurasi kredensial identitas. Anda juga dapat menggunakan Cloud Shell untuk men-debug perintah yang ingin Anda jalankan di Alibaba Cloud CLI. Untuk informasi lebih lanjut, lihat Apa itu Cloud Shell?.

Langkah 2: Konfigurasikan Alibaba Cloud CLI

Penting

Akun Alibaba Cloud memiliki izin untuk mengelola dan mengakses API semua layanan Alibaba Cloud. Jika Anda menggunakan akun Alibaba Cloud untuk memanggil operasi API, risiko keamanan mungkin timbul. Kami merekomendasikan agar Anda membuat Pengguna Resource Access Management (RAM), memberikan izin yang diperlukan kepada pengguna RAM berdasarkan prinsip hak istimewa minimal, dan kemudian menggunakan pengguna RAM untuk memanggil operasi API. Untuk informasi lebih lanjut tentang 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 di Alibaba Cloud CLI. Alibaba Cloud CLI mendukung berbagai jenis kredensial identitas. Untuk informasi lebih lanjut, lihat Jenis Kredensial. Alibaba Cloud CLI memungkinkan Anda menggunakan informasi AccessKey dari pengguna RAM untuk mengonfigurasi kredensial identitas. Untuk melakukannya, ikuti langkah-langkah berikut:

Buat pengguna RAM dan kemudian buat pasangan AccessKey untuk pengguna RAM untuk mengonfigurasi kredensial identitas. Untuk informasi lebih lanjut, lihat Buat Pengguna RAM dan Buat Pasangan AccessKey.
Berikan izin yang diperlukan kepada pengguna RAM. Dalam contoh ini, lampirkan kebijakan AliyunESSReadOnlyAccess ke pengguna RAM. Kebijakan tersebut memberikan izin baca saja pada Auto Scaling kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Berikan Izin kepada Pengguna RAM.
Peroleh ID wilayah tempat Anda ingin mengonfigurasi kredensial identitas. Alibaba Cloud CLI menggunakan ID wilayah yang Anda tentukan untuk memulai pemanggilan API. Untuk informasi lebih lanjut tentang wilayah yang didukung oleh Auto Scaling, lihat Endpoints.
Catatan
Ketika menggunakan Alibaba Cloud CLI, Anda dapat menggunakan opsi --region untuk menjalankan perintah di wilayah tertentu. Jika Anda menggunakan opsi ini, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi kredensial default dan pengaturan variabel lingkungan. Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.
Gunakan pasangan AccessKey dari pengguna RAM untuk mengonfigurasi kredensial AccessKey di profil bernama AkProfile. Untuk informasi lebih lanjut, lihat Contoh Konfigurasi.

Langkah 3: Hasilkan perintah CLI

Pergi ke DescribeScalingActivities di OpenAPI Explorer.
Di tab Parameters, konfigurasikan parameter. Kemudian, klik tab CLI Example untuk melihat contoh perintah CLI yang dihasilkan.
Salin perintah CLI atau debug perintah CLI di Cloud Shell.
- Klik ikon untuk start Cloud Shell dan debug perintah CLI di Cloud Shell.
- Klik ikon untuk menyalin perintah contoh ke clipboard. Kemudian, tempelkan perintah contoh ke shell lokal Anda untuk menjalankan perintah contoh atau mengedit skrip baris perintah otomatisasi.
Catatan
Ketika menempelkan perintah CLI ke shell lokal Anda untuk debugging, perhatikan format parameternya. Untuk informasi lebih lanjut tentang format parameter yang diperlukan oleh Alibaba Cloud CLI, lihat Format Parameter.
Secara default, OpenAPI Explorer menambahkan opsi --region ke perintah CLI yang dihasilkan. Ketika Anda menyalin perintah ke shell Anda, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi kredensial identitas default dan pengaturan variabel lingkungan, dan menjalankan perintah di wilayah yang ditentukan dengan prioritas. Anda dapat menghapus atau mempertahankan opsi ini berdasarkan kebutuhan bisnis Anda.

Langkah 4: Panggil Auto Scaling API

Catatan

Alibaba Cloud CLI mengintegrasikan operasi API Auto Scaling yang lebih lama. Kami merekomendasikan agar Anda menggunakan operasi API Auto Scaling versi 2022-02-22. Untuk melakukannya, konfigurasikan opsi --force dan --version ketika Anda memanggil operasi API Auto Scaling. Untuk informasi lebih lanjut, lihat Paksa Panggil Operasi API.
Ketika perintah CLI dihasilkan di OpenAPI Explorer untuk operasi API Auto Scaling versi 2022-02-22, opsi --force dan --version secara otomatis ditambahkan ke perintah CLI. Anda tidak perlu melakukan operasi ini secara manual.
Untuk informasi lebih lanjut, lihat Daftar Operasi Berdasarkan Fungsi.

Dalam contoh berikut, operasi DescribeScalingActivities dari Auto Scaling dipanggil untuk melihat detail aktivitas penskalaan tertentu. Untuk informasi lebih lanjut, lihat DescribeScalingActivities.

Jalankan perintah berikut:

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

Lihat keluaran perintah.

{
  "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": "Tambah \\\"1\\\" instance ECS",
      "StatusCode": "Successful",
      "Cause": "Permintaan pengguna untuk mengeksekusi aturan penskalaan \\\"asr-bp12tcnol686y1ik****\\\", mengubah Total Capacity dari \\\"1\\\" menjadi \\\"2\\\".",
      "ScalingActivityId": "asa-bp161xudmuxdzofe****",
      "StatusMessage": "\\\"1\\\" instance ECS ditambahkan",
      "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": "Sumber daya ECS yang ditentukan tidak tersedia di wilayah ini. Silakan coba lagi nanti.",
      "Detail": "\"instance ECS baru \"i-j6c8ilerw, i-j6c8iler4mx\" dibuat.\"",
      "TriggerSourceType": "Api",
      "TriggerSourceId": "2346366580*****",
      "LifecycleHookContext": {
        "DisableLifecycleHook": false,
        "IgnoredLifecycleHookIds": [
          "ash-bp14zolna43z266bq***\n"
        ]
      },
      "ActivityMetadata": "{\\\"goatscaler.io/managed\\\":\\\"true\\\"}",
      "InstanceRefreshTaskId": "ir-asdf12adsxg*****"
    }
  ]
}

Catatan

Jika kesalahan dikembalikan setelah Anda memanggil operasi API dari Auto Scaling, periksa apakah parameter input dan nilainya valid berdasarkan kode kesalahan.

Anda juga dapat melakukan diagnosis mandiri berdasarkan ID permintaan yang dikembalikan atau informasi kesalahan SDK di halaman Diagnosis Masalah OpenAPI.