All Products
Search
Document Center

Elastic Compute Service:Periksa hasil perintah Cloud Assistant dan lakukan pemecahan masalah

Last Updated:May 16, 2026

Periksa hasil eksekusi perintah Cloud Assistant, diagnosa kegagalan berdasarkan kode kesalahan, dan selesaikan masalah umum.

Latar Belakang

Perintah dapat gagal karena berbagai alasan, seperti dependensi yang tidak tersedia, masalah jaringan, kesalahan sintaksis, kegagalan debug, atau kondisi instans yang tidak normal. Periksa detail kesalahan dalam hasil eksekusi dari Konsol atau melalui API.

Lihat hasil eksekusi

Konsol

  1. Buka ECS console - Cloud Assistant.

  2. Di pojok kiri atas halaman, pilih wilayah dan resource group.地域

  3. Klik tab Command execution result.

    • Jika perintah berhasil dieksekusi:

      1. Cari hasil dengan Execution Status bernilai Successful.

      2. Pada kolom Actions, klik View.

      3. Di tab Execution complete pada halaman Instances, lihat output perintah.

        Execution successful

    • Jika perintah gagal:

      1. Cari hasil dengan Execution Status bernilai Failed.

      2. Pada kolom Actions, klik View.

      3. Di tab Failed pada halaman Instances, lihat informasi kesalahan.

        Untuk kesalahan umum dan solusinya, lihat Kesalahan eksekusi umum dan solusi.

        Execution failed

    • Untuk perintah terjadwal:

      1. Cari hasil dengan Execution Status bernilai Scheduled.

      2. Pada kolom Actions, klik View.

      3. Di halaman Instances, lihat detail eksekusi terjadwal.

CLI

Untuk penggunaan CLI, lihat Gunakan Alibaba Cloud CLI untuk mengelola resource Alibaba Cloud.

  1. Ambil InvokeId dari respons RunCommand atau InvokeCommand.

  2. Kueri hasil berdasarkan InvokeId dan RegionId. Contoh berikut menggunakan China (Shanghai). Untuk ID wilayah lainnya, lihat Wilayah dan zona.

    • Lihat status eksekusi dengan DescribeInvocations:

      aliyun ecs DescribeInvocations --RegionId cn-shanghai --InvokeId t-sh054h*****
    • Lihat hasil eksekusi dengan DescribeInvocationResults:

      aliyun ecs DescribeInvocationResults --RegionId cn-shanghai  --InvokeId t-sh054h******

API

  1. Ambil InvokeId dari respons RunCommand atau InvokeCommand.

  2. Panggil DescribeInvocations atau DescribeInvocationResults dengan InvokeId dan region ID.

Pemecahan Masalah

Kesalahan umum

Kode kesalahan

Pesan kesalahan

Rekomendasi

InstanceNotRunning

Instans tidak sedang berjalan saat perintah dikeluarkan.

Pastikan instans berada dalam status Running.

InstanceRestarted

Instans direstart selama eksekusi perintah.

Hindari merestart instans selama eksekusi perintah.

ClientNotRunning

Cloud Assistant Agent tidak berjalan.

Cloud Assistant Agent dihentikan atau belum diinstal. Jalankan atau instal ulang:

  1. Periksa proses Cloud Assistant Agent:

    • Linux:

      ps -ef |grep aliyun-service
    • Windows: Periksa apakah proses aliyun_assist_service ada di Task Manager.

  2. Jika proses tidak ada, jalankan:

    • Linux:

      # Untuk sistem Linux yang mendukung systemctl
      systemctl start aliyun.service
      
      # Untuk sistem Linux yang tidak mendukung systemctl
      /etc/init.d/aliyun-service start
    • Windows: Jalankan Aliyun Assist Service di Services Manager.

Catatan

Jika Cloud Assistant Agent tetap gagal dijalankan, lihat Instal Cloud Assistant Agent untuk menginstal ulang.

ClientNetworkBlocked

