Bu konu, ApsaraDB for HBase OpenAPI kullanmanın temellerini açıklar.
OpenAPI'ye genel bakış
Alibaba Cloud, OpenAPI'yi verimli kullanmanıza yardımcı olmak için OpenAPI portalını sunar. Portal; akıllı API araması, dokümantasyon, çevrimiçi hata ayıklama, SDK edinme, kod örnekleri, çağrı hatası tanılama ve çağrı istatistikleri gibi özellikleri bir araya getiren kapsamlı bir üründür. OpenAPI portalında çeşitli Alibaba Cloud ürünlerinin OpenAPI işlemlerini çağırabilir, istekleri ve yanıtları görüntüleyebilirsiniz. Ayrıca hızlı başlangıç yapmanıza olanak tanımak için SDK kod örneklerini otomatik olarak oluşturur. Daha fazla bilgi için bkz. OpenAPI Nedir.
Sürümler
Alibaba Cloud OpenAPI, farklı mimarilere sahip ApsaraDB for HBase kümeleri için API'leri yönetmek üzere sürüm numaralarını kullanır. Aşağıda ApsaraDB for HBase'in desteklediği API sürümleri listelenmiştir.
|
|
|
|
|
|
Çevrimiçi hata ayıklama
ApsaraDB for HBase OpenAPI Portalında API hata ayıklama gibi özellikler sunar. Çağrı yapmadan önce ApsaraDB for HBase tarafından sağlanan sürümler, uç nokta açıklamaları ve entegrasyon yöntemleri gibi bilgileri anlamanız gerekir.
OpenAPI portal sayfasının sol bölmesinde hizmet bölgeleri, kümeler, örnekler, güvenlik ve yedeklemeler gibi kategorileri içeren API gezinme ağacı bulunur. Ortadaki hata ayıklama panelinde bir hizmet adresi seçebilir, AcceptLanguage ve Engine gibi istek parametrelerini yapılandırabilir ve ardından Initiate Call düğmesini tıklayabilirsiniz. Sağ bölmede ise istek ve yanıt parametrelerinin açıklamalarının yanı sıra SDK ve CLI örneklerini içeren dokümantasyon görüntülenir.
Hata ayıklama portalı
ApsaraDB for HBase API hata ayıklama portalı için bkz. API Hata Ayıklama Portalı.
Uç noktalar
Gecikme süresini en aza indirmek için kaynaklarınızla aynı bölgede bulunan bir uç nokta seçin. Örneğin, Çin (Qingdao) bölgesindeki VPC uç noktası hbase.aliyuncs.com şeklindedir.
Genel uç noktalar küresel erişime açıktır.
-
Virtual Private Cloud (VPC), izole edilmiş bir sanal ağdır. VPC uç noktası kullanmanın avantajları şunlardır:
Daha yüksek güvenlik: VPC uç noktalarına yalnızca bir VPC içinde erişilebilir; bu durum gelişmiş güvenlik sağlar.
Daha hızlı yanıt süreleri: VPC uç noktaları bir VPC iç ağı üzerinde çalışır; bu genellikle daha hızlı yanıt alınmasını sağlar ve genel ağ gecikme süresini önler.
Daha düşük maliyet: VPC uç noktaları iç ağ iletişimini kullanır.
Daha fazla bilgi için bkz. istek yapısı.
Kullanıcı kimlikleri
OpenAPI portalında oturum açtığınızda portal, varsayılan olarak çevrimiçi hata ayıklama için mevcut hesabınızı kullanır. Bir Alibaba Cloud hesabı tüm API'lere erişim iznine sahip olduğundan bunun hata ayıklama için kullanılması yüksek bir güvenlik riski oluşturur. Alibaba Cloud hesabınızı çevrimiçi hata ayıklama için kullanmamanızı öneririz. API erişimi ve günlük işletim ve bakım işlemleri için bir RAM kullanıcısı oluşturup kullanmanızı tavsiye ederiz. API işlemlerini çağırmadan önce RAM kullanıcısına yalnızca gerekli izinleri verin. RAM kullanıcısının ApsaraDB for HBase yönetme iznine sahip olması gerekir. Daha fazla bilgi için bkz. Özel RAM yetkilendirme ilkeleri oluşturma.
|
|
|
|
|
|
|
|
|
|
|
|
Entegrasyon yöntemleri
ApsaraDB for HBase Alibaba Cloud SDK'ları ve özel sarmalama dahil olmak üzere birden çok entegrasyon yöntemi sunar. İş ihtiyaçlarınıza en uygun yöntemi seçebilirsiniz.
SDK'lar kolay entegre edilir ve OpenAPI işlemlerini çağırmanın önerilen yoludur.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Alibaba Cloud SDK
Alibaba Cloud Java, C#, Go, Python, PHP ve C++ gibi çeşitli programlama dillerinde SDK'lar sunar. SDK'lar kimlik, kimlik doğrulama ve imzalama kuralları gibi API çağrılarının alt düzey ayrıntılarını yönetir. OpenAPI işlemlerini doğrudan çağırmak için bir SDK entegre etmeniz yeterlidir. Alibaba Cloud SDK'ları hakkında daha fazla bilgi için bkz. Alibaba Cloud SDK.
ApsaraDB for HBase OpenAPI işlemlerini çağırmak için Alibaba Cloud SDK'larını kullanabilirsiniz. Desteklenen diller ve kurulum talimatları için bkz. SDK'ları Yükleme.
Alibaba Cloud CLI
Alibaba Cloud CLI,
aliyunkomutuyla Alibaba Cloud hizmetlerinizi ve kaynaklarınızı yönetmenizi sağlayan bir komut satırı aracıdır. Daha fazla bilgi için bkz. Alibaba Cloud CLI Nedir.ApsaraDB for HBase OpenAPI işlemlerini çağırmak için Alibaba Cloud CLI'yı kullanabilirsiniz. Daha fazla bilgi için bkz. RPC API Çağırma.
Resource Orchestration Service (ROS)
Resource Orchestration Service (ROS), cloud kaynaklarının yönetimini basitleştiren bir Alibaba Cloud hizmetidir. ECS örnekleri ve RDS veritabanı örnekleri gibi gereken Alibaba Cloud kaynaklarını ve bağımlılıklarını tanımlamak için şablonlar yazabilirsiniz. ROS motoru daha sonra şablona göre tüm kaynakları otomatik olarak oluşturur ve yapılandırır; bu da otomatik dağıtım ve işletim ve bakım işlemlerini mümkün kılar. Daha fazla bilgi için bkz. Resource Orchestration Service Nedir.
ApsaraDB for HBase kaynaklarını düzenlemek ve çağırmak için ROS'u kullanabilirsiniz. Desteklenen kaynakların ve veri kaynaklarının listesi için bkz. ROS tarafından desteklenen kaynaklar.
Özel sarmalama
SDK'lar için V3 imzalama dokümantasyonunu izleyerek Alibaba Cloud OpenAPI'ye erişmek üzere özel sarılmış istekler oluşturabilirsiniz. Yerel HTTP çağrıları için imzalama algoritmasını uygulamanız, istekleri oluşturmanız ve ardından göndermeniz gerekir. İmzalama mekanizmasıyla ilgili daha fazla ayrıntı için bkz. V3 istek gövdesi ve imzalama mekanizması.
Notlar
Bir API çağrısı hata döndürürse istek parametrelerinizi ve değerlerinizi kontrol etmek için döndürülen hata koduna bakın. Daha fazla bilgi için bkz. Hata Kodu Merkezi.
Ayrıca yanıtta bulunan RequestID veya SDK hata mesajını kaydedebilir ve kendi kendine tanılama için Alibaba Cloud OpenAPI Tanılama Platformu kullanabilirsiniz.