API Bazlı Kota (API-Based Quota)
API Bazlı Kota, belirli bir API'ye belirli bir süre içinde gidecek isteklerin sayısını sınırlandırmak için kullanılır.
API Bazlı Kota politikası ile tanımlanan mesaj sayısına ulaşıldığında belirtilen süre tamamlanana kadar Backend API'ye yeni istek yönlendirilmez. Böylece Backend API'ye belirlenen süre içinde gelebilecek mesaj sayısı kontrol altına alınmış olur.
Örneğin, toplam API isteği sayısı 1.000.000/gün (gün başına 1.000.000 istek) olarak sınırlandırılmışsa ve mesaj sayısı günlük 1.000.000 mesajın üzerine çıkarsa, istemciye 403 HTTP durum koduyla beraber çok fazla istekte bulunulduğunu belirten bir hata mesajı döndürülür.
API Bazlı Kota politikasının API Bazlı Daraltma politikasından farkı, sınırlamanın yapıldığı zaman aralığıdır. Daraltma politikası için zaman aralığı saniye veya dakika olabilirken, Kota politikası için zaman aralığı saat, gün ya da ay olabilir.
Ekran Yapısı ve Bileşenler
Bu ekran, sistemde tanımlı tüm API-Based Quota politikalarının genel görünümünü sağlar.
| Bileşen | Açıklama |
|---|---|
| Breadcrumb (Üst Navigasyon) | - Bulunduğunuz konumu gösterir - Hızlı geri dönüş için tıklanabilir |
| Import Button (İçe Aktar Butonu) | - Daha önce dışa aktarılmış politikaları yükler - ZIP formatında politika dosyalarını destekler |
| Create Button (Oluştur Butonu) | - Yeni API-Based Quota politikası oluşturur - Form sayfasına yönlendirir |
| Search by Name (İsme Göre Ara) | - Politika isminde arama yapar - Gerçek zamanlı filtreleme sağlar - Boş bırakıldığında tüm politikalar gösterilir |
| Tablo Sütunları | - Name: Politika adı (tıklanabilir, detay sayfasına gider) - Interval Time Unit: Kota sıfırlama zaman birimini belirler - Premited Message Count: Belirlenen zaman diliminde izin verilen maksimum mesaj sayısı |
| Actions Menu (⋮) | - View: Görüntüle - Edit: Düzenle - Delete: Sil - Export: Dışa Aktar |
| Sayfalama Kontrolleri | - Toplam kayıt sayısını gösterir - Sayfa başına gösterilecek kayıt sayısını ayarlar (10, 25, 50, 100) - İleri/Geri sayfa geçişi yapılabilir |
Yeni API-Based Quota Politikası Oluşturma:
Bu ekranda kullanıcı, mevcut politikaları dışarıdan içe aktarabilir veya Create butonuna tıklayarak yeni bir API-Based Quota politikası oluşturabilir.
- Kullanıcı mevcut politikaları dışarıdan içe aktarmak isterse, Import API Based Quota Policies seçeneğini kullanarak içe aktarma sihirbazını açabilir.
Bu ekranda, dışa aktarılmış (export edilmiş) politikalar .json veya .zip formatında sisteme yüklenir. Add a file butonuna tıklanarak dosya seçilir ve içe aktarma işlemi tamamlanır.
Böylece daha önce dışarı alınan politikalar yeniden kullanılabilir hale getirilir.
- Kullanıcı yeni bir politika oluşturmak isterse, Create butonuna tıklayarak yeni bir API Based Quota politikası tanımlama ekranını açabilir.
Politika ayarlarını içeren görsele aşağıda yer verilmiştir:
Politika konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.
Alan | Açıklama |
|---|---|
İsim (Name) | Politikanın kullanımını ve yönetimini kolaylaştırmak için isim yazılabilir. Politika seçimlerinde bu isme ihtiyacınız olabilir. |
Açıklama (Description) | Politikanın kullanımını ve yönetimini kolaylaştırmak için açıklama yazılabilir. |
Yanıt Başlığında Rate Limit İstatistiklerini Göster (Show Rate Limit Statistics in Response Header) | Aktifleştirilir ise yanıt başlığında Rate Limit istatistiklerini gösterir. |
Uygula (Apply by) | Belirli bir değişken üzerinden bu politikanın çalışması için değişken seçilebilir. Opsiyoneldir. |
Mesaj Sayısı (Quota Count) | Kota Aralığı (Quota Interval) ile verilen süre içinde Backend API'ye gönderilebilecek olan maksimum mesaj sayısıdır. |
Daraltma Zaman Miktarı (Interval Time Amount) | Seçilen zaman birimi cinsinden, sınırlama penceresinin süresini belirten sayısal değerdir. |
Daraltma Zaman Birimi (Interval Time Unit) | API istek sınırlaması için kullanılan zaman aralığı birimi (örneğin, saniye, dakika). |
| Her hedef için özel kota sınırları tanımlanır. | |
Periyot Tipi (Interval Window Type) | API istek sınırlaması için kullanılan zaman aralığı yöntemi (sabit veya kayan). |
Cache Bağlantısı Zaman Aşım Süresi (Cache Connection Timeout (Second)) | Cache bağlantısı için zaman aşımı süresi belirtilir. |
Cache Bağlantı Hatası Eylemi (Action for Cache Connection Error) | Eğer politika cache sunucusuna bağlantı sorunu yaşarsa uygulanacak eylem belirtilir. |
Cache'de günlük kota bilgileri de tutulmaktadır. Kota bilgileri UTC timezone'a göre sıfırlanır.
Eğer günlük değişen kotanın başlangıç zamanını kendi yerel saatinize göre sıfırlanmasını istiyorsanız yönetim sayfasındaki sunucu ayarlarında cache sunucusunun ek değişkenlerine CACHE_QUOTA_TIMEZONE değerini ekleyebilirsiniz.
Koşullar (Conditions) ve Hata Mesajı Özelleştirme (Error Message Customization) panellerinin detayı için Politikalar (Policies) sayfasını ziyaret edebilirsiniz.
Throttling ve Quota’nın kullanım farkı için Rate Limit, Throttling ve Quota Management'a Kapsamlı Bir Bakış sayfasını ziyaret edebilirsiniz.
Politika Üzerinde Gerçekleştirilebilen İşlemler:
API Based Quota ekranında, her bir kayıt satırının sonunda bulunan üç nokta (⋮) menüsü aracılığıyla kayıt üzerinde çeşitli işlemler yapılabilir (View, Delete, Export). Bu menü, ilgili politikanın yönetim ve bakım işlemlerini kolaylaştırmak amacıyla kullanılır.
- Görüntüle(View)
Bu seçenek, listede seçilen API Based Quota politikasının detaylarını görüntülemeyi sağlar.
View seçeneğine tıklandığında açılan ekranda, seçilen politikanın detay bilgileri aşağıdaki gibi görüntülenir. Kullanıcı bu ekran üzerinden politikanın adını, açıklamasını ve diğer tanımlı bilgileri inceleyebilir.
Politika detayında yer alan butonlar ve işlevleri:
Edit: Politika üzerinde değişiklik yapılmasını sağlar.
Deactivate: Politikayı devre dışı bırakır
Delete: Politikayı kalıcı olarak sistemden siler.
Export: Politikayı .json veya .zip formatında dışa aktarmayı sağlar.
- Sil(Delete)
Bu seçenek, listede seçilen API Based Quota politikasını silmeyi sağlar. Satır sonundaki menüden Delete seçeneği tıklanarak işlem başlatılır:
Silme işlemi başlatıldığında bir onay penceresi (dialog) açılır. Bu pencerede kullanıcıdan işlemi onaylaması istenir:
Onay penceresinde Delete butonuna basıldığında, ilgili politika sistemden kalıcı olarak silinir.
- Dışa Aktar (Export)
Bu seçenek, listede seçilen API Based Quota politikasını dışa aktarmayı sağlar. Satır sonundaki menüden Export seçeneği tıklanarak işlem başlatılır:
Bu işlem sonucunda seçilen API Based Quota politikası dışa aktarılır. Bu özellik, politikaların yedeklenmesi veya ortamlar arası taşınması amacıyla kullanılır.