Instans mengalami masalah konektivitas jaringan.

  1. Periksa konektivitas jaringan. Jika ID instans dikembalikan, jaringan terhubung.

    curl https://{region-id}.axt.aliyun.com/luban/api/instance/instance-id
  2. Jika ID instans tidak dikembalikan, periksa security group, firewall, DNS, dan tabel rute Anda. Izinkan lalu lintas keluar pada port TCP 443, port TCP 80, dan port UDP 53 melalui jaringan internal agar Cloud Assistant dapat mengakses:

    • https://{region-id}.axt.aliyun.com:443/

    • http://100.100.100.200:80/

    • http://aliyun-client-assist-{region-id}.oss-{region-id}-internal.aliyuncs.com

      Tanggapan "AccessDenied" diharapkan saat menguji konektivitas domain ini, karena bucket OSS bersifat privat sementara hanya file paket instalasi yang memiliki izin baca publik. Pesan ini menunjukkan koneksi berhasil.

Catatan
  • {region-id} adalah wilayah tempat instans berada, misalnya cn-hangzhou untuk China (Hangzhou).

  • Untuk alamat server Cloud Assistant di setiap wilayah, lihat Konfigurasi tingkat granularitas tinggi.

SecurityGroupRuleDenied

Aturan security group menolak akses ke layanan Cloud Assistant.

ClientNotResponse

Cloud Assistant Agent tidak merespons.

Periksa log Cloud Assistant Agent:

  1. Buka file log Cloud Assistant Agent. Jalur default:

    • Linux: /usr/local/share/aliyun-assist/<versi Cloud Assistant Agent>/log/aliyun_assist_main.log

    • Windows: C:\ProgramData\aliyun\assist\<versi Cloud Assistant Agent>\log\aliyun_assist_main.log

  2. Cari InvokeId perintah di log:

    • Jika ditemukan, periksa entri di sekitarnya untuk mengetahui adanya pengecualian, seperti apakah perintah telah selesai dan apakah hasilnya dilaporkan.

    • Jika tidak ditemukan, jalankan ulang perintah. Jika masih gagal, restart Cloud Assistant Agent:

      • Linux:

        # Untuk sistem Linux yang mendukung systemctl
        systemctl restart aliyun.service
        
        # Untuk sistem Linux yang tidak mendukung systemctl
        /etc/init.d/aliyun-service restart
      • Windows: Restart Aliyun Assist Service di Services Manager.

ClientNeedUpgrade

Cloud Assistant Agent harus ditingkatkan untuk mendukung fitur yang ditentukan.

  • Periksa bidang ErrorInfo untuk fitur yang diperlukan dan versi minimum. Tingkatkan Cloud Assistant Agent ke versi tersebut atau lebih baru.

ClientNotOnline

Cloud Assistant Agent tidak terhubung ke server Cloud Assistant.

Restart Cloud Assistant Agent. Lihat Hentikan dan uninstall Cloud Assistant Agent.

DeliveryTimeout

Server Cloud Assistant gagal mengirimkan perintah ke Cloud Assistant Agent.

Jalankan ulang perintah.

ExecutionTimeout

Eksekusi perintah melebihi batas waktu.

Tingkatkan batas waktu perintah sesuai kebutuhan.

  • Di Konsol, periode Timeout Period default adalah 60 detik. Tingkatkan sesuai kebutuhan.

  • Saat memanggil RunCommand, nilai Timeout default adalah 60 detik. Tetapkan nilai yang lebih tinggi sesuai kebutuhan.

  • Saat menggunakan CreateCommand diikuti oleh InvokeCommand, nilai Timeout default adalah 60 detik. Tetapkan nilai khusus saat pembuatan, atau perbarui nanti dengan ModifyCommand.

ExecutionException

Terjadi pengecualian selama eksekusi perintah.

Periksa bidang ErrorInfo untuk detailnya.

ExitCodeNonzero

Perintah selesai dengan kode keluar bukan nol.

Periksa skrip dan output perintah.

ClientRestarted

