Tüm Ürünler
Search
Belge Merkezi

Elastic Compute Service:Check Cloud Assistant command results and troubleshoot

Son Güncelleme:Sep 29, 2026

Cloud Assistant komut yürütme sonuçlarını kontrol edin, hataları hata kodlarına göre tanılama adımlarını uygulayın ve yaygın sorunları çözün.

Arka plan

Komutlar eksik bağımlılıklar, ağ sorunları, söz dizimi hataları, hata ayıklama başarısızlıkları veya anormal örnek durumları gibi çeşitli nedenlerle başarısız olabilir. Konsol üzerinden veya API çağrılarıyla yürütme sonuçlarında yer alan hata ayrıntılarını kontrol edin.

Yürütme sonuçlarını görüntüleme

Konsol

  1. ECS konsolu - Cloud Assistant sayfasına gidin.

  2. Sayfanın sol üst köşesinde bir bölge ve kaynak grubu seçin.

  3. Command execution result sekmesine tıklayın.

    • Bir komut başarıyla yürütüldüğünde:

      1. Execution Status değeri Successful olan sonucu bulun.

      2. Actions sütununda View öğesine tıklayın.

      3. Instances sayfasının Task Completed sekmesinde komut çıktısını görüntüleyin.

        Yürütme sonuçları tablosunda Execution Status sütunu Success değerini gösterir ve ExitCode değeri 0 olur. Aşağıdaki alanda komut tarafından döndürülen JSON çıktısı görüntülenir.

    • Bir komut başarısız olduğunda:

      1. Execution Status değeri Task Failed olan sonucu bulun.

      2. Actions sütununda View öğesine tıklayın.

      3. Instances sayfasının Task Failed sekmesinde hata bilgilerini görüntüleyin.

        Yaygın hatalar ve çözümleri için Yaygın yürütme hataları ve çözümleri bölümüne bakın.

        Örnekte ExitCode değeri 5 olup hata açıklaması The command execution ended with a non-zero exit code şeklindedir. Komut çıktısındaki önemli bilgiler şunlardır: Not ECS : False (örneğin bir ECS örneği olduğunu gösterir). Diğer çıktılar arasında Version : 3.5.12, Region ID: cn-hangzhou ve CPU Type : amd64 yer alır.

    • Zamanlanmış bir komut için:

      1. Execution Status değeri Scheduled olan sonucu bulun.

      2. Actions sütununda View öğesine tıklayın.

      3. Instances sayfasında zamanlanmış yürütme ayrıntılarını görüntüleyin.

CLI

CLI kullanımı hakkında bilgi için Alibaba Cloud CLI ile Alibaba Cloud kaynaklarını yönetme konusuna bakın.

  1. InvokeId değerini RunCommand veya InvokeCommand yanıtından alın.

  2. Sonuçları InvokeId ve RegionId parametreleriyle sorgulayın. Aşağıdaki örnekte China (Shanghai) bölgesi kullanılmıştır. Diğer bölge kimlikleri için Bölgeler ve alanlar bölümüne bakın.

    • DescribeInvocations komutuyla yürütme durumunu görüntüleyin:

      aliyun ecs DescribeInvocations --RegionId cn-shanghai --InvokeId t-sh054h*****
    • DescribeInvocationResults komutuyla yürütme sonuçlarını görüntüleyin:

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

API

  1. InvokeId değerini RunCommand veya InvokeCommand yanıtından alın.

  2. InvokeId ve bölge kimliği parametreleriyle DescribeInvocations veya DescribeInvocationResults API işlemini çağırın.

Sorun giderme

Yaygın hatalar

Hata kodu

Hata mesajı

Öneri

InstanceNotRunning

Komut verildiğinde örnek çalışmıyordu.

Örneğin Running durumunda olduğundan emin olun.

InstanceRestarted

Komut yürütülürken örnek yeniden başlatıldı.

Komut yürütme sırasında örneği yeniden başlatmaktan kaçının.

ClientNotRunning

Cloud Assistant Agent çalışmıyor.

Cloud Assistant Agent durdurulmuş veya yüklenmemiş. Aracı başlatın veya yükleyin:

  1. Cloud Assistant Agent sürecini kontrol edin:

    • Linux:

      ps -ef |grep aliyun-service
    • Windows: Görev Yöneticisi'nde aliyun_assist_service sürecinin var olup olmadığını kontrol edin.

  2. Süreç yoksa başlatın:

    • Linux:

      # For Linux systems that support systemctl
      systemctl start aliyun.service
      
      # For Linux systems that do not support systemctl
      /etc/init.d/aliyun-service start
    • Windows: Hizmetler Yöneticisi'nde Aliyun Assist Service'i başlatın.

