Cloud Parallel File Storage (CPFS), kaynakları programlı olarak yönetmek için SDK, komut satırı arayüzü (CLI), Terraform ve Resource Orchestration Service (ROS) olmak üzere dört yöntemi destekler.
Bir entegrasyon yöntemi seçin
Alibaba Cloud, geliştiricilerin cloud hizmetlerinin API'lerini hızlı ve verimli bir şekilde öğrenip kullanmalarına yardımcı olmak için OpenAPI Explorer sunar. Akıllı API arama, dokümantasyon, çevrimiçi hata ayıklama, SDK edinimi, kod örnekleri, hata tanılama ve çağrı istatistikleri gibi özellikleri bir araya getirir. Alibaba Cloud hizmetlerinin API'lerini çağırmak ve API istekleri ile yanıtlarını görüntülemek için OpenAPI Explorer'ı kullanabilirsiniz. OpenAPI Explorer ayrıca Alibaba Cloud hizmetlerine başlamanıza yardımcı olmak amacıyla otomatik olarak SDK örnek kodu oluşturur. Daha fazla bilgi için bkz. OpenAPI nedir?.
Sürümler
Alibaba Cloud OpenAPI, hizmetleri için API sürümlerini yönetmek amacıyla sürüm numaralarını kullanır. Örneğin, Cloud Parallel File Storage (CPFS) şu anda 2017-06-26 API sürümünü destekler. Bu tanımlayıcı bir tarih değil, bir sürüm numarasıdır. API veri yapısını temsil eder ve API'nin 2017-06-26 tarihinden bu yana değişmediği anlamına gelmez.
Cloud Parallel File Storage (CPFS) ve Apsara File Storage NAS aynı SDK'yı paylaşır. Bu nedenle, CPFS ile çalışırken Apsara File Storage NAS uç noktalarını ve SDK'sını kullanın.
|
Sürüm |
Açıklama |
|
Önerilen |
Çevrimiçi hata ayıklama
Cloud Parallel File Storage (CPFS), OpenAPI Explorer'da API hata ayıklama gibi özellikler sunar. Bir API'yi çağırmadan önce CPFS tarafından sunulan sürümleri, uç noktaları ve entegrasyon yöntemlerini anlayın.
OpenAPI Explorer hata ayıklama sayfasında, sol gezinme bölmesinde CreateFileSystem, DeleteFileSystem ve DescribeFileSystems gibi dosya sistemi API'leri listelenir. Merkez bölmede ise CreateFileSystem API'si için parametre yapılandırma formu yer alır. Bu formda FileSystemType (geçerli değerler: standard, extreme, cpfs), ChargeType (geçerli değerler: PayAsYouGo, Subscription), Duration, Capacity, Bandwidth, StorageType (gerekli, kırmızı yıldız işaretiyle belirtilmiştir) ve ZoneId gibi alanlar bulunur. Çin Doğu 1 (Hangzhou) gibi belirli bir bölge için bir uç nokta seçebilirsiniz. Sayfanın alt kısmında bir Send Request düğmesi yer alır.
Hata ayıklama giriş noktası
API'yi hata ayıklamak için şuraya gidin Cloud Parallel File Storage (CPFS).
Aşağıdaki tabloda, kullanım durumunuza uygun olanı seçmenize yardımcı olmak için dört entegrasyon yöntemi karşılaştırılmıştır.
|
Yöntem |
Nasıl çalışır |
Ne zaman kullanılır |
|
SDK (önerilen) |
Dile özgü istemci kitaplığı aracılığıyla OpenAPI'yi çağırır. Kimlik doğrulama, yeniden deneme ve yanıt ayrıştırma işlemlerini otomatik olarak yürütür. |
Python, Java, Go veya diğer desteklenen dillerde uygulamalar ya da otomasyon betikleri oluştururken. Çoğu geliştirici için en iyi seçenektir. |
|
CLI |
Komut satırı aracı aracılığıyla OpenAPI'yi çağırır. Kodlama gerektirmez. |
Tek seferlik işlemler çalıştırırken, kabuk betikleri yazarken veya API çağrılarını etkileşimli olarak test ederken. |
|
Terraform |
CPFS kaynaklarını altyapı-kod-olarak (IaC) şeklinde bildirir. Şablonları OpenAPI çağrılarına dönüştürür. |
CPFS kaynaklarını GitOps veya altyapı-kod-olarak (IaC) iş akışı kapsamında diğer cloud altyapısıyla birlikte yönetirken. |
|
Resource Orchestration Service (ROS) |
Şablonlardan kaynak yığınlarını tanımlamak ve dağıtmak için Alibaba Cloud ROS'u kullanır. |
CPFS kaynaklarını daha büyük bir dağıtım yığınının parçası olarak diğer Alibaba Cloud kaynaklarıyla birlikte düzenlerken. |
Uç noktalar
Gecikme süresini en aza indirmek için CPFS kaynaklarınızın bulunduğu bölgeye ait uç noktayı kullanın. Örneğin, Çin (Ulanqab) bölgesindeki CPFS için genel uç nokta nas.cn-wulanchabu.aliyuncs.com ve VPC uç noktası nas-vpc.cn-wulanchabu.aliyuncs.com şeklindedir.
İki tür uç nokta mevcuttur:
Genel uç noktalar — Alibaba Cloud dışından dahil olmak üzere her yerden erişilebilir.
-
VPC uç noktaları — yalnızca aynı Alibaba Cloud bölgesindeki bir sanal özel cloud (VPC) içinden erişilebilir. VPC uç noktalarının avantajları:
Daha yüksek güvenlik: VPC uç noktalarına yalnızca bir VPC içinden ulaşılabilir, bu da daha güçlü izolasyon ve gizlilik sağlar.
Daha düşük gecikme süresi: VPC uç noktaları dahili ağ yollarını kullanır; bu yollar genellikle genel uç noktalara göre daha hızlı yanıt süreleri sunar ve İnternet gecikmesi ile bant genişliği sınırlamaları gibi sorunlardan kaçınmanıza yardımcı olabilir.
Daha düşük maliyet: VPC uç noktaları dahili ağ iletişimini kullanır.
Aşağıdaki tabloda CPFS Genel Amaçlı Sürümü için desteklenen bölgeler ve uç noktalar listelenmiştir.
|
Bölge adı |
Bölge kimliği |
Genel uç nokta |
VPC uç noktası |
|
Çin (Qingdao) |
cn-qingdao |
nas.cn-qingdao.aliyuncs.com |
nas-vpc.cn-qingdao.aliyuncs.com |
|
Çin (Pekin) |
cn-beijing |
nas.cn-beijing.aliyuncs.com |
nas-vpc.cn-beijing.aliyuncs.com |
|
Çin (Zhangjiakou) |
cn-zhangjiakou |
nas.cn-zhangjiakou.aliyuncs.com |
nas-vpc.cn-zhangjiakou.aliyuncs.com |
|
Çin (Hohhot) |
cn-huhehaote |
nas.cn-huhehaote.aliyuncs.com |
nas-vpc.cn-huhehaote.aliyuncs.com |
|
Çin (Ulanqab) |
cn-wulanchabu |
nas.cn-wulanchabu.aliyuncs.com |
nas-vpc.cn-wulanchabu.aliyuncs.com |
|
Çin (Hangzhou) |
cn-hangzhou |
nas.cn-hangzhou.aliyuncs.com |
nas-vpc.cn-hangzhou.aliyuncs.com |
|
Çin (Şanghay) |
cn-shanghai |
nas.cn-shanghai.aliyuncs.com |
nas-vpc.cn-shanghai.aliyuncs.com |
|
Çin (Shenzhen) |
cn-shenzhen |
nas.cn-shenzhen.aliyuncs.com |
nas-vpc.cn-shenzhen.aliyuncs.com |
|
Çin (Heyuan) |
cn-heyuan |
nas.cn-heyuan.aliyuncs.com |
nas-vpc.cn-heyuan.aliyuncs.com |
|
Çin (Chengdu) |
cn-chengdu |
nas.cn-chengdu.aliyuncs.com |
nas-vpc.cn-chengdu.aliyuncs.com |
|
Singapur |
ap-southeast-1 |
nas.ap-southeast-1.aliyuncs.com |
nas-vpc.ap-southeast-1.aliyuncs.com |
Desteklenen kullanıcı kimlikleri
|
Kullanıcı kimliği |
Destek durumu |
|
Desteklenir |
|
|
RAM kullanıcısı (Önerilen) |
Desteklenir |
|
RAM rolü (Önerilen) |
Desteklenir |
API çağrıları yapmak için RAM kullanıcısı veya RAM rolü kullanmanızı ve izinleri belirli iş ihtiyaçlarınıza göre vermenizi öneririz.
Daha fazla bilgi
Entegrasyon yöntemleri
SDK, en basit kurulumu ve en iyi uzun vadeli desteği sunar. Kabuk işlemlerini betikleme (CLI) veya altyapıyı kod olarak yönetme (Terraform veya ROS) gibi belirli bir nedeniniz yoksa bu yöntemi kullanın.
Alibaba Cloud SDK
Alibaba Cloud; Java, C#, Go, Python, Node.js/TypeScript, PHP ve C++ dahil olmak üzere birden çok programlama dili için SDK'lar sunar. Bu SDK'ları kullanarak API'leri çağırabilirsiniz. SDK'lar; imzalama mantığını, zaman aşımlarını, yeniden denemeleri işlemeyi ve yapılandırılmış yanıt nesnelerini döndürmeyi üstlenerek geliştirmeyi basitleştirir. Alibaba Cloud SDK hakkında daha fazla bilgi için bkz. Alibaba Cloud SDK.
OpenAPI Explorer'da Cloud Parallel File Storage (CPFS) API'lerini çağırmak için Alibaba Cloud SDK'yı kullanabilirsiniz. Desteklenen diller ve bağımlılıkların nasıl yükleneceği hakkında bilgi için bkz. Apsara File Storage NAS SDK.
Alibaba Cloud CLI
Alibaba Cloud CLI, aliyun komutunu kullanarak Alibaba Cloud hizmetleriyle etkileşim kurmanıza ve cloud kaynaklarınızı komut satırından yönetmenize olanak tanır. Alibaba Cloud CLI hakkında daha fazla bilgi için bkz. Alibaba Cloud CLI nedir.
Manuel API çağrıları (Önerilmez)
Yerel HTTP çağrıları yapmak için imzalama algoritmasını uygulamanız ve özel istekler oluşturmanız gerekir. İmzalama mekanizması hakkında daha fazla bilgi için bkz. API referansı ve V3 istek gövdesi ve imzalama mekanizması.
Kullanım notları
Bir API çağrısı hata döndürürse, istek parametrelerinizin ve değerlerinizin doğru olduğunu doğrulamak için döndürülen hata kodunu kullanın. Daha fazla bilgi için bkz. Hata Kodu Merkezi.
Ayrıca çağrıdan döndürülen RequestID'yi veya SDK hata mesajını kaydedebilir ve kendi kendine hizmet tanılama için Alibaba Cloud OpenAPI Tanılama Platformu platformunu kullanabilirsiniz.