Tüm Ürünler
Search
Belge Merkezi

ENS:CLI ile ENS kaynaklarını yönetin

Son Güncelleme:Oct 06, 2026

Alibaba Cloud CLI, OpenAPI Explorer üzerine inşa edilmiş genel amaçlı bir komut satırı aracıdır. ENS API işlemlerini çağırma dahil olmak üzere ENS kaynaklarının yönetim ve bakımını otomatikleştirmek için bu aracı kullanabilirsiniz.

Başlamadan önce

Alibaba Cloud CLI'yı tanıyın. Daha fazla bilgi için bkz. Alibaba Cloud CLI nedir?

Alibaba Cloud CLI'yı yükleyin

Alibaba Cloud CLI Windows, Linux ve macOS işletim sistemlerinde kullanılabilir. İşletim sisteminize uygun kurulum paketini seçin:

  • Windows işletim sistemi: Windows.

  • Linux işletim sistemi: Linux.

  • macOS işletim sistemi: macOS.

Alibaba Cloud CLI komutlarını hata ayıklamak için Cloud Shell hizmetini de kullanabilirsiniz. Daha fazla bilgi için bkz. Cloud Shell nedir?

Alibaba Cloud CLI'yı yapılandırın

Önemli

Bir Alibaba Cloud hesabı, tüm Alibaba Cloud hizmetlerinin API'lerine erişme ve bunları yönetme iznine sahiptir. API işlemlerini çağırmak için bir Alibaba Cloud hesabı kullanılması güvenlik riskleri oluşturabilir. API işlemlerini çağırmak veya rutin bakım ve operasyon işlemlerini yürütmek için bir Resource Access Management (RAM) kullanıcısı oluşturmanızı ve bu kullanıcıyı kullanmanızı öneririz.

Alibaba Cloud CLI'yı kullanmadan önce kimlik bilgilerinizi ve bölge kimliğinizi yapılandırın. Alibaba Cloud CLI çeşitli kimlik bilgisi türlerini destekler. Daha fazla bilgi için bkz. Kimlik bilgisi türleri. Bu örnekte AccessKey kimlik bilgileri kullanılmaktadır.

  1. Bir RAM kullanıcısı oluşturun ve gerekli izinleri atayın. Daha fazla bilgi için bkz. RAM kullanıcısı oluşturma ve RAM kullanıcısına izin atama.

    Önemli

    Bu örnek için RAM kullanıcısına AliyunENSFullAccess ilkesini atamanız gerekir. Bu ilke, ENS örneklerini sorgulama ve değiştirme konusunda tam kontrol sağlar. İhtiyaçınıza göre AliyunENSReadOnlyAccess ilkesini veya özel bir ilkeyi de atayabilirsiniz. Daha fazla bilgi için bkz. ENS özel ilkeleri için başvuru.

  2. RAM kullanıcısını oluşturup yetkilendirdikten sonra bu kullanıcı için bir AccessKey çifti oluşturun. Kimlik bilgisi yapılandırması için AccessKey ID ve AccessKey Secret değerlerini kaydedin. Daha fazla bilgi için bkz. AccessKey çifti oluşturma.

  3. Kullanılabilir bir bölgenin kimliğini edinin ve kaydedin. Alibaba Cloud CLI, API çağrılarını başlatmak için belirtilen bölge kimliğini kullanır. Kullanılabilir bölgeler hakkında daha fazla bilgi için bkz. Uç noktalar.

    Not

    Alibaba Cloud CLI'yı kullanırken tek bir komut için bölge belirtmek üzere --region seçeneğini kullanabilirsiniz. Bu seçenek, varsayılan kimlik bilgisi yapılandırmanızdaki ve ortam değişkenlerinizdeki bölge ayarlarını geçersiz kılar. Daha fazla bilgi için bkz. Komut seçenekleri.

  4. RAM kullanıcısının AccessKey çiftini kullanarak AccessKey tabanlı kimlik bilgilerini yapılandırın. Yapılandırma profiline AkProfile adını verin. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma ve yönetme.

CLI komutu oluşturun

  1. ENS API hata ayıklama sayfasına gidin.

  2. API hata ayıklama sayfasında kullanmak istediğiniz API'yi bulmak için sol taraftaki arama kutusunu kullanın. Parameter Configuration bölümünde gerekli parametreleri doldurun. Ardından, Parameter Configuration bölümünün yanındaki CLI Example sekmesine tıklayarak bir komut örneği oluşturun.

    • image simgesine tıklayın. Cloud Shell hizmetine yönlendirilirsiniz. Komutu Cloud Shell içinde hata ayıklayabilirsiniz.

    • CLI komutunu panoya kopyalamak ve komutu yerel kabuğa yapıştırmak için image simgesine tıklayın.

      • Örnek komutu hata ayıklama amacıyla kabuğunuza yapıştırırken parametre formatlarına dikkat edin. Alibaba Cloud CLI parametre formatları hakkında daha fazla bilgi için bkz. Parametre formatları.

      • OpenAPI Explorer tarafından oluşturulan örnek, varsayılan olarak --region seçeneğini içerir. Komutu yerel olarak çalıştırdığınızda Alibaba Cloud CLI bu seçeneği önceliklendirir ve varsayılan kimlik bilgisi yapılandırmanızdaki ile ortam değişkenlerinizdeki bölge ayarlarını yoksayar. Bu seçeneği ihtiyacınıza göre kaldırabilir veya koruyabilirsiniz.

API işlemini çağırın

Söz dizimi

Alibaba Cloud CLI aşağıdaki komut söz dizimini kullanır. Daha fazla bilgi için bkz. Söz dizimi.

aliyun <command> <subcommand> [options and parameters]

Komut seçenekleri

Komut davranışını değiştirmek veya genişletilmiş özellikleri etkinleştirmek için komut seçeneklerini belirtebilirsiniz. Yaygın seçenekler şunlardır:

  • --profile <profileName>: --profile seçeneğini kullanıp geçerli bir yapılandırma adı olan profileName değerini belirttiğinizde, Alibaba Cloud CLI varsayılan kimlik bilgisi yapılandırmasını ve ortam değişkenlerini yoksayar ve komutu çağırmak için belirtilen yapılandırmayı önceliklendirir.

  • --help: Herhangi bir komut düzeyinde ilgili komut için yardım almak üzere --help seçeneğini kullanın. Daha fazla bilgi için bkz. Yardım bilgilerini alma.

Daha fazla bilgi için bkz. API çağrıları için komut satırı seçenekleri.

Çağrı örneği

Aşağıdaki örnekte, bir örneği yeniden başlatmak için ENS içindeki RebootInstance komutu çağrılmaktadır. RebootInstance komutu hakkında daha fazla bilgi için bkz. RebootInstance.

  1. Aşağıdaki komutu çalıştırın:

    aliyun ens RebootInstance --InstanceId i-5xxx8d3x --endpoint ens.aliyuncs.com
  2. Komut çıktısını görüntüleyin.

    {
        "Code": "0",
        "RequestId": "845748BB-9E66-52DB-B4F5-4305601AD2CF"
    }
Not

ENS API işlemini çağırdıktan sonra bir hata döndürülürse girdi parametrelerinin ve değerlerinin hata koduna göre geçerli olup olmadığını kontrol edin.

Yanıttan veya SDK hata mesajından istek kimliğini kaydedebilir ve sorunu tanılamak için Alibaba Cloud OpenAPI Diagnostics hizmetini kullanabilirsiniz.