Not

Cloud Assistant Agent yine de başlatılamazsa yeniden yüklemek için Cloud Assistant Agent'ı yükleme konusuna bakın.

ClientNetworkBlocked

Örnekte ağ bağlantısı sorunları var.

  1. Ağ bağlantısını kontrol edin. Örnek kimliği döndürülüyorsa ağ bağlantısı kurulmuştur.

    curl https://{region-id}.axt.aliyun.com/luban/api/instance/instance-id
  2. Örnek kimliği döndürülmezse güvenlik grubunuzu, güvenlik duvarınızı, DNS'inizi ve yönlendirme tablonuzu kontrol edin. Cloud Assistant'ın erişebilmesi için iç ağ üzerinden TCP bağlantı noktası 443, TCP bağlantı noktası 80 ve UDP bağlantı noktası 53 üzerindeki giden trafiğe izin verin:

    • 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

      OSS paketi özel olduğundan ve yalnızca kurulum paketi dosyası genel okuma izinlerine sahip olduğundan bu alan adının bağlantısını test ederken "AccessDenied" yanıtı alınması beklenir. Bu mesaj başarılı bir bağlantıyı gösterir.

Not
  • {region-id}, örneğin bulunduğu bölgedir; örneğin China (Hangzhou) için cn-hangzhou.

  • Her bölgedeki Cloud Assistant sunucu adresleri için Ayrıntılı yapılandırmalar bölümüne bakın.

SecurityGroupRuleDenied

Bir güvenlik grubu kuralı Cloud Assistant hizmetine erişimi engelliyor.

ClientNotResponse

Cloud Assistant Agent yanıt vermedi.

Cloud Assistant Agent günlüklerini kontrol edin:

  1. Cloud Assistant Agent günlük dosyasını açın. Varsayılan yollar:

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

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

  2. Günlükte komutun InvokeId değerini arayın:

    • Bulunursa, komutun tamamlanıp tamamlanmadığı ve sonucunun bildirilip bildirilmediği gibi istisnalar için çevresindeki girişleri kontrol edin.

    • Bulunamazsa komutu yeniden çalıştırın. Yine başarısız olursa Cloud Assistant Agent'ı yeniden başlatın:

      • Linux:

        # For Linux systems that support systemctl
        systemctl restart aliyun.service
        
        # For Linux systems that do not support systemctl
        /etc/init.d/aliyun-service restart
      • Windows: Hizmetler Yöneticisi'nde Aliyun Assist Service'i yeniden başlatın.

ClientNeedUpgrade

Belirtilen özelliği desteklemek için Cloud Assistant Agent yükseltilmelidir.

  • Gerekli özelliği ve minimum sürümü öğrenmek için ErrorInfo alanını kontrol edin. Cloud Assistant Agent'ı bu sürüme veya daha yeni bir sürüme yükseltin.

ClientNotOnline

Cloud Assistant Agent Cloud Assistant sunucusuna bağlı değil.

Cloud Assistant Agent'ı yeniden başlatın. Bkz. Cloud Assistant Agent'ı durdurma ve kaldırma.

DeliveryTimeout

Cloud Assistant sunucusu komutu Cloud Assistant Agent'a gönderemedi.

Komutu tekrar çalıştırın.

ExecutionTimeout

Komut yürütmesi zaman aşımına uğradı.

Gerektiğinde komut zaman aşımı süresini artırın.

  • Konsolda varsayılan Timeout Period 60 saniyedir. Gerektiğinde artırın.

  • RunCommand çağrılırken varsayılan Timeout değeri 60 saniyedir. Gerektiğinde daha yüksek bir değer belirtin.

  • CreateCommand ardından InvokeCommand kullanıldığında varsayılan Timeout değeri 60 saniyedir. Oluşturma sırasında özel bir değer belirleyin veya daha sonra ModifyCommand ile güncelleyin.

ExecutionException

Komut yürütme sırasında bir özel durum oluştu.

Ayrıntılar için ErrorInfo alanını kontrol edin.

ExitCodeNonzero

Komut sıfırdan farklı bir çıkış koduyla tamamlandı.

Komut betiğini ve çıktısını kontrol edin.

ClientRestarted

