Tarım için Azure Data Manager için API azaltma kılavuzu
Azaltma, kaynakların aşırı kullanılmasını önlemek için bir hizmete yönelik istek sayısını bir zaman aralığında sınırlar. Tarım için Azure Data Manager'da REST API'nin azaltması, hizmetin API'lerini çağıran müşteriler için bir zaman aralığı içinde daha tutarlı performans sağlar.
Tarım için Azure Data Manager yüksek hacimli istekleri işleyebilir. Birkaç müşteriden çok fazla sayıda istek oluşursa azaltma, tüm müşteriler için en iyi performansı ve güvenilirliği korumaya yardımcı olur.
Azaltma sınırları, seçilen sürüme ve müşterinin kullandığı ürünün özelliklerine bağlıdır. Tarım için Azure Data Manager iki farklı sürümü destekler:
- Standart: Genel olarak önerdiğimiz sürüm.
- Temel: Prototip oluşturma gereksinimleri için uygundur.
Bu sınırlar, trafikteki ani dalgalanmalara karşı koruma sağlamak için üç zaman penceresi (bir dakika başına, beş dakikada bir ve bir ay) içinde çalışır.
Bu makalede, sınıra ulaşmadan önce kalan istek sayısını izleme ve sınıra ulaştığınızda yanıt verme işlemleri gösterilir. Azaltma sınırları bu API'ler için geçerlidir.
API'lerin sınıflandırılması
Tarım api'leri için Azure Data Manager üç ana kategoriye ayrılır:
- Yazma işlemleri: Verileri değiştirmek için ,
POSTveDELETEgibiPATCHREST API yöntemlerini kullanan API'ler. - Okuma işlemleri: Yöntem türündeki
GETarama API'leri de dahil olmak üzere verileri almak için REST API yöntem türünüPOSTkullanan API'ler. - Uzun süre çalışan iş işlemleri: REST API yöntem türünü
PUTkullanan uzun süre çalışan zaman uyumsuz iş API'leri.
Aşağıdaki tabloda açıklandığı gibi genel kullanılabilir kota birimleri bu kategoriler arasında paylaşılır. Örneğin, yazma işlemlerinde kotanın tamamının kullanılması, diğer işlemler için kotanın kalmadığını gösterir. Her işlem belirli bir kota birimi kullanır ve bu da daha fazla kullanım için kalan kotayı izlemenize yardımcı olur.
| İşlem | Her istek için birim maliyet |
|---|---|
| Write | 5 |
| Okundu | 1 1 |
| Uzun süre çalışan iş: çözüm çıkarımı | 5 |
| Uzun süre çalışan iş: grup işlemi | 5 |
| Uzun süre çalışan iş: görüntü tarama | 2 |
| Uzun süre çalışan iş: bir varlığın art arda silinmesi | 2 |
| Uzun süre çalışan iş: hava durumu alımı | 1 |
| Uzun süre çalışan iş: uydu alımı | 1 |
1Birden fazla öğeyi alırken yanıtta döndürülen her öğe için ek birim maliyet dikkate alınır.
Temel sürüm için API sınırları
Aşağıdaki tabloda, Temel sürüm için kategori başına kullanılabilir toplam birim sayısı listelenir:
| İşlem | Azaltma zaman penceresi | Her zaman penceresinden sonra birimler sıfırlanır |
|---|---|---|
| Yazma/okuma | Bir dakikada bir | 25,000 |
| Yazma/okuma | Beş dakikada bir | 100.000 |
| Yazma/okuma | Bir ayda bir | 5,000,000 |
| Uzun süre çalışan iş | Beş dakikada bir | 1000 |
| Uzun süre çalışan iş | Bir ayda bir | 100.000 |
Standart sürüm için API sınırları
Standart sürüm, Temel sürüme kıyasla api kotasında ayda beş kat artış sunar. Diğer tüm kota sınırları değişmeden kalır.
Aşağıdaki tabloda, Standart sürüm için kategori başına toplam kullanılabilir birim listelenir:
| İşlem | Azaltma zaman penceresi | Her zaman penceresinden sonra birimler sıfırlanır |
|---|---|---|
| Yazma/okuma | Bir dakikada bir | 25,000 |
| Yazma/okuma | Beş dakikada bir | 100.000 |
| Yazma/okuma | Bir ayda bir | 25.000.000 1 |
| Uzun süre çalışan iş | Beş dakikada bir | 1000 |
| Uzun süre çalışan iş | Bir ayda bir | 500.000 1 |
1Bu sınır, Temel sürüm sınırının beş katıdır.
Hata kodu
Sınıra ulaştığınızda HTTP durum kodu 429 Çok fazla istek alırsınız. Yanıt, bir sonraki isteği göndermeden önce uygulamanızın beklemesi (veya uyku moduna geçmesi) gereken saniye sayısını belirten Bir Yeniden Deneme-Sonra değeri içerir.
Yeniden deneme değeri tamamlanmadan önce bir istek gönderirseniz, isteğiniz işlenmez ve yeni bir yeniden deneme değeri döndürülür. Belirtilen süre dolduktan sonra, Tarım için Azure Data Manager'a yeniden istekte bulunabilirsiniz. TCP bağlantısı kurmaya veya farklı kullanıcı kimlik doğrulama yöntemleri kullanmaya çalışmak, her kiracıya özgü olduğundan bu sınırları atlamaz.
Sık sorulan sorular
Ayrılmış API kotasını dakika başına bir zaman penceresindeki yazma işlemleri için tamamen tüketirsem, aynı zaman penceresinde okuma işlemleri için başarıyla istekte bulunabilir miyim?
Kota sınırları, listelenen işlem kategorileri arasında paylaşılır. Yazma işlemleri için kotanın tamamının kullanılması, diğer işlemler için kotanın kalmadığını gösterir. Bu makalede, her işlem için kullanılan belirli kota birimlerinin ayrıntıları verilmektedir.
Belirli bir zaman aralığı için izin verilen başarılı isteklerin toplam sayısını nasıl hesaplayabilirim?
İzin verilen toplam başarılı API isteği sayısı, sağladığınız sürüme ve istekte bulunmak istediğiniz zaman penceresine bağlıdır.
Örneğin, Standart sürüm ile, bir dakikalık bir zaman penceresi içinde 25.000 (her zaman penceresinden sonra birim sıfırlama) / 5 (her istek için birim maliyet) = 5.000 yazma işlemi API'leri yapabilirsiniz. Ya da 4.000 yazma işlemi ve 5.000 okuma işlemi birleşimini kullanabilirsiniz; bu da 4.000 * 5 + 5.000 * 1 = 25.000 toplam tüketim birimiyle sonuçlanabilir.
Benzer şekilde, Temel sürüm için bir aylık zaman aralığı içinde 5.000.000 (her zaman penceresinden sonra birim sıfırlama) / 1 (her istek için birim maliyet) = 5.000.000 okuma işlemi API'sini gerçekleştirebilirsiniz.
Bir müşteri maksimum sayı olarak kaç sensör olayı alabilir?
Sistem saatte en fazla 100.000 olay alımına izin verir. Yeni olaylar sürekli kabul edilse de işlemede gecikme olabilir. Gecikme, bu olayların alımın yanı sıra gerçek zamanlı çıkış senaryolarında hemen kullanılamayabileceği anlamına gelebilir.