Perintah terganggu karena Cloud Assistant Agent direstart.

Jalankan ulang perintah setelah agent direstart. Periksa status agent di Konsol Cloud Assistant atau dengan memanggil DescribeCloudAssistantStatus.

InstanceReleased

Instans dilepas selama eksekusi perintah.

Perintah gagal karena instans target telah dilepas.

DirectoryNotExists

Direktori kerja yang ditentukan tidak ada di instans.

Buat direktori kerja di instans, lalu jalankan ulang perintah.

Jalankan perintah

Kode kesalahan

Pesan kesalahan

Solusi

ClientIsUpgrading

Cloud Assistant Agent sedang ditingkatkan.

Jalankan ulang perintah setelah peningkatan selesai. Periksa status agent di Konsol Cloud Assistant atau dengan memanggil DescribeCloudAssistantStatus.

InstanceDeregistered

Instans terkelola telah dideregistrasi.

Perintah gagal karena instans terkelola telah dideregistrasi.

InvalidSystemBuiltInParameter

Parameter lingkungan bawaan tidak valid.

Parameter lingkungan bawaan tidak didukung. Untuk parameter yang didukung, lihat parameter CommandContent di RunCommand.

DefaultWorkingDirectoryNotAvailable

Direktori kerja default di instans tidak tersedia.

Periksa direktori kerja default:

  • Linux: Direktori home pengguna root /root secara default.

  • Windows: Direktori yang berisi proses Cloud Assistant Agent, misalnya C:\Windows\System32.

Anda juga dapat menentukan direktori kerja di Konsol atau melalui parameter WorkingDir dari RunCommand.

CommandNotApplicable

Jenis perintah tidak berlaku untuk instans yang ditentukan.

Setiap jenis perintah mendukung sistem operasi berikut:

  • RunBatScript: perintah batch (BAT) untuk instans Windows.

  • RunPowerShellScript: perintah PowerShell untuk instans Windows.

  • RunShellScript: perintah shell untuk instans Linux.

InvalidCommandText

Konten perintah tidak valid.

Verifikasi konten perintah. Konten dapat berupa teks biasa atau dikodekan Base64.

CommandContentDecodeError

Gagal menguraikan konten perintah.

Jika dikodekan Base64, verifikasi bahwa pengkodeannya benar.

AccountNotExists

Pengguna yang ditentukan tidak ada di instans.

Buat pengguna di instans sebelum menjalankan perintah.

  • Secara default, perintah dijalankan sebagai pengguna root pada instans ECS Linux.

  • Secara default, perintah dijalankan sebagai pengguna System pada instans ECS Windows.

Anda juga dapat menjalankan perintah sebagai pengguna lain melalui Konsol atau parameter Username dari RunCommand.

Jalankan perintah terjadwal

Kode kesalahan

Pesan kesalahan

Solusi

BadCronExpression

Ekspresi cron tidak valid.

Perbaiki ekspresi cron. Lihat Penjadwalan berbasis jam.

CronExpressionExpired

Ekspresi cron telah kedaluwarsa. Tugas terjadwal tidak akan dijalankan.

Tentukan ekspresi cron yang belum kedaluwarsa.

InvalidGMTOffsetForTimezone

Ekspresi cron berisi format zona waktu offset GMT yang tidak valid.

Periksa format zona waktu offset GMT.

Rentang yang didukung: GMT-12:59 hingga GMT+14:59. Menit: 0–59. Angka nol di depan tidak didukung untuk jam.

InvalidGMTOffsetHourForTimezone

Jam offset GMT dalam ekspresi cron tidak valid.

Periksa nilai jam zona waktu offset GMT.

Rentang yang didukung: GMT-12:59 hingga GMT+14:59. Angka nol di depan tidak didukung untuk jam.

InvalidGMTOffsetMinuteForTimezone

Menit offset GMT dalam ekspresi cron tidak valid.

Periksa nilai menit zona waktu offset GMT.

Nilai yang valid: 0 hingga 59.