Cloud Assistant Agent yeniden başlatıldığı için komut kesintiye uğradı.

Aracı yeniden başlattıktan sonra komutu tekrar çalıştırın. Aracı durumunu Cloud Assistant konsolundan kontrol edebilir veya DescribeCloudAssistantStatus API işlemini çağırabilirsiniz.

InstanceReleased

Komut yürütülürken örnek serbest bırakıldı.

Hedef örnek serbest bırakıldığı için komut başarısız oldu.

DirectoryNotExists

Belirtilen çalışma dizini örnekte mevcut değil.

Örnekte çalışma dizinini oluşturun, ardından komutu tekrar çalıştırın.

Komut çalıştırma

Hata kodu

Hata mesajı

Çözüm

ClientIsUpgrading

Cloud Assistant Agent yükseltiliyor.

Yükseltme tamamlandıktan sonra komutu tekrar çalıştırın. Aracı durumunu Cloud Assistant konsolundan kontrol edebilir veya DescribeCloudAssistantStatus API işlemini çağırabilirsiniz.

InstanceDeregistered

Yönetilen örnek kaydından silindi.

Yönetilen örnek kaydından silindiği için komut başarısız oldu.

InvalidSystemBuiltInParameter

Yerleşik ortam parametresi geçersiz.

Yerleşik ortam parametresi desteklenmiyor. Desteklenen parametreler için RunCommand içindeki CommandContent parametresine bakın.

DefaultWorkingDirectoryNotAvailable

Örnekteki varsayılan çalışma dizini kullanılamıyor.

Varsayılan çalışma dizinini kontrol edin:

  • Linux: Kök kullanıcının ev dizini varsayılan olarak /root olur.

  • Windows: Cloud Assistant Agent sürecini içeren dizin, örneğin C:\Windows\System32.

Konsoldan veya RunCommand API işleminin WorkingDir parametresiyle bir çalışma dizini de belirtebilirsiniz.

CommandNotApplicable

Komut türü belirtilen örnek için geçerli değil.

Her komut türü aşağıdaki işletim sistemlerini destekler:

  • RunBatScript: Windows örnekleri için toplu iş (BAT) komutları.

  • RunPowerShellScript: Windows örnekleri için PowerShell komutları.

  • RunShellScript: Linux örnekleri için kabuk komutları.

InvalidCommandText

Komut içeriği geçersiz.

Komut içeriğini doğrulayın. İçerik düz metin veya Base64 kodlu olabilir.

CommandContentDecodeError

Komut içeriği decode edilemedi.

Base64 kodlu ise kodlamanın doğru olduğunu doğrulayın.

AccountNotExists

Belirtilen kullanıcı örnekte mevcut değil.

Komutu çalıştırmadan önce örnekte kullanıcıyı oluşturun.

  • Varsayılan olarak komutlar Linux ECS örneklerinde root kullanıcısı olarak çalıştırılır.

  • Varsayılan olarak komutlar Windows ECS örneklerinde System kullanıcısı olarak çalıştırılır.

Konsoldan veya RunCommand API işleminin Username parametresiyle komutu başka bir kullanıcı olarak da çalıştırabilirsiniz.

Zamanlanmış komut çalıştırma

Hata kodu

Hata mesajı

Çözüm

BadCronExpression

Cron ifadesi geçersiz.

Cron ifadesini düzeltin. Bkz. Saat tabanlı zamanlama.

CronExpressionExpired

Cron ifadesinin süresi doldu. Zamanlanmış görev çalışmayacaktır.

Süresi dolmamış bir cron ifadesi belirtin.

InvalidGMTOffsetForTimezone

Cron ifadesinde geçersiz GMT ofset saat dilimi biçimi var.

GMT ofset saat dilimi biçimini kontrol edin.

Desteklenen aralık: GMT-12:59 ile GMT+14:59. Dakikalar: 0-59. Saat değeri için baştaki sıfırlar desteklenmez.

InvalidGMTOffsetHourForTimezone

Cron ifadesindeki GMT ofset saati geçersiz.

GMT ofset saat diliminin saat değerini kontrol edin.

Desteklenen aralık: GMT-12:59 ile GMT+14:59. Saat değeri için baştaki sıfırlar desteklenmez.

InvalidGMTOffsetMinuteForTimezone

Cron ifadesindeki GMT ofset dakikası geçersiz.

GMT ofset saat diliminin dakika değerini kontrol edin.

Geçerli değerler: 0 ila 59.

