Alibaba Cloud Command Line Interface (CLI), API'leri temel alan genel amaçlı bir komut satırı aracıdır. Alibaba Cloud CLI kullanarak File Storage NAS (NAS) ile etkileşim kurabilir ve kabuk aracılığıyla NAS kaynaklarınızı yönetebilirsiniz. Bu konuda, NAS API işlemlerini çağırmak için Alibaba Cloud CLI'nin nasıl kullanılacağı açıklanmaktadır.
Arka plan bilgileri
Alibaba Cloud CLI hakkında daha fazla bilgi için bkz. Alibaba Cloud CLI nedir
Alibaba Cloud CLI yükleme
Alibaba Cloud CLI'yi kullanabilmeniz için öncelikle yüklemeniz gerekir. Alibaba Cloud CLI'yi Windows, Linux ve macOS işletim sistemlerine yükleyebilirsiniz. Cihazınızın işletim sistemine uygun bir Alibaba Cloud CLI yükleme paketi seçin. Daha fazla bilgi için aşağıdaki konulara bakın:
Alibaba Cloud tarafından sağlanan Cloud Shell hizmetini kullanarak da Alibaba Cloud CLI'de çalıştırmak istediğiniz komutları hata ayıklama modunda test edebilirsiniz. Cloud Shell hakkında daha fazla bilgi için bkz. Cloud Shell nedir?
Alibaba Cloud CLI yapılandırma
Bir Alibaba Cloud hesabı tüm API işlemlerini çağırma iznine sahiptir. Alibaba Cloud hesabı kullanarak işlem yapmak yüksek risklidir. API işlemlerini çağırmak veya rutin bakım ve onarım (O&M) işlemleri yürütmek için RAM (Resource Access Management) kullanıcıları kullanmanızı öneririz. RAM kullanıcısına AliyunNASFullAccess ilkesini eklemelisiniz.
Alibaba Cloud CLI'yi kullanmadan önce kimlik bilgileri ve bölge ID gibi kimlik doğrulama bilgilerini Alibaba Cloud CLI içinde yapılandırmanız gerekir. Alibaba Cloud CLI çeşitli kimlik bilgisi türlerini destekler. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma ve yönetme. Bu örnekte AccessKey kimlik bilgileri kullanılmaktadır. Aşağıdaki adımları uygulayın:
İş gereksinimlerinize göre bir RAM kullanıcı oluşturun ve bu kullanıcıya Alibaba Cloud hizmetlerini yönetme izni verin. Daha fazla bilgi için bkz. RAM kullanıcı oluşturma ve RAM kullanıcı izinlerini yönetme.
RAM kullanıcıyı oluşturup yetkilendirdikten sonra bu kullanıcı için bir AccessKey çifti oluşturun ve sonraki kimlik bilgisi yapılandırması aşamasında kullanmak üzere
AccessKey IDileAccessKey Secretdeğerlerini kaydedin. Daha fazla bilgi için bkz. AccessKey oluşturma.-
Bir bölge ID belirtin. Alibaba Cloud CLI belirtilen bölgedeki API işlemlerini çağırır. Kullanılabilir bölgeler hakkında daha fazla bilgi için bkz. Uç noktalar.
RAM kullanıcısının AccessKey çiftini kullanarak AkProfile adlı yapılandırma dosyasında kimlik bilgilerini yapılandırın. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma ve yönetme.
CLI komutu oluşturma
OpenAPI Portal adresine gidin.
-
API hata ayıklama sayfasında kullanmak istediğiniz API'yi sol taraftaki arama kutusunda arayabilirsiniz. Parametre Yapılandırması bölümünde API belgelerine göre parametreleri girin ve ardından Parametre Yapılandırmasının sağındaki CLI Örneği sekmesine tıklayarak parametrelerle birlikte bir komut örneği oluşturun.
Komutu hızlıca hata ayıklamak için Komutu Çalıştır seçeneğine tıklayarak Cloud Shell hizmetini açın.
-
Komut örneğini panoya kopyalamak için Kopyala seçeneğine tıklayın. Daha sonra bu komutu yerel kabuk aracınıza yapıştırarak çalıştırabilirsiniz.
CLI komutunu yerel kabuğa kopyalayıp yapıştırırken parametre formatlarına dikkat edin. Alibaba Cloud CLI parametre formatları hakkında daha fazla bilgi için bkz. Komut parametrelerini anlama.
Varsayılan olarak OpenAPI Explorer'da oluşturulan örnek komuta
--regionseçeneği eklenir. Komutu kabuk aracınıza kopyaladığınızda Alibaba Cloud CLI varsayılan kimlik bilgisi yapılandırmaları ve ortam değişkeni ayarlarındaki bölge bilgilerini yoksayar ve komutu öncelikli olarak belirtilen bölgede çalıştırır. İş gereksinimlerinize göre bu seçeneği silebilir veya koruyabilirsiniz.
NAS API işlemlerini çağırmak için Alibaba Cloud CLI kullanma
Sözdizimi
Alibaba Cloud CLI'de komutları çalıştırmak için aşağıdaki sözdizimini kullanabilirsiniz. Daha fazla bilgi için bkz. OpenAPI Explorer ile CLI komutları oluşturma ve çalıştırma.
aliyun <command> <subcommand> [options and parameters]
Komut seçenekleri
Alibaba Cloud CLI'yi kullanırken komutların davranışlarını değiştirmek veya genişletilmiş özelliklerini uygulamak için komut seçeneklerini belirtebilirsiniz. Sık kullanılan komut seçenekleri şunlardır:
--profile<profileName>:
--profileseçeneğini ve profileName parametresini kullanarak bir yapılandırma profili belirttiğinizde Alibaba Cloud CLI varsayılan kimlik bilgisi ve ortam değişkeni yapılandırmalarını yoksayar ve komutları çalıştırmak için belirttiğiniz yapılandırmaları kullanır.--help: Bir komutla ilgili yardım bilgilerini almak için--helpseçeneğini belirtebilirsiniz. Daha fazla bilgi için bkz. Yardım komutunu kullanma.
Örnekler
Aşağıdaki örneklerde komutlar Windows Komut İstemi'nde çalıştırılmaktadır. Diğer işletim sistemlerinde komut parametre formatları farklılık gösterebilir. Alibaba Cloud CLI parametre formatları hakkında daha fazla bilgi için bkz. Komut parametrelerini anlama.
-
Örnek 1: Kullandıkça öde Genel Amaçlı Kapasite Ağ Dosya Sistemi (NFS) dosya sistemi oluşturmak için NAS'in CreateFileSystem işlemini Alibaba Cloud CLI ile çağırma.
-
Aşağıdaki komutu çalıştırın:
aliyun nas CreateFileSystem --FileSystemType standard --ChargeType PayAsYouGo --StorageType Capacity --ProtocolType NFS -
Komut çıktısını görüntüleyin.
{ "FileSystemId": "6a2464****", "RequestId": "3879AB9C-1DED-5A49-A015-350138B23BF0" }
-
-
Örnek 2: Adı vpc_test olan bir izin grubu oluşturmak için NAS'in CreateAccessGroup işlemini Alibaba Cloud CLI ile çağırma.
-
Aşağıdaki komutu çalıştırın:
aliyun nas CreateAccessGroup --AccessGroupName vpc_test --AccessGroupType Vpc -
Komut çıktısını görüntüleyin.
{ "AccessGroupName": "vpc_test", "RequestId": "95CB3005-C251-5E11-A949-29CB2C7A9C54" }
-
Bir NAS API işlemini çağırdıktan sonra hata döndürülürse döndürülen hata koduna göre istek parametrelerinin ve değerlerinin geçerli olup olmadığını kontrol etmeniz gerekir.
Sorunu teşhis etmek için yanıttaki RequestID veya SDK hata mesajını OpenAPI Tanılama Platformu ile birlikte de kullanabilirsiniz.