TimezoneInformationCorrupt

Cloud Assistant Agent tidak dapat mengurai informasi zona waktu karena file zona waktu rusak.

  • Linux: Periksa file zona waktu di /usr/share/zoneinfo, misalnya /usr/share/zoneinfo/Asia/Shanghai.

  • Windows: Periksa registri, misalnya HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.

Catatan

Jika file zona waktu tidak ada, buat terlebih dahulu sebelum menjalankan perintah.

InvalidRateExpression

Ekspresi rate tidak valid.

Perbaiki ekspresi laju. Lihat Eksekusi Interval Tetap.

RateFrequencyTooLarge

Frekuensi eksekusi terjadwal terlalu tinggi.

Frekuensi eksekusi tidak boleh melebihi 7 hari.

InvalidAtExpression

Timestamp (ekspresi at) tidak valid.

Perbaiki stempel waktu. Lihat Menjalankan perintah hanya sekali pada waktu tertentu.

AtExpressionExpired

Timestamp (ekspresi at) telah kedaluwarsa. Tugas terjadwal tidak akan dijalankan.

Tentukan timestamp yang belum kedaluwarsa.

Menjalankan perintah dalam kontainer

Kode kesalahan

Pesan kesalahan

Solusi

InvalidContainerName

Nama kontainer tidak valid.

Nama harus dimulai dengan huruf atau angka, hanya berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-), serta panjangnya maksimal 255 karakter.

UnsupportedContainerRuntime

Runtime kontainer yang ditentukan dalam ID kontainer tidak didukung.

Hanya kontainer yang dikelola oleh Kubernetes melalui spesifikasi CRI pada runtime docker, containerd, atau cri-o yang didukung.

InvalidContainerId

ID kontainer tidak valid.