TimezoneInformationCorrupt

Saat dilimi dosyası bozuk olduğu için Cloud Assistant Agent saat dilimi bilgilerini ayrıştıramıyor.

  • Linux: /usr/share/zoneinfo içindeki saat dilimi dosyasını kontrol edin, örneğin /usr/share/zoneinfo/Asia/Shanghai.

  • Windows: Kayıt defterini kontrol edin, örneğin HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.

Not

Saat dilimi dosyası yoksa komutu çalıştırmadan önce dosyayı oluşturun.

InvalidRateExpression

Rate ifadesi geçersiz.

Rate ifadesini düzeltin. Bkz. Sabit aralıklı yürütme.

RateFrequencyTooLarge

Zamanlanmış yürütme sıklığı çok yüksek.

Yürütme sıklığı 7 günü aşamaz.

InvalidAtExpression

Zaman damgası (at ifadesi) geçersiz.

Zaman damgasını düzeltin. Bkz. Belirtilen bir zamanda komutu yalnızca bir kez çalıştırma.

AtExpressionExpired

Zaman damgasının (at ifadesi) süresi doldu. Zamanlanmış görev çalışmayacaktır.

Süresi dolmamış bir zaman damgası belirtin.

Konteynerde komut çalıştırma

Hata kodu

Hata mesajı

Çözüm

InvalidContainerName

Konteyner adı geçersiz.

Ad bir harf veya rakamla başlamalı, yalnızca harfler, rakamlar, noktalar (.), alt çizgiler (_) ve tireler (-) içermeli ve 255 karakterden kısa olmalıdır.

UnsupportedContainerRuntime

Konteyner kimliğinde belirtilen konteyner çalışma zamanı desteklenmiyor.

Yalnızca docker, containerd veya cri-o çalışma zamanlarında Kubernetes tarafından CRI belirtimi üzerinden yönetilen konteynerler desteklenir.

InvalidContainerId

Konteyner kimliği geçersiz.

