OpenAPI Explorer, Alibaba Cloud SDK'leri ve diğer entegrasyon yöntemlerini kullanarak ApsaraDB for ClickHouse API'lerini nasıl çağıracağınızı öğrenin.
OpenAPI
OpenAPI Explorer; API araması, belgelendirme, çevrimiçi hata ayıklama, SDK kod örnekleri, hata tanılama ve çağrı istatistikleri için tek bir platformdur. Alibaba Cloud hizmetlerinde API'leri çağırmak ve test etmek için bu platformu kullanın. OpenAPI nedir?
Sürümler
Her ApsaraDB for ClickHouse küme sürümü farklı bir API sürümü kullanır. Sürümünüzle eşleşen sürümü seçin.
|
|
|
|
|
|
|
|
|
Çevrimiçi hata ayıklama
OpenAPI Explorer'da ApsaraDB for ClickHouse API'leri için hata ayıklama yapabilirsiniz. Çağrı yapmadan önce ApsaraDB for ClickHouse API sürümlerini, uç noktalarını ve entegrasyon yöntemlerini gözden geçirin.
Sol bölmede Region management, Cluster management ve Compute group management gibi API kategorileri listelenir. Bir API seçerek açıklamasını görüntüleyebilir, ZoneId ve RegionId gibi parametreleri yapılandırabilir ve test etmek için Initiate Call öğesini tıklayabilirsiniz. Sağ bölmede parametre açıklamaları ve örnek değerler gösterilir.
API hata ayıklama URL'leri
ApsaraDB for ClickHouse şu sürümlerde kullanılabilir: Community-compatible Edition ve Enterprise Edition. Her sürümün ayrı bir hata ayıklama URL'si vardır.
|
|
|
|
|
|
|
|
|
Uç noktalar
Gecikme süresini en aza indirmek için kaynaklarınızla aynı bölgede bulunan bir uç nokta seçin. Örneğin, China (Zhangjiakou) bölgesindeki bir ApsaraDB for ClickHouse kümesi için genel uç nokta clickhouse.cn-zhangjiakou.aliyuncs.com ve VPC uç noktası clickhouse-vpc.cn-zhangjiakou.aliyuncs.com şeklindedir.
Genel uç noktalar küresel olarak erişilebilir.
-
VPC uç noktaları yalıtılmış bir sanal ağ üzerinde çalışır ve aşağıdaki avantajları sunar:
Daha yüksek güvenlik: Yalnızca VPC içinden erişilebilir.
Daha düşük gecikme süresi: İç ağ kullanılır, genel ağ dalgalanmalarından etkilenmez.
Daha düşük maliyet: İç ağ trafiği veri aktarım maliyetlerini azaltır.
Desteklenen tüm bölgeler ve uç noktalar Hizmet uç noktaları bölümünde listelenmiştir.
Desteklenen kullanıcı kimlikleri
OpenAPI Explorer, varsayılan olarak hata ayıklama için oturum açmış hesabınızı kullanır. Bir Alibaba Cloud hesabı tam API izinlerine sahip olduğundan, API erişimi ve günlük işletim ve bakım (O&M) işlemleri için minimum gerekli izinlere sahip bir RAM kullanıcısı kullanın. RAM kullanıcısına ApsaraDB for ClickHouse yönetimi için izinler verin. RAM yetkilendirmesi.
|
|
|
|
|
|
|
|
|
|
|
|
Entegrasyon yöntemleri
ApsaraDB for ClickHouse birden çok entegrasyon yöntemini destekler: Alibaba Cloud SDK, Terraform, Resource Orchestration Service (ROS) ve özel sarmalama.
SDK'ler entegrasyonu basitleştirir ve OpenAPI'yi çağırmanın önerilen yöntemidir.
|
Entegrasyon yöntemi |
Destekleniyor |
|
Alibaba Cloud SDK |
Evet |
|
Alibaba Cloud CLI |
Desteklenmiyor |
|
Terraform |
Desteklenmiyor |
|
Resource Orchestration Service (ROS) |
Kısmen desteklenir |
|
Özel sarmalama |
Evet |
Alibaba Cloud SDK
Alibaba Cloud SDK'leri Java, C#, Go, Python, Node.js, TypeScript, PHP ve C++ dillerini destekler. SDK'ler kimlik doğrulama ve imzalama işlemlerini yürüttüğünden API'leri doğrudan çağırabilirsiniz. Alibaba Cloud SDK.
ApsaraDB for ClickHouse API'lerini çağırmak için bir Alibaba Cloud SDK'si kullanabilirsiniz. Desteklenen diller ve kurulum adımları ApsaraDB for ClickHouse SDK'ye genel bakış bölümünde yer almaktadır.
Alibaba Cloud CLI
Alibaba Cloud CLI,
aliyunkomutunu kullanarak kabuktan cloud kaynaklarını yönetmenizi sağlar. Alibaba Cloud CLI nedir?.ApsaraDB for ClickHouse API'lerini çağırmak için Alibaba Cloud CLI'yı kullanamazsınız.
Terraform
Terraform, şablonlar aracılığıyla cloud altyapısını sağlama ve yönetme amacıyla kullanılan açık kaynaklı bir araçtır. Alibaba Cloud Terraform nedir?.
ApsaraDB for ClickHouse API'lerini düzenlemek için Terraform kullanamazsınız.
Resource Orchestration Service (ROS)
ROS, şablonlar aracılığıyla cloud kaynağı sağlamayı otomatikleştirir. ECS örnekleri ve RDS örnekleri gibi kaynakları bağımlılıklarıyla birlikte tanımlayın; ROS bunları otomatik olarak oluşturur ve yapılandırır. Resource Orchestration Service nedir?.
ApsaraDB for ClickHouse API'lerini çağırmak için ROS kullanabilirsiniz. Desteklenen kaynak türleri ve veri kaynakları ROS kaynak listesi bölümünde listelenmiştir.
Özel sarmalama
Yerel HTTP çağrıları için V3 imzalama algoritmasını uygulayın ve istekleri manuel olarak oluşturun. V3 için istek gövdesi ve imzalama mekanizması.
Kullanım notları
Bir API çağrısı hata döndürürse istek parametrelerinizi Hata kodu merkezi ile karşılaştırarak doğrulayın.
Sorunları teşhis etmek için yanıttaki RequestID veya SDK hata mesajını Alibaba Cloud OpenAPI Tanılama Platformu üzerinde kullanın.