All Products
Search
Document Center

Elastic Compute Service:Buat perintah

Last Updated:Aug 21, 2026

Perintah Cloud Assistant memungkinkan Anda menjalankan tugas rutin pada instans Elastic Compute Service (ECS) secara cepat, seperti menjalankan skrip O&M otomatis, memantau proses, mengatur ulang kata sandi pengguna, menginstal atau menguninstall perangkat lunak, memperbarui aplikasi, dan menginstal patch. Sebuah perintah dapat berupa skrip Windows PowerShell, skrip Windows Bat, atau skrip Linux Shell, serta mendukung parameter kustom yang memungkinkan Anda menetapkan nilai variabel.

Batasan

Resource Limit
Jumlah perintah per wilayah 500–50.000 (kuota per akun; dapat meningkat seiring penggunaan ECS)
Ukuran maksimum skrip terenkode Base64 18 KB

Untuk melihat atau menambah kuota Anda, lihat Manage quotas. Sertakan alasan detail dalam permintaan Anda untuk meningkatkan peluang persetujuan.

Prosedur

Buat perintah di Konsol ECS

  1. Buka halaman ECS Cloud Assistant.

  2. Pada bilah navigasi atas, pilih wilayah dan kelompok sumber daya.

    Setelah Anda menetapkan perintah ke kelompok sumber daya, Anda dapat mengelola izin perintah di tingkat kelompok sumber daya tersebut. Tambahkan kebijakan akses yang diperlukan ke kelompok sumber daya tersebut. Untuk kebijakan akses yang berlaku pada perintah Cloud Assistant dan otorisasi kelompok sumber daya, lihat Cloud Assistant command-specific sample custom policies dan Classify resources into resource groups and grant permissions on the resource groups.
  3. Pada halaman ECS Cloud Assistant, klik Create/Run Command.

  4. Pada bagian Command Information, konfigurasikan perintah. Command type: Pilih jenis yang sesuai dengan OS instans target Anda. Command content: Masukkan atau tempel perintah. Verifikasi sintaks, logika, dan algoritma sebelum menyimpan. Contoh — arsipkan file ke /backup pada instans Linux:

    • Run at Fixed Interval: Tetapkan interval (60 detik–7 hari) menggunakan ekspresi laju. Interval ini adalah jeda antara dua eksekusi berturut-turut, bukan durasi eksekusi. Misalnya, interval 5 menit dengan waktu eksekusi 2 menit berarti eksekusi berikutnya dimulai 3 menit setelah eksekusi sebelumnya selesai. Eksekusi pertama dimulai setelah interval berlalu sejak pembuatan tugas. > Note: Interval harus lebih panjang daripada periode timeout perintah.

    • Run on Clock-based Schedule Cron Expression: Tentukan ekspresi cron (akurat hingga detik) dan zona waktu. Interval minimum: 10 detik (harus lebih panjang daripada periode timeout). Contoh: 0 0 12 ? * WED 2022 dengan (GMT+08:00) Asia/Shanghai dijalankan setiap Rabu pukul 12:00:00 pada tahun 2022. Lihat Cron expressions.

    Execution plan

    Option Behavior
    Precheck only Melakukan pemeriksaan awal terhadap permintaan tanpa menerapkan perintah. Pemeriksaan mencakup parameter permintaan, lingkungan eksekusi instans, dan status Cloud Assistant Agent.
    Run on schedule Menjalankan perintah sebagai tugas terjadwal. Lihat opsi berikutnya.

    Parameter lainnya

    Parameter Description
    Command Name Nama untuk perintah tersebut.
    Command Description Deskripsi tujuan perintah.
    Username Pengguna OS yang menjalankan perintah. Nilai default: root (Linux), system (Windows). Gunakan hak istimewa seminimal mungkin. Lihat Run Cloud Assistant commands as a regular user.
    Execution Path Direktori tempat skrip dijalankan pada instans. Nilai default: /root untuk Linux dan C:\Windows\system32 untuk Windows. Untuk memastikan skrip dijalankan di direktori yang diharapkan, tambahkan perintah cd di awal skrip.
    Timeout Waktu eksekusi maksimum. Nilai valid: 10 hingga 86.400 detik (24 jam). Nilai default: 60 detik. Nilai di bawah 10 akan diatur menjadi 10.
    Task termination mode

    Menentukan cara tugas dihentikan saat Anda menghentikannya.

    • Script Process: menghentikan proses skrip.

    • Process Tree: menghentikan seluruh pohon proses, yaitu proses skrip dan semua proses anak yang dibuatnya.

    Command content: Anda dapat mengaktifkan Use Parameters. Setelah dienkripsi Base64, konten perintah tidak boleh melebihi 18 KB jika Anda memilih Run and Save, atau 24 KB jika Anda memilih Run.

    Custom parameters: Definisikan parameter dalam format {{parameter}} dan tetapkan nilainya secara manual. Parameter kustom mendukung nilai dinamis dan memungkinkan Anda menggunakan satu nilai di beberapa tempat.

    Built-in parameters: Cloud Assistant menyediakan parameter bawaan yang secara otomatis diganti saat runtime dan tidak perlu ditetapkan secara manual, seperti {{ACS::RegionId}} untuk ID wilayah dan {{ACS::InstanceId}} untuk ID instans.

    #!/bin/bash
    # Contoh
    # {{name}} adalah parameter kustom. Tetapkan nilainya setelah Anda selesai menulis konten perintah.
    echo {{name}}
    
    # {{ACS::RegionId}} adalah parameter bawaan dan tidak perlu ditetapkan secara manual.
    echo {{ACS::RegionId}}
  5. Pada Select Instance atau Select Managed Instances, pilih instans target. Anda dapat memilih beberapa instans, hingga 100 sekaligus.

  6. Klik Save.

Buat perintah menggunakan Alibaba Cloud CLI

Contoh permintaan

Panggil CreateCommand untuk membuat perintah. Contoh berikut membuat perintah bernama update yang memperbarui OS pada instans Linux.

aliyun ecs CreateCommand --RegionId 'cn-hangzhou' \
--CommandContent 'eXVtIHVwZGF0ZSAteQ==' \
--Type 'RunShellScript' \
--Name 'update' \
--Description 'update' \
--output cols=CommandId
Ganti nilai dalam tanda petik tunggal dengan nilai aktual Anda.

Tabel berikut menjelaskan parameter utama. Untuk referensi lengkap semua parameter, lihat CreateCommand.

Parameter Contoh Description
RegionId cn-hangzhou Wilayah.
Name update Nama perintah.
Type RunShellScript Jenis perintah: RunShellScript (Linux Shell), RunBatScript (Windows Bat), atau RunPowerShellScript (Windows PowerShell).
CommandContent eXVtIHVwZGF0ZSAteQ== Konten perintah yang telah dienkripsi Base64.
Description update Deskripsi perintah.

Contoh respons

CommandId
---------
c-hz018qng4on****

Langkah selanjutnya

Setelah membuat perintah, Anda dapat melihat detailnya di tab My Commands. Untuk menjalankan perintah pada instans tertentu, lihat Run a command.

Jika perintah menggunakan parameter, masukkan nilai parameternya di kolom Command Parameters saat menjalankan perintah.