Konteyner kimliği 64 bitlik onaltılık bir dize olmalıdır. Çalışma zamanını belirtmek için isteğe bağlı olarak bir ön ek (docker://, containerd:// veya cri-o://) ekleyebilirsiniz.

ContainerConnectFailed

Konteynere bağlanılamıyor.

Konteynerin çalışıp çalışmadığını kontrol edin. Konteyner durumunu kontrol etmek için kubectl veya Cloud Assistant Agent'ı kullanın. State değeri Running ise konteyner çalışıyor demektir. Bkz. Cloud Assistant ile konteynerde komut çalıştırma.

  • Çalışıyorsa çalışma zamanını doğrulayın. Yalnızca CRI üzerinden Kubernetes tarafından yönetilen docker, containerd ve cri-o çalışma zamanları desteklenir.

  • Çalışma zamanı uyumluysa komutun gereksinimleri karşıladığını doğrulayın. Bkz. Sınırlamalar.

ContainerStateAbnormal

Konteyner durumu anormal.

Konteynerin çalıştığından emin olun. Cloud Assistant yalnızca çalışan konteynerlerde komut çalıştırır. Durumu kontrol etmek için kubectl veya Cloud Assistant Agent'ı kullanın. State değeri Running ise konteyner çalışıyor demektir. Bkz. Cloud Assistant ile konteynerde komut çalıştırma.

ContainerNotFound

Konteyner mevcut değil.

Konteynerin ada veya kimliğe göre mevcut olduğunu doğrulayın.

Yöntem 1: kubectl kullanma

kubectl --namespace <specified namespace> describe pod <specified pod>

Yöntem 2: Cloud Assistant Agent kullanma

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

Bkz. Cloud Assistant ile konteynerde komut çalıştırma.

ContainerNameDuplicated

Düğümdeki birden fazla konteyner aynı adı paylaştığı için hedef konteyner tanımlanamıyor.

  • Bir konteyner adı belirtiyorsanız düğümde başka konteynerlerin aynı adı paylaşmadığından emin olun.

  • Bunun yerine konteyner kimliğini kullanın. Kimliği kubectl veya Cloud Assistant Agent ile bulun. Bkz. Cloud Assistant ile konteynerde komut çalıştırma.

ContainerNameAndIdNotMatch

Belirtilen konteyner kimliği ile konteyner adı eşleşmiyor.

Konteyner kimliği ve adının aynı konteynere atıfta bulunduğunu doğrulayın.

Windows'ta varsayılan olmayan bir kullanıcı olarak komut çalıştırma

Windows örneğinde varsayılan olmayan bir kullanıcı olarak komut çalıştırırken aşağıdaki sorunlar oluşabilir.


Hata kodu


Hata mesajı


Çözüm


UserOrPasswordInvalid


Kullanıcı adı veya parola yanlış.


Kullanıcı adı veya parola yanlış. Bkz. Şifreli parametreler ve Cloud Assistant komutlarını çalıştırmak için normal bir kullanıcı ayarlama.


QueryParameterStoreFailed


Parametre deposundan parametreler alınamadı.

Parolanın CloudOps Orchestration Service parametre deposunda bulunduğunu doğrulayın. Bkz. Şifreli parametreler.

Örnek RAM rolünün gerekli izinlere sahip olduğunu doğrulayın. Bkz. Windows örneği için RAM rolü yapılandırma.


InstanceRoleInvalid


Örneğe bir RAM rolü atanmamış.


Örneğe bir RAM rolü atanıp atanmadığını kontrol etmek için DescribeInstanceRamRole API işlemini çağırın.

Komut durdurma


Hata kodu


Hata mesajı


Çözüm


TerminationException


Görev durdurulamadı.


ErrorInfo alanını kontrol edin veya komutu yeniden deneyin.

Dosya gönderme

Hata kodu

Hata mesajı

Çözüm

FileAlreadyExists

Hedef yolda aynı ada sahip bir dosya zaten var.

Bu sorunu aşağıdaki yöntemlerden biriyle çözün:

  • Mevcut dosyayı hedef yoldan silin.

  • Mevcut dosyanın üzerine yazın.

    • Dosyayı yüklerken Overwrite seçeneğinde Üzerine Yaz özelliğini etkinleştirin.

    • SendFile API işlemini çağırırken Overwrite parametresini true olarak ayarlayın.

3. Hedef örnekteki hedef yolu veya dosya adını değiştirin.

FileNameInvalid

Dosya adı geçersiz.

Dosya adının Windows veya Linux adlandırma kurallarına uygun olduğundan emin olun.

  • File Name alanında adın geçerli olduğundan emin olun.

  • SendFile API işlemini çağırırken Name parametresinin geçerli olduğundan emin olun.

FilePathInvalid

Dosya yolu geçersiz.

Dosya yolunun Windows veya Linux yol kurallarına uygun olduğundan emin olun.

  • Destination Path alanında yolun geçerli olduğundan emin olun.

  • SendFile API işlemini çağırırken TargetDir parametresinin geçerli bir yol belirttiğinden emin olun.

FileAuthorityInvalid

Dosya izinleri geçersiz.

Dosya izinlerini ayarlayın. Bu yalnızca Linux örnekleri için geçerlidir ve chmod ile aynı biçimi kullanır.

UserGroupNotExists

Belirtilen kullanıcı grubu örnekte mevcut değil.

Varsayılan grup: root. Linux örneğinde kullanıcı grubunu oluşturun.

Örnek komut: groupadd <groupname>; burada <groupname> yeni kullanıcı grubunun adıdır.

SSS

S: Windows sunucusunda Cloud Assistant ile bir PowerShell betiği çalıştırdığımda çıktı neden bozuk karakterler gösterir ve bunu nasıl düzeltebilirim?

C: Cloud Assistant tarafından kullanılan PowerShell ortamı varsayılan olarak UTF-8 çıktı kodlamasını kullanmaz.

Konsol bunları doğru şekilde ayrıştıramadığı için ASCII dışı karakterler (Çince gibi) bozuk metin olarak görüntülenir.

İki çözüm:

  1. Betikte değişiklik yapma: Betiğin başına UTF-8 kodlaması ekleyin.

    Windows Server 2022'de Cloud Assistant Çince karakter kodlamasını varsayılan olarak doğru şekilde işler. Manuel UTF-8 ayarı gerekmez.

    PowerShell betiğinizin başına şunu ekleyin:

    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
    
    Write-Output "Testing Chinese output..."
  2. Launcher'ı değiştirme: Cloud Assistant gelişmiş seçeneklerinde yürütmeden önce kodlamayı ayarlayın.

    Gelişmiş seçeneklerde Launcher alanına şunu girin:

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

    Bu işlem bu görevdeki tüm PowerShell betiklerine UTF-8 kodlaması uygular. Tek tek betiklerde değişiklik yapmanız gerekmez.