Limit Planları
Buradaki her ekran ve uç nokta — planlar, atamalar, varsayılan limit politikaları ve Toplu Atama dahil — Kimlik ve Erişim Kontrolü izin grubuyla erişilir (bkz. Erişim Kontrolü ve Roller): okumak için Görüntüle, yazmak için Yönet yetkisi gerekir. Bütçeler izin grubu da Kimlik ve Erişim Kontrolü'nün yerine kabul edilmeye devam eder, böylece hâlâ eski Bütçeler modeli etrafında kurulu bir kurulum değişmeden çalışır.
API tarafında hiçbir aile lisans modülüne bağlı değildir: lisansında AI Gateway bulunmayan bir kurulum da AI Token Bütçesi planlarını Management API ve APIops üzerinden lisanslı bir kurulumla aynı şekilde oluşturur, listeler ve atar. Modülün hâlâ belirlediği şey menü ve ekrandaki aile seçimidir: modül yoksa AI Gateway grubu gizlenir ve Limit Planları bunun yerine Kimlik Yönetimi altından açılır; ayrıca AI Token Bütçesi ailesi katalogda, plan düzenleme ekranında, Toplu Atama akışında ve bir tüketicinin Limits sekmesindeki aile seçicisinde sunulmaz. Tüm aileler seçiliyken de bu ailenin satırları modül lisanssız bir kurulumda listede görünmez — yani Tüm aileler, bu kısıtlamayı aşan bir arka kapı değildir. İstek Hızı planları bu ekranlarda her zamanki gibi oluşturulur, yayınlanır ve atanır — bu aile AI Gateway modülü gerektirmez. Modül lisanslıyken oluşturulmuş bir plan sonradan açıldığında kendi ailesini yine doğru gösterir; mevcut bir planın ailesi zaten salt okunurdur.
Kavramlar
Bu ekranlar üç ayrı fikri birbirinden ayırır: bir plan neyin sınırlandığını tarif eder, bir revizyon o tarifin belirli bir yayınlanmış hâlidir, bir atama ise bu tarifin hangi özneye (API istemcisi ya da kimlik bilgisi) uygulandığını kaydeder.
| Kavram | Anlamı |
|---|---|
| Limit Planı | Adlandırılmış, yeniden kullanılabilir bir bütçe tarifi. Bir kez tanımlanır, birden çok özneye atanabilir; plan üzerinde yapılan bir güncelleme, o plana atanmış tüm öznelere otomatik yansır. |
| Revizyon | Bir planın belirli bir andaki içeriğinin kaydı. Yayınlanmış bir revizyon bir daha değiştirilemez; bir düzeltme her zaman yeni bir revizyon olarak yayınlanır, eskisi geçmişte kalır. |
| Atama | Bir API istemcisinin ya da kimlik bilgisinin (Consumer) belirli bir plana ya da kendine özel bir değere bağlanması. Atama, planın içeriğini kopyalamaz — yalnızca planı işaret eder; plan güncellendiğinde atama da güncel içeriği kullanır. |
Plan Aileleri
Bir plan, oluşturulduğu anda seçilen iki aileden birine aittir:
AI Token Bütçesi — dakika/saat/gün/ay bazlı token limitleri, USD bütçesi, hard/soft cap eşikleri ve bir aşım davranışı (engelle, yalnızca uyar, daha ucuz modele düş, failover).
İstek Hızı — plan gövdesi, plan formunun İstek Hızı Pencereleri bölümünde yapılandırılan bir pencere listesidir; her pencere şu alanları taşır:
| Alan | Anlamı | Varsayılan |
|---|---|---|
| İstek Sayısı | Pencerede izin verilen istek sayısı (pozitif tam sayı). | — |
| Aralık | Zaman biriminin temeli: 1 saniye, 1 dakika, 1 saat, 1 gün ya da 1 ay. | — |
| Periyot Uzunluğu | Kaç aralığın bir pencere oluşturduğu — örn. "5 dakika"lık bir pencere, 1 Dakika aralığında 5 periyot uzunluğudur. | 1 |
| Pencere Tipi | Sabit, her periyodun başında sayacı sıfırlar; Kayan, her istekten geriye doğru periyodu ölçer. | Sabit |
| Sayım Modu | Tüm istekler, kabul edilen ya da reddedilen her isteği pencereye sayar; Yalnızca kabul edilenler, yalnızca geçmesine izin verilen istekleri sayar. | Tüm istekler |
Bir plan en az bir pencere içermelidir; pencereler tek tek eklenir ve kaldırılır (Pencere Ekle / Pencereyi Kaldır). Aynı Aralık/Periyot Uzunluğu ikilisi aynı planda iki kez tanımlanamaz — sunucu bunu reddeder, ekran da kaydetmeden önce uyarır. "Saniyede 100 istek ve günde 10.000 istek" tanımı tek bir planın iki penceresidir, iki ayrı plan değildir.
İstek Hızı ailesi ayrıca, pencerelerinden bağımsız tek bir Aşım Eylemi taşır:
| Aşım Eylemi | Anlamı | Varsayılan |
|---|---|---|
| Engelle | Bir pencere dolduğunda sonraki istekler reddedilir (Retry-After başlıklı 429). | Evet |
| Yalnızca Say | Pencere dolduktan sonra istekler geçmeye ve sayılmaya devam eder — hiçbir şey reddedilmez. | — |
Yalnızca Say, planın sert bir durdurma yerine faturalanan bir aşımı desteklediği durumlar içindir — bkz. aşağıda Portal Abonelik Planından Referans.
Bir planın ailesi, plan oluşturulduktan sonra değiştirilemez — düzenleme ekranındaki aile seçici bu noktadan sonra kilitlenir.
Plan düzenleme ekranı artık ayrı bir Türkçe ad istemez: plan tek bir ada sahiptir. Portalda ve raporlarda gösterilen Türkçe etiket bu adın kendisidir. Bu değişiklikten önce ayrı bir Türkçe ad girilmiş planlar, yeniden kaydedilene kadar o adı korumaya devam eder.
Limit Planları Kataloğu
AI Gateway → Limit Planları yolundan erişilen bu ekran, size görünen tüm planları aile ve serbest metin aramasıyla filtrelenebilir bir liste olarak gösterir. Her satırda planın adı, ailesi, yaşam döngüsü durumu ve — varsa — yayınlanmış revizyon numarası yer alır.
Ekran artık Tüm aileler filtresiyle açılır. Bir aile seçtiğinizde bu tercih tarayıcınızda hatırlanır ve bir sonraki ziyaretinizde otomatik uygulanır. Hatırlanan aile artık sunulmuyorsa (örneğin ilgili lisans modülü kaldırıldıysa) ya da tarayıcınız bu tercihi saklayamıyorsa ekran yeniden Tüm ailelere döner.
Süzgeç eşleşen sonuç bulamadığında liste iki farklı boş durum gösterir: bu kapsamda hiç plan tanımlanmamışsa "Henüz limit planı tanımlanmamış." mesajını, süzgeçle hiçbir plan eşleşmiyorsa "Bu filtreyle eşleşen plan yok." mesajını — bu kapsamda kaç plan tanımlı olduğunu bildiren bir satırla birlikte — görürsünüz. Bu ikinci durumda beliren Filtreyi temizle düğmesi hem serbest metin aramasını hem aile süzgecini birlikte sıfırlar.
Plan Kapsamı: Proje ya da Platform
Her plan, ya bir projenin kendi kataloğuna ya da kurulum genelindeki Platform kataloğuna aittir. Sistem yöneticisi, listenin üstündeki bir kapsam seçiciyle Proje ve Platform arasında geçiş yapar; sistem yöneticisi yetkisi olmayan bir proje üyesi yalnızca kendi projesinin kapsamını görür.
- Proje kapsamlı planlar, kapsamdan bağımsız olarak aynı şekilde oluşturulur, düzenlenir ve öznelere atanır.
- Platform kapsamlı planlar her projeye görünür — bir proje üyesi bunları salt okunur ve Platform rozetiyle görür, bir limit atarken referans verebilir — ama yalnızca sistem yöneticisi oluşturabilir, düzenleyebilir, yayınlayabilir ya da emekliye ayırabilir.
Bir portal API Ürünündeki Abonelik Planı yalnızca eşleşen aileden, yayınlanmış ve platform kapsamlı bir plana referans verebilir — Platform kataloğunu, ticari bir planın sattığı tavanların paylaşılan kaynağı yapan da budur.
Yönetim Modu: Tüm Projeler Tek Listede
Sistem yöneticisi kataloğa Yönetim → Kimlik Yönetimi → Limit Planları yolundan da ulaşır. Bu görünüm tek bir projeye ait değildir: bütün projelerin planlarını ve Platform kataloğunu birlikte listeler; her satırın sahibini gösteren bir Proje sütunu vardır. Böylece bir plan, önce sahibi olan projeye geçmeden bulunup düzeltilebilir.
- Listenin üstündeki kapsam filtresi listeyi Tüm projeler, Platform ya da tek bir projeyle daraltır. Planlar proje kapsamlı kalır — filtre yalnızca neyin gösterileceğine karar verir, bir planı projeler arasında taşımaz.
- Yeni plan oluşturmak somut bir kapsam ister: önce filtreden Platform ya da bir proje seçilir, yeni plan o kapsamda doğar. Tüm projeler seçiliyken oluştur düğmesi devre dışıdır ve nedenini söyler.
- Bir satırı düzenlemek, proje modundaki editörün aynısını açar; editör sahibi olan projeyi (ya da Platform) rozet olarak gösterir. Yayınlama ve emekliye ayırma orada nasıl çalışıyorsa burada da öyle çalışır; taslak bir planı bu listedeki satırından silersiniz.
- Kural atamaları proje kapsamlıdır. Planlar | Kural atamaları seçicisi burada her zaman görünür; filtre Tüm projeler ya da Platform iken Kural atamaları seçildiğinde tablo yerine proje seçtiren kısa bir bilgi kartı gelir — kartta ya da üstteki filtrede bir proje seçildiğinde o projenin kuralları listelenir, Yeni kural ataması proje menüsündekiyle aynı şekilde çalışır. Toplu atama proje modunda kalır: aktif projenin tüketicileri, uygulamaları ve istemcileri üzerinde çalışır.
Abonelik Planına Ait Profiller
Bir portal abonelik planına hız limiti ya da kota girildiğinde, sistem o plana ait bir İstek Hızı profilini kendisi üretir ve plan sayıları her değiştiğinde yeniden yayınlar. Bu profiller de Platform kataloğunda durur ama sıradan katalog kalemi gibi davranmazlar:
- Listede varsayılan olarak görünmezler. Görmek için listenin üstündeki Abonelik planı profillerini göster anahtarını açın; satır Abonelik planı rozetiyle ve sahibi planın adıyla işaretlenir.
- Düzenlenemez, yayınlanamaz, emekliye ayrılamaz ve silinemezler. Bu işlemler denendiğinde ekran "bu limit profili bir portal abonelik planı tarafından yönetiliyor" uyarısını verir. Limitleri değiştirmenin tek yolu ilgili abonelik planının hız limiti ve kota alanlarıdır.
- Bir limit atarken (Limitler sekmesi, toplu atama, kural atamaları) bu profiller seçeneklerde çıkmaz — sahibi plan onları kendi sayılarından yeniden yazdığı için, başka bir özneyi böyle bir profile bağlamak o öznenin tavanını habersiz değiştirirdi.
- Abonelik planı silinirse — ya da planın hız limiti ile kotası birlikte boşaltılırsa — profil emekliye ayrılır, silinmez: ona bağlı atamalar çözümlenmeye devam eder. Emekliye ayrılan profilin açıklaması, hangi plandan geldiğini ve bağın hangi tarihte kaldırıldığını yazacak şekilde yenilenir; böylece satır artık kendisini bir plan tarafından hâlâ yönetiliyormuş gibi tanıtmaz.
Yeni Plan Oluşturma
Yeni Limit Planı düğmesi iki kartlı bir editör açar: planın bilgileri ve planın ilk kural gövdesi. Plan Oluştur düğmesi sayfanın sağ üstünde, Geri düğmesinin yanındadır. Plana bir ad girene kadar düğme pasiftir.
- Ad ve Aile alanları zorunludur. Başlangıç Kural Gövdesi de zorunludur: gövdesi boş bir plan kaydedilmez. Gövde başlığı da zorunluluk işareti taşır ve seçilen ailenin ne istediğini tek satırda yazar. AI Token Bütçesi için en az bir token ya da USD limiti girin. İstek Hızı için en az bir pencere tanımlayın.
- Aile yalnızca burada seçilir. Kayıtlı bir planın ailesi sonradan değiştirilemez.
- Yeni plan her zaman aktif oluşur. AI Token Bütçesi planlarındaki Aktif anahtarı oluşturma ekranında yer almaz. Bu anahtar, kayıtlı bir planın açık taslak revizyonunda çıkar. Bir bütçeyi orada kapatmak, diğer değişiklikler gibi yayınlanan bir değişikliktir.
Plan Taslak durumunda oluşur ve editörü hemen açılır. İlk revizyonu bu ekrandan yayınlarsınız.
Bir planı editörden değil, katalog listesindeki satırından silersiniz. Editörde Emekliye Ayır kalır. Bu işlem, yayında olan bir planı katalogdan çeker ve yürürlükteki tavanlara dokunmaz.
Plan Durumu
| Durum | Anlamı |
|---|---|
| Taslak | Plan oluşturuldu ama hiç yayınlanmadı. Serbestçe düzenlenebilir ve — hiçbir atama ya da dağıtım ona bağlı olmadığı sürece — katalog listesindeki satırından silinebilir. |
| Yayında | En az bir revizyonu yayınlanmıştır ve atamalar bu plana bağlanabilir. Yayınlanmış bir plan bir daha silinemez — bir atama ona referans veriyor olabilir. |
| Emekli | Katalogdan çekilmiştir: bu plana yeni bir atama yapılamaz, ancak plana zaten bağlı atamalar çözümlenmeye devam eder. Emekliye ayırma bir dağıtım işlemi değildir — plana bağlı öznelerin gateway üzerindeki mevcut tavanına dokunmaz, yalnızca katalogdaki görünürlüğünü kapatır. |
Bir plan asla Taslak'a geri dönmez: yayınlanan bir revizyon değişmez olduğu için düzeltme, aynı plan altında yeni bir taslak revizyon açılarak yapılır.
Revizyon Akışı: Taslak → Yayınla → Geçmiş
Bir plan üzerinde çalışırken kural gövdesi (token/USD limitleri, pencereler, aşım davranışı) her zaman açık bir taslak revizyon üzerinde düzenlenir:
- Yeni Taslak Aç — planın yayınlanmış son hâlinin bir kopyası üzerinde düzenlemeye başlar. Bir planın aynı anda en fazla bir açık taslağı olabilir.
- Taslağı Kaydet — değişiklikleri kalıcı hâle getirir, ama henüz hiçbir özneyi etkilemez: bir taslak revizyona hiçbir atama çözümlenmez.
- Yayınla — bir değişiklik nedeni girilmesini ister (isteğe bağlı bir not) ve taslağı planın güncel yayınlanmış revizyonu yapar. Bu andan sonra revizyonun kural gövdesi bir daha değiştirilemez; önceki yayınlanmış revizyon geçmişe düşer, silinmez.
Revizyon geçmişi tablosu her revizyon için numarasını, durumunu (Taslak / Yayında / Yerini Aldı), değişiklik nedenini, yayın tarihini ve yayınlayan kullanıcıyı listeler — bir planın zaman içinde nasıl değiştiğinin tam kaydıdır.
Emekliye ayrılmış bir planın artık açık bir taslağı olamaz; kural gövdesini değiştirmek isterseniz önce planı yeniden aktif bir plana taşımanız (yeni bir plan oluşturup atamaları ona geçirmeniz) gerekir.
Atamalar
Plan düzenleme ekranına, planın kendi bilgileri ve revizyon geçmişiyle birlikte yeni bir Atamalar bölümü eklendi. Bu bölüm iki liste gösterir:
- Bu planı kullanan limit atamaları — konu tipi, konu adı, hedef, durum ve kaynak sütunlarıyla; konusu silinmiş bir atama Silinmiş konu etiketiyle işaretlenir. Hiç atama yoksa "Bu planı kullanan atama yok." yazar.
- Bu planı varsayılan yapan kurumlar — Kurumların Varsayılan Limit Planları özelliğiyle bu planı varsayılan seçmiş kurumların listesi, kurum ve aile sütunlarıyla. Bir varsayılan plan yalnızca yeni oluşturulan tüketicilere uygulanır, mevcut üyeleri değiştirmez. Hiç kurum yoksa "Bu planı varsayılan yapan kurum yok." yazar.
Bölümdeki Kuruma ata ve Tüketiciye ata düğmeleri Toplu Atama sihirbazını bu plan ve seçilen konu tipi ön seçili biçimde açar. Düğmeler yalnızca plan Yayında durumundayken ve atama yetkiniz varken etkindir; Platform kapsamlı bir planda atama yalnızca bir proje kapsamı içinden yapılabilir — düğme devre dışı olduğunda sebebini bir ipucu olarak gösterir.
Platform kapsamlı bir planın atama listesi de tek seferde tek bir proje kapsamı için gösterilir; aynı platform planını başka projeler de kullanıyor olabilir.
Bir Özneye Limit Atama: Limitler Sekmesi
Bir planı — ya da plana bağlı olmayan özel bir değeri — belirli bir özneye uygulamak için atama kullanılır. Atama, iki ekranda aynı Limitler sekmesi üzerinden yönetilir:
- Bir API istemcisinin detayında, API İstemcileri sekmesinin altındaki Limitler alt sekmesi — o tek istemcinin tüketimini sınırlar.
- Bir kimlik bilgisinin (Consumer) kendi düzenleme ekranındaki Limitler sekmesi — o kimlik bilgisine bağlı tüm istemcilerin ortak havuzunu sınırlar.
Her iki yüzey de aynı bileşeni kullanır, bu yüzden davranış birebir aynıdır. Sekmenin üstündeki aile seçicisiyle AI Token Bütçesi ve İstek Hızı arasında geçiş yapılır; her aile kendi bağımsız atamasını taşır, bir özne aynı anda her iki aileden de bir atamaya sahip olabilir.
Limitler sekmesinden yapılan bir atama tek bir özneye bağlanır; ağ geçidi bu özneyi yalnızca kendi kimliği üzerinden arar ve onun için tek bir sayaç tutar. A tüketicisine yapılan bir atama — kapsamı Tümü olsun ya da tek bir API proxy'ye daraltılmış olsun — B tüketicisini hiçbir zaman sınırlamaz, engellemez ya da saymaz; kendi ataması olmayan bir özne yalnızca üzerindeki üst tavanlara tabidir. Öznenin üzerindeki tavanlar (kurum, API proxy, proje, platform) atamayla birlikte uygulanmaya devam eder: İstek Hızı ailesinde her seviye kendi bağımsız sayacını tutar ve herhangi biri dolduğunda istek reddedilir, AI Token Bütçesi ailesinde ise aynı sayaca düşen üst tavanla nasıl birlikte davranıldığı Mevcut Limitlerinizle Birlikte Çalışma bölümünde anlatılmıştır. Bir tüketici atamasının Tümü kapsamı da sınırsız değildir — yalnızca o tüketicinin çağırabileceği ve üzerinde bir kimlik doğrulama politikası çalışan API proxy'lerini kapsar, bkz. Limitlerin Uygulanması. Tek bir sabit özneyi değil, ona ait olmayan çağıranları sınırlamak, engellemek ya da ortak bir havuzda toplamak istediğinizde doğru araç Kural Atamaları'dır — bir atamanın kendi öznesi dışındaki kimliklere ulaşmasının tek yolu oradaki hedef-dışı eylemdir (Bu kuralı onlara uygulama seçiliyken koşul dışındaki herkes dokunulmadan kalır).
Atama Modu
Bir atama üç moddan birini taşır:
| Mod | Anlamı |
|---|---|
| Plan | Öznenin tavanı, seçilen yayınlanmış bir planın güncel içeriğidir. Plan sonradan güncellenirse atama da yeni içeriği otomatik kullanır. |
| Özel | Öznenin tavanı, katalogdaki hiçbir planla paylaşılmayan, doğrudan bu atama üzerinde girilen değerlerdir. |
| Kapalı | Bu özne kendi adına yerel bir tavan taşımaz. |
Kapalı bir atama, öznenin sınırsız olduğu anlamına gelmez — üzerindeki zincirdeki (kurum, proje, platform) tavanlar uygulanmaya devam eder; bu mod yalnızca öznenin kendi yerel tavanını devre dışı bırakır. Hiç ataması olmayan bir özne eski/yönetilmeyen kalır; ona sonradan kendiliğinden bir limit bağlanmaz.
Önceki sürümlerde bir Devral modu da sunuluyordu. Ağ geçidi bu modu hiçbir zaman çözümlemiyordu — Devral ataması tam olarak Kapalı gibi davranıyordu — bu yüzden seçenek kaldırıldı ve mevcut Devral atamaları yükseltmede Kapalı'ya çevrildi. Ağ geçidinde hiçbir şey değişmedi. Bir kurumun tüketicilerine başlangıç limiti vermek için kurumun Varsayılan Limit Planları özelliğini kullanın.
Kapsam
Plan ya da özel değerin yanında, bir atama isteğe bağlı olarak öznenin tavanını belirli bir kaynağa daraltabilir — daraltılmamış bir atama öznenin tüm tüketimini kapsar:
| Daralt | Anlamı |
|---|---|
| Tümü | Daraltma yok — öznenin tüm tüketimi. |
| Tek API Proxy | Belirli bir API proxy, dağıtıldığı her ortamda. |
| Tek API Proxy + Ortam | Belirli bir API proxy, tek bir gateway ortamında. |
| Tek API Uç Noktası | Belirli bir API uç noktası (yol + HTTP metodu ikilisi) — yalnızca yükseltme taşımasının ürettiği atamalarda görülür ve ekranda görüntülenir; bu sürümde bu ekrandan elle seçilemez (bkz. Yükseltmede Taşınan Legacy Limitler). |
| Tek API Proxy Grubu | Belirli bir API proxy grubu, dağıtıldığı her ortamda — grubun kendisine gelen istekleri kapsar, gruba dahil bir proxy'ye doğrudan gelen istekleri değil. |
| Tek API Proxy Grubu + Ortam | Belirli bir API proxy grubu, tek bir gateway ortamında. |
| Tek AI Model | Belirli bir LLM modeli (AI Token Bütçesi ailesi için anlamlıdır). |
| Tek AI Sağlayıcı | Belirli bir LLM sağlayıcısı (AI Token Bütçesi ailesi için anlamlıdır). |
Tek API Proxy ve Tek API Proxy + Ortam daraltmalarında, isteğe bağlı bir HTTP metotları alanıyla tavan belirli metotlara da sınırlanabilir (örn. yalnızca POST); boş bırakılırsa tüm HTTP metotları geçerlidir. Diğer daraltma tipleri (grup, AI model/sağlayıcı) HTTP metot ekseni taşımaz. Tek API Uç Noktası kapsamı kendi içinde zaten bir yol + HTTP metodu ikilisi taşıdığından ayrıca bir HTTP metotları alanı yoktur.
Kapsam, atama oluşturulduktan sonra değiştirilemez — düzenleme ekranında bu alanlar kilitlenir. Farklı bir kapsam gerekiyorsa mevcut atama sonlandırılıp yeni bir atama oluşturulur.
Kapsamın altında İstek Hızı atamalarında iki alan grubu daha bulunur (AI Token Bütçesi atamasında bu blok gösterilmez; yerinde kısa bir bilgi notu bulunur — Limitler sekmesi ve Toplu Atama için aynı):
- Cache ve Yanıt — cache bağlantı hatasında ne yapılacağını (Fail: istek reddedilir, varsayılan; Continue: istek sayılmadan geçmeye devam eder), cache bağlantı zaman aşımını (saniye; boş bırakılırsa platform genelindeki varsayılan geçerli olur) ve limit bilgilerinin yanıt başlıklarında gösterilip gösterilmeyeceğini (varsayılan: Kapalı) belirler. AI Token Bütçesi ataması Token Kotaları mekanizmasıyla uygulanır; kendi cache ayarları vardır ve yanıta
RateLimit-*başlığı eklemez. - Özel hata mesajı — limit aşıldığında dönecek mesaj şablonunu, içerik tipini ve HTTP durum kodunu, Hata Mesajları ekranındakiyle aynı değişken söz dizimiyle özelleştirir; boş bırakılırsa platform genelindeki varsayılan hata mesajı kullanılır.
İstek Hızı atamalarında bu alanların bir isteğe nasıl yansıdığı aşağıdaki Limitlerin Uygulanması bölümünde anlatılmıştır.
Yaşam Döngüsü: Ata, Düzenle, Aktifleştir, Sonlandır
Bir özne, bir aile için aynı anda en fazla bir canlı ya da bekleyen atama taşıyabilir; yeni bir atama oluşturma seçeneği, o aile için zaten aktif ya da taslak bir atama varken gizlenir — önce mevcut atamayı sonlandırmanız istenir.
- Limit Ata — modu, (Plan modunda) yayınlanmış bir planı ya da (Özel modunda) değerleri, kapsamı, isteğe bağlı bir geçerlilik penceresini (başlangıç/bitiş) ve Hemen aktifleştir seçeneğini içeren bir form açar.
- Hemen aktifleştir işaretliyse atama doğrudan Aktif olarak kaydedilir ve derhal geçerli tavan hâline gelir.
- İşaretli değilse atama Taslak olarak kaydedilir; öznenin tavanını henüz etkilemez.
- Aktifleştir — bekleyen bir taslak atamayı canlıya alır; onay penceresi bunun öznenin bu kapsam için geçerli canlı tavanı olacağını açıkça belirtir.
- Düzenle — yalnızca Aktif durumdaki bir atama için, Sonlandır'ın yanında kullanılabilir; aynı atamanın modunu, plan seçimini (ya da özel değerlerini) ya da geçerlilik penceresini yerinde değiştirir — Limit Ata ile aynı formu, Hemen aktifleştir seçeneği olmadan yeniden kullanır (atama zaten canlıdır). Bu yeni bir atama değildir: özne, kapsam ve kaydın kendisi aynı kalır, yalnızca içeriği değişir. Atama, siz düzenlerken başka biri tarafından değiştirilmiş ya da sonlandırılmışsa güncelleme reddedilir, iletişim kutusu kapanır ve panel güncel durumu göstermek üzere yeniden yüklenir.
- Sonlandır — aktif bir atamayı kapatır; isteğe bağlı bir neden girilebilir. Sonlandırma geri alınamaz: tavan hemen uygulanmaz hâle gelir ve aynı özne için yeni bir atama, ayrı ve yeni bir kayıt olarak açılır. Sonlandırılan atama silinmez, sekmenin altındaki Geçmiş tablosunda mod, atanma/sona erme zamanı ve nedeniyle birlikte kalır.
- Özne silindiğinde atamaları kendiliğinden sonlanır. Bir tüketici (Consumer), portal uygulaması ya da kurum silindiğinde onu adlandıran her atama — aktif olanlar da taslaklar da — aynı adımda sonlandırılır, nedeni Öznesi silindi olarak kaydedilir ve tavan gateway'lerden çekilir. Silme reddedilirse (özneye bağlı bir şey hâlâ duruyorsa) atamalar olduğu gibi bırakılır.
Düzenle yalnızca güncel Aktif atama için geçerlidir. Bekleyen bir Taslak atamanın bu sürümde kendine ait bir Düzenle eylemi yoktur — üzerinde sunulan tek eylem Aktifleştir'dir; canlıya alındıktan sonra Düzenle, diğer her aktif atamada olduğu gibi kullanılabilir hâle gelir.
Limitler Sekmesinde Anlık Kullanım
Güncel Aktif atamanın kartının hemen altında, aynı Limitler sekmesi — göründüğü üç yüzeyde de (bir API istemcisinin detay panelinde, bir kimlik bilgisinin kendi düzenleme ekranında ve bir portal Uygulamasının görünümünde) — o atama için bir Anlık kullanım kutusu gösterir.
Sayaç penceresi (saatlik/günlük/aylık) başına bir satır listelenir; atamanın kapsamı bir API proxy'ye ya da ortama daraltılmışsa veya bir kural atamasının koşulu kimliğe göre daraltıyorsa, her daraltılmış kapsam ya da kimlik kendi satırını alır.
| Sütun | Anlamı |
|---|---|
| Pencere | Satırın ölçtüğü sayaç penceresi — saatlik, günlük ya da aylık. |
| Kapsam | Satırın sayacının daraltıldığı proxy/ortam ya da kimlik; daraltma yoksa atamanın tamamı. |
| Tüketilen | Pencerede şu ana kadar tüketilen miktar. |
| Limit | Bu pencere için uygulanan tavan. |
| Kullanım | İlerleme çubuğu ve yüzde rozeti — %70 altı yeşil, %70-90 arası uyarı, %90 ve üzeri kritik; Kota Kullanımı ve Uyarılar raporuyla aynı eşikler. |
| Sıfırlanma | Güncel pencerenin kapandığı ve sayacın yenilendiği zaman. |
Bir AI Token Bütçesi atamasının AI Cost sayaçları ham sayı yerine USD olarak gösterilir.
Kutudaki sayılar, gateway sayaçlarından her dakika tazelenen bir anlık görüntüden okunur; kutudaki Yenile düğmesi bu eşitlemeyi bir sonraki zamanlanmış döngüyü beklemeden hemen çalıştırır — Kota Kullanımı ve Uyarılar raporunun kendi yenileme kontrolünün tetiklediği eşitlemeyle aynıdır. Atamaya düşen ilk istek sayacı oluşturmadan önce kutuda "Henüz sayaç yok — bu atamaya düşen ilk istek sayacı oluşturur." notu görünür.
Kutu yalnızca Aktif bir atama için gösterilir. Bekleyen bir Taslak hiç uygulanmamıştır, sonlandırılmış bir atamanın sayaçları ise kendi ad alanıyla birlikte ortadan kalkar — aynı özne için açılan yeni bir atama sıfırdan yeni bir sayaçla başlar.
Bu kutuyu okumak, Limitler sekmesinin geri kalanıyla aynı yetkiyi gerektirir: proje için Kimlik ve Erişim Kontrolü ya da Bütçeler izin gruplarından birinde Görüntüle yetkisi (sistem yöneticisi her zaman görür).
Toplu Atama
Yukarıda anlatılan atama akışı, tek bir özneyi elle atamak içindir; bir projede bunlardan binlercesi olduğunda ölçeklenmez. Toplu Atama, bir planı ya da özel bir değeri — özneye tek tek atamak yerine — filtrelenmiş büyük bir özne popülasyonuna (tüketiciler, API istemcileri, uygulamalar ya da organizasyonlar) tek bir koşuda bağlar.
AI Gateway → Limit Planları kataloğundaki Toplu atama düğmesiyle açılır; sol üstteki Geri düğmesi kataloğa döndürür. AI Gateway lisans modülü olmayan bir kurulumda Limit Planları kalemi ayrıca Kimlik Yönetimi grubu altında da listelenir, böylece İstek Hızı toplu ataması AI Gateway menü grubu olmadan da erişilebilir kalır. Sihirbaz ayrıca bir planın Atamalar bölümündeki Kuruma ata / Tüketiciye ata düğmesinden de açılabilir; bu durumda plan ve konu tipi ön seçilidir. Ekranın iki sekmesi vardır: Ata bir koşu kurar ve başlatır, Koşular ilerlemesini ve geçmişini izler.
Ata: Popülasyon Seçimi
Sol panel, tembel yüklenen bir organizasyon ağacıdır — her düğümde ad ve tüketici sayısı gösterilir, bir alt organizasyonlar dahil anahtarı bütün bir alt ağacı seçime katar. Özne tablosunun üstündeki filtreler popülasyonu daha da daraltır: özne türü (Tüketici / API İstemcisi / Uygulama / Organizasyon), serbest metin arama, yalnızca etkin olanlar ve — en az bir organizasyon seçildikten sonra — mevcut atama (Fark etmez / Mevcut ataması yok / Mevcut ataması var).
Sağ panel, eşleşen öznelerin sunucu-sayfalı bir tablosudur (ad, organizasyon ve varsa mevcut atama: plan, mod, hedef). İki seçim modu sunulur:
- Satır seçimi — tek tek satırları işaretleyin, en fazla 5.000 özne.
- Filtreye uyan tümünü seç — filtrelenmiş tüm popülasyonu, bir kimlik listesi tarayıcıya taşınmadan seçer. Binlerce özneli bir popülasyonu seçmenin pratikte tek yolu budur. Sonradan herhangi bir satırın işareti kaldırılırsa anahtar otomatik olarak Kapalı konuma döner: mevcut sayfada işaretli kalan satırlar açık bir satır seçimine dönüşür, diğer sayfalardaki "tüm eşleşenler" kapsamı sona erer (kaç satırın seçili kaldığı bir bilgi mesajıyla gösterilir). Anahtar yeniden açılırsa o anki filtrelere uyan her şey yeniden seçilir.