Bu konuda; temel bilgiler, kullanım kısıtlamaları, faturalama ve çağrı yöntemleri dahil olmak üzere DataWorks OpenAPI'ye genel bir bakış sunulmaktadır.
Temel Bilgiler
|
Sürüm |
OpenAPI portalı |
Desteklenen API'ler |
Desteklenen bölgeler |
|
2024-05-18 (yeni sürüm) |
China (Hangzhou), China (Shanghai), China (Shenzhen), China (Beijing), China (Zhangjiakou), China North 2 Ali Gov 1, China East 2 Finance, China (Chengdu), China (Hong Kong), Singapur, Endonezya (Cakarta), ABD (Silikon Vadisi), ABD (Virginia), Almanya (Frankfurt), Birleşik Krallık (Londra), Japonya (Tokyo) ve Malezya (Kuala Lumpur) Önemli
Data Studio ile ilgili API'lere ilişkin notlar:
Yeni Data Studio'yu kullanıp kullanmadığınızı kontrol edin ve buna karşılık gelen OpenAPI sürümünü seçin. Yanlış sürümü seçmek sorgu hatalarına veya beklenmeyen sonuçlara neden olabilir. |
||
|
2020-05-18 (eski sürüm) |
Sınırlamalar
Bir modülün OpenAPI'si için gereken sürüm gereksinimleri, modülün kendi gereksinimleriyle eşleşir.
-
DataWorks OpenAPI çağrılarını düzenlemek ve sistem kararlılığını korumak amacıyla API'ler okuma veya yazma olarak sınıflandırılır. Farklı DataWorks sürümleri için belirli QPS (saniye başına sorgu) sınırları bulunur. Basic Edition ayrıca günlük bir çağrı sınırına sahiptir; Standard Edition, Professional Edition ve Enterprise Edition için ise böyle bir sınır yoktur. Her sürümün aylık ücretsiz çağrı kotası ve kotayı aşan çağrılar için kullandıkça öde kuralları vardır. Aşağıdaki tabloda bu ayrıntılar özetlenmiştir.
Sürüm
QPS sınırı
Günlük çağrı sınırı
Aylık ücretsiz çağrı kotası
Ücretsiz kota aşıldığında kullandıkça öde
Basic Edition
Tüm API'lerin toplam QPS değeri ≤ 5
Günlük toplam API çağrıları ≤ 100
Ayda 3.100 çağrı
Çağrı sınırları geçerlidir. Ekstra kullandıkça öde faturalaması desteklenmez.
Standard Edition
Günlük çağrı sınırı yok
Ayda 100.000 çağrı
Her 10.000 çağrı için 0,05 USD
Professional Edition
Günlük çağrı sınırı yok
Ayda 500.000 çağrı
Her 10.000 çağrı için 0,05 USD
Enterprise Edition
-
Okuma API'lerinin toplam QPS değeri ≤ 50
-
Yazma API'lerinin toplam QPS değeri ≤ 20
Günlük çağrı sınırı yok
Ayda 1.000.000 çağrı
Her 10.000 çağrı için 0,05 USD
DataWorks altındaki zamanlama görevleri OpenAPI işlemleri üzerinden çalışmaz. OpenAPI çağrı kotasının tükenmesi, zamanlanmış zamanlama görevlerinin veya toplu iş görevlerinin normal şekilde yürütülmesini etkilemez. Yalnızca Python düğümleri veya PyODPS düğümleri gibi OpenAPI işlemlerini doğrudan çağıran görevler etkilenebilir. Üretim ortamındaki zamanlanmış örnekler önceden oluşturulur ve API çağrı kotasına tabi değildir.
ÖnemliAPI QPS ve çağrı sayıları, her bölgedeki her Alibaba Cloud hesabı (RAM kullanıcıları dahil) için kümülatif değer olarak hesaplanır.
QPS sınırı veya Basic Edition günlük çağrı sınırı aşılırsa çağrılar başarısız olur. Buna göre çağrı eşzamanlılığını ve sıklığını kontrol edin.
Basic Edition için başarılı ve başarısız API çağrılarının tümü günlük çağrı sınırına dahildir. Standard Edition, Professional Edition ve Enterprise Edition için günlük çağrı sınırı bulunmaz ve başarısız çağrılar günlük çağrı sınırına dahil edilmez. Aylık ücretsiz çağrı kotasına ve kullandıkça öde faturalama kurallarına dikkat edin.
Her API'nin okuma/yazma türünü adına göre belirleyebilirsiniz. Örneğin,
CreateFilebir yazma API'sidir veListFilesbir okuma API'sidir.
-
Ön Koşul
OpenAPI'yi çağırmadan önce AliyunDataWorksFullAccess izninin etkinleştirildiğinden emin olun. Aksi takdirde yetersiz izin nedeniyle OpenAPI çağrıları başarısız olabilir. Daha fazla bilgi için bkz. AliyunDataWorksFullAccess iznini verme.
Ücretsiz Kota ve Faturalama
Her sürüm için aylık ücretsiz çağrı kotası, kota aşıldığında uygulanacak kullandıkça öde birim fiyatı, QPS sınırları ve günlük çağrı sınırları yukarıdaki Sınırlamalar bölümündeki tabloda özetlenmiştir. Aşağıdaki bilgiler faturalama ölçümleri ve dikkat edilmesi gereken hususlar hakkında ek ayrıntılar sunar.
Her takvim ayında, her bölgedeki her Alibaba Cloud hesabına (RAM kullanıcıları dahil) ücretsiz bir OpenAPI çağrı kotası verilir. Aylık ücretsiz kota DataWorks sürümüne göre değişir.
Basic Edition hem günlük çağrı sınırına hem de aylık ücretsiz çağrı kotasına tabidir (ayrıntılar için yukarıdaki Sınırlamalar bölümüne bakın). Sınır aşıldığında çağrılar reddedilir ve kullandıkça öde faturalaması desteklenmez. Standard Edition ve Professional Edition için günlük çağrı sınırı bulunmaz ve her biri için aylık ücretsiz çağrı kotası vardır (yukarıdaki Sınırlamalar bölümündeki tabloya bakın). Ücretsiz kota aşıldığında kullandıkça öde faturalaması desteklenir. Birim fiyatlar ve ortama özel farklılıklar için bkz. Kaynak maliyetlerinde OpenAPI faturalaması. Enterprise Edition için günlük çağrı sınırı bulunmaz ve ücretsiz kota tükendiğinde aynı kullandıkça öde faturalama kuralları geçerlidir.
DataWorks Standard Edition, Professional Edition ve Enterprise Edition aylık ücretsiz çağrı kotası tükendikten sonra kullandıkça öde fiyatlarıyla API çağrılarının devam etmesini destekler. Uluslararası sitelerde belgede gösterilen birim fiyat ve faturalama geçerlidir. Daha fazla bilgi için bkz. Kaynak maliyetleri. Gerçek faturalama fiyatı, nihai faturanızda görüntülenen fiyata tabidir.
OpenAPI Nasıl Çağrılır
Alibaba Cloud OpenAPI hakkında daha fazla bilgi için bkz. Alibaba Cloud OpenAPI.
Çağrı Yöntemleri
|
Çağrı yöntemi |
Destek durumu |
Açıklama |
|
SDK (önerilen) |
Destekleniyor |
DataWorks SDK tarafından desteklenen diller ve bağımlılık yükleme yöntemleri için bkz. DataWorks SDK. |
|
Destekleniyor |
Yerel HTTP çağrıları, imza algoritmasını uygulamanızı ve HTTP çağrılarını başlatmak için özel istekler oluşturmanızı gerektirir. İmzalama mekanizması hakkında daha fazla bilgi için bkz. İmzalama mekanizması. |
Çağrı Örnekleri
DataWorks SDK (önerilen)
API Stili
RPC stili.
Uç Noktalar
En düşük gecikme süresini elde etmek için DataWorks çalışma alanınızın bulunduğu bölgeye karşılık gelen uç noktayı seçin. Örneğin, China (Zhangjiakou) için VPC uç noktası dataworks-vpc.cn-zhangjiakou.aliyuncs.com şeklindedir. Daha fazla bilgi için bkz. Uç noktalar (2024-05-18) ve Uç noktalar (2020-05-18).
OpenAPI Kullanımını Görüntüleme
Open Platform'u kullanarak ücretsiz kota tüketimi, çağrı sayıları ve çağrı ayrıntıları dahil olmak üzere OpenAPI kullanımınızı görüntüleyebilirsiniz. Daha fazla bilgi için bkz. OpenAPI kullanımını görüntüleme.