ID kontainer harus berupa string heksadesimal 64-bit. Secara opsional tambahkan awalan (docker://, containerd://, atau cri-o://) untuk menentukan runtime.

ContainerConnectFailed

Tidak dapat terhubung ke kontainer.

Periksa apakah kontainer sedang berjalan. Gunakan kubectl atau Cloud Assistant Agent untuk memeriksa status kontainer. Kontainer sedang berjalan jika State bernilai Running. Lihat Gunakan Cloud Assistant untuk menjalankan perintah dalam kontainer.

  • Jika sedang berjalan, verifikasi runtime-nya. Hanya runtime docker, containerd, dan cri-o yang dikelola oleh Kubernetes melalui CRI yang didukung.

  • Jika runtime sesuai, verifikasi bahwa perintah memenuhi persyaratan. Lihat Batasan.

ContainerStateAbnormal

Status kontainer tidak normal.

Pastikan kontainer sedang berjalan. Cloud Assistant hanya menjalankan perintah dalam kontainer yang sedang berjalan. Gunakan kubectl atau Cloud Assistant Agent untuk memeriksa. Kontainer sedang berjalan jika State bernilai Running. Lihat Gunakan Cloud Assistant untuk menjalankan perintah dalam kontainer.

ContainerNotFound

Kontainer tidak ada.

Verifikasi keberadaan kontainer berdasarkan nama atau ID.

Metode 1: Gunakan kubectl

kubectl --namespace <namespace yang ditentukan> describe pod <pod yang ditentukan>

Metode 2: Gunakan Cloud Assistant Agent

aliyun-service list-containers --source cri --all

Lihat Gunakan Cloud Assistant untuk menjalankan perintah dalam kontainer.

ContainerNameDuplicated

Kontainer target tidak dapat diidentifikasi karena beberapa kontainer di node memiliki nama yang sama.

ContainerNameAndIdNotMatch

ID kontainer dan nama kontainer yang ditentukan tidak cocok.

Verifikasi bahwa ID dan nama kontainer merujuk ke kontainer yang sama.

Jalankan perintah sebagai pengguna non-default di Windows

Masalah berikut mungkin terjadi saat menjalankan perintah di instans Windows sebagai pengguna non-default.

Kode kesalahan

Pesan kesalahan

Solusi

UserOrPasswordInvalid

Username atau password salah.

Username atau password salah. Lihat Parameter terenkripsi dan Tetapkan pengguna reguler untuk menjalankan perintah Cloud Assistant.

QueryParameterStoreFailed

Gagal mengambil parameter dari penyimpanan parameter.

Verifikasi bahwa password ada di penyimpanan parameter CloudOps Orchestration Service. Lihat Parameter terenkripsi.

Verifikasi bahwa instance RAM role memiliki izin yang diperlukan. Lihat Konfigurasikan RAM role untuk instans Windows.

InstanceRoleInvalid

RAM role tidak dilampirkan ke instans.

Panggil DescribeInstanceRamRole untuk memeriksa apakah RAM role dilampirkan ke instans.

Hentikan perintah

Kode kesalahan

Pesan kesalahan

Solusi

TerminationException

Gagal menghentikan tugas.

Periksa bidang ErrorInfo, atau coba ulang perintah.

Mengirim file

Kode kesalahan

Pesan kesalahan

Solusi

FileAlreadyExists

File dengan nama yang sama sudah ada di jalur tujuan.

Atasi dengan salah satu cara berikut:

  • Hapus file yang ada dari jalur tujuan.

  • Timpa file yang ada.

    • Di Overwrite, aktifkan Overwrite saat mengunggah file.

    • Saat memanggil SendFile, atur parameter Overwrite ke true.

3. Ubah jalur tujuan atau nama file di instans target.

FileNameInvalid

Nama file tidak valid.

Pastikan nama file mengikuti konvensi penamaan Windows atau Linux.

  • Di File Name, pastikan nama tersebut valid.

  • Saat memanggil SendFile, pastikan parameter Name valid.

FilePathInvalid

Jalur file tidak valid.

Pastikan jalur file mengikuti konvensi jalur Windows atau Linux.

  • Di Destination Path, pastikan jalurnya valid.

  • Saat memanggil SendFile, pastikan parameter TargetDir menentukan jalur yang valid.

FileAuthorityInvalid

Izin file tidak valid.

Sesuaikan izin file. Ini hanya berlaku untuk instans Linux dan menggunakan format yang sama seperti chmod.

UserGroupNotExists

Kelompok pengguna yang ditentukan tidak ada di instans.

Kelompok default: root. Buat kelompok pengguna di instans Linux.

Contoh perintah: groupadd <nama_kelompok>, di mana <nama_kelompok> adalah nama kelompok pengguna baru.

FAQ

T: Saat saya menggunakan Cloud Assistant untuk menjalankan skrip PowerShell di server Windows, mengapa output menampilkan karakter acak, dan bagaimana cara memperbaikinya?

J: Lingkungan PowerShell yang digunakan oleh Cloud Assistant tidak menggunakan encoding output UTF-8 secara default.

Karakter non-ASCII (seperti karakter Tionghoa) ditampilkan sebagai teks acak karena konsol tidak dapat menguraikannya dengan benar.

Dua solusi:

  1. Modifikasi skrip: Tambahkan encoding UTF-8 di awal skrip.

    Di Windows Server 2022, Cloud Assistant menangani pengkodean karakter Tionghoa dengan benar secara default. Tidak perlu pengaturan UTF-8 manual.

    Tambahkan di awal skrip PowerShell Anda:

    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
    
    Write-Output "Testing Chinese output..."
  2. Modifikasi Launcher: Di opsi lanjutan Cloud Assistant, atur encoding sebelum eksekusi.

    Di opsi lanjutan, masukkan di bidang Launcher:

    powershell -command [Console]::OutputEncoding=[System.Text.Encoding]::UTF8;{{ACS::ScriptFileName|Ext(.ps1)}};exit $LastExitCode

    Ini menerapkan encoding UTF-8 ke semua skrip PowerShell dalam tugas ini. Tidak perlu mengubah skrip secara individual.