全部产品
Search
文档中心

ENS:Gunakan CLI untuk mengelola sumber daya ENS

更新时间:Jul 06, 2025

Alibaba Cloud CLI adalah alat baris perintah serbaguna yang dikembangkan berdasarkan OpenAPI. Anda dapat menggunakan Alibaba Cloud CLI untuk mengimplementasikan pengelolaan dan pemeliharaan otomatis sumber daya ENS. Topik ini menjelaskan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi API ENS.

Sebelum memulai

Pelajari lebih lanjut tentang Alibaba Cloud CLI. Untuk informasi lebih lanjut, lihat Apa itu Alibaba Cloud CLI?

Instal Alibaba Cloud CLI

Anda harus menginstal Alibaba Cloud CLI sebelum dapat menggunakannya. 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: Windows.

  • Sistem operasi Linux: Linux.

  • Sistem operasi macOS: macOS.

Anda juga dapat menggunakan Cloud Shell yang disediakan oleh Alibaba Cloud untuk men-debug perintah yang ingin Anda jalankan di Alibaba Cloud CLI. Untuk informasi lebih lanjut tentang Cloud Shell, lihat Apa itu Cloud Shell?

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 dan menggunakan Pengguna Resource Access Management (RAM) untuk memanggil operasi API atau melakukan operasi O&M rutin.

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-jenis Kredensial. Dalam contoh ini, kredensial AccessKey digunakan.

  1. Buat pengguna RAM dan berikan izin yang diperlukan kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Buat Pengguna RAM dan Berikan Izin kepada Pengguna RAM.

    Penting

    Dalam contoh ini, Anda perlu melampirkan kebijakan AliyunENSFullAccess ke pengguna RAM, yang memberikan akses penuh ke instance ENS, seperti menanyakan dan mengelola instance. Anda dapat menggunakan kebijakan AliyunENSReadOnlyAccess atau membuat kebijakan kustom. Untuk informasi lebih lanjut, lihat Kebijakan Kustom untuk ENS.

  2. Buat pasangan AccessKey untuk pengguna RAM dan catat ID AccessKey dan Rahasia AccessKey untuk konfigurasi kredensial identitas. Untuk informasi lebih lanjut, lihat Buat Pasangan AccessKey untuk Pengguna RAM.

  3. Peroleh dan catat ID wilayah yang tersedia untuk konfigurasi kredensial identitas. Alibaba Cloud CLI menggunakan ID wilayah tertentu untuk memulai panggilan API. Untuk informasi lebih lanjut tentang wilayah yang tersedia, lihat Endpoints.

    Catatan

    Saat menggunakan Alibaba Cloud CLI, Anda dapat menggunakan opsi --region untuk menjalankan perintah di wilayah tertentu. Jika Anda menggunakan opsi tersebut, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi kredensial default dan pengaturan variabel lingkungan. Untuk informasi lebih lanjut, lihat Opsi Baris Perintah untuk Panggilan API.

  4. Gunakan pasangan AccessKey dari pengguna RAM untuk mengonfigurasi kredensial identitas dalam file konfigurasi bernama AkProfile. Untuk informasi lebih lanjut, lihat Contoh Konfigurasi.

Hasilkan perintah CLI

  1. Pergi ke halaman Debugging dari API ENS.

  2. Di kotak pencarian di sisi kiri halaman yang muncul, cari operasi yang ingin Anda panggil. Pada tab Parameters, masukkan nilai parameter berdasarkan dokumen API dari operasi API tersebut. Lalu, klik tab CLI Example di sisi kanan tab Parameters untuk menghasilkan contoh yang berisi parameter yang telah dikonfigurasi.image

    • Klik ikon image. Anda akan diarahkan ke Cloud Shell. Anda dapat men-debug perintah di Cloud Shell.

    • Klik ikon image untuk menyalin perintah CLI ke clipboard dan tempelkan perintah tersebut ke shell lokal.

      • Saat menempelkan contoh perintah ke shell Anda untuk debugging, perhatikan format parameter. Untuk informasi lebih lanjut tentang format parameter Alibaba Cloud CLI, lihat Format Parameter.

      • Secara default, OpenAPI Explorer menambahkan opsi --region ke perintah CLI yang dihasilkan. Saat Anda menyalin perintah ke shell Anda, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi kredensial default dan pengaturan variabel lingkungan, dan menjalankan perintah di wilayah yang ditentukan secara prioritas. Anda dapat menghapus atau menyimpan opsi tersebut sesuai dengan kebutuhan bisnis Anda.

Panggil operasi API

Sintaksis

Di Alibaba Cloud CLI, Anda dapat menggunakan sintaksis berikut untuk menjalankan perintah. Untuk informasi lebih lanjut, lihat Sintaksis.

aliyun <command> <subcommand> [opsi dan parameter]

Opsi perintah

Saat menggunakan Alibaba Cloud CLI, Anda dapat menentukan opsi perintah untuk mengubah perilaku perintah atau mengimplementasikan fitur tambahan dari perintah. Dalam banyak kasus, opsi perintah berikut digunakan:

  • --profile<profileName>: Anda dapat menggunakan opsi --profile dan parameter profileName untuk menentukan profil konfigurasi. Setelah menentukan profil konfigurasi yang valid, Alibaba Cloud CLI mengabaikan informasi dalam konfigurasi kredensial default dan pengaturan variabel lingkungan dan menggunakan konfigurasi yang Anda tentukan untuk menjalankan perintah secara prioritas.

  • --help: Anda dapat menggunakan opsi --help untuk mendapatkan informasi bantuan tentang perintah. Untuk informasi lebih lanjut, lihat Gunakan Perintah Help.

Untuk informasi lebih lanjut, lihat Opsi Baris Perintah untuk Panggilan API.

Contoh pemanggilan

Contoh berikut menunjukkan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi RebootInstance dari ENS untuk me-restart sebuah instance. Untuk informasi lebih lanjut tentang operasi RebootInstance, lihat RebootInstance.

  1. Jalankan perintah berikut:

    image

  2. Lihat keluaran perintah.

    image

Catatan

Jika terjadi kesalahan setelah Anda memanggil operasi API dari ENS, periksa apakah parameter input dan nilainya valid berdasarkan kode kesalahan.

Anda juga dapat menggunakan Diagnostik OpenAPI Alibaba Cloud untuk melakukan diagnosis mandiri berdasarkan ID permintaan yang dikembalikan atau informasi kesalahan SDK.