Global Ayar Grupları

bilgi

Ayarlar detayı için Ayarlar Sekmesi (Settings Tab) sayfasını ziyaret edebilirsiniz.

Ayar Grubu ekranı, API Proxy'lere veya API Proxy Gruplarına özel ayarları yapılandırmak ve düzenlemek için kullanılır. Farklı ayarların gruplandırılıp, uygulanmasına olanak tanır. Mevcut ayar grupları düzenlenebilir, varsayılan hale getirilebilir veya yeni ayarlar tanımlanarak API Proxy'lerin/API Proxy Grupların davranışı özelleştirilebilir.

Ayar Grubu ayarları aşağıdaki görselde gösterilmektedir:

API Proxy ayarları konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Alan	Açıklama
İsim	API Proxy ayarı için kullanılan isim.
Açıklama	Ayar grubuna dair açıklayıcı bilgi.
API Proxy'ler için Varsayılan (Default for API Proxies)	Bu ayar grubunun yeni oluşturulacak olan API Proxy'ler/API Proxy Gruplar için varsayılan ayar olup olmadığını belirler. Varsayılan yapmak için "İşlemler" menüsünden "Varsayılan Yap" seçeneği kullanılabilir.
İşlemler (Actions)	- Düzenle (Edit): Mevcut ayar grubunu düzenleme imkanı sağlar. - Varsayılan Yap (Set Default): Ayar grubunu yeni API Proxy'ler/API Proxy Gruplar için varsayılan hale getirir. :::info

Eğer "Varsayılan Yap" (Set Default) ayarı seçilirse, mevcutta varsayılan olarak işaretlenmiş bir ayar grubu varsa ondaki varsayılan özelliği kaldırılır. Eski API Proxy'ler/API Proxy Gruplar bu değişiklikten etkilenmez. Bu ayar sonrasında oluşturulan yeni API Proxy'ler ve API Proxy Grupları, varsayılan olarak bu yeni ayarla oluşturulur.

::: | | Ayar Sekmeleri | CORS (Cross-Origin Resource Sharing):
CORS politikasının etkinleştirilip etkinleştirilmeyeceğini belirler. Ayar etkinleştirildiğinde, yapılandırma detayları 'Configure' butonu ile düzenlenebilir.

Cache:
API Proxy'ler için önbellekleme ayarlarının yapılandırılmasını sağlar. Bu sekme, yanıtların nasıl ve ne süreyle önbellekleneceğine dair kurallar belirlemek için kullanılır.

Error Response Template:
API Proxy tarafından döndürülen hata mesajlarının biçimini ve içeriğini özelleştirme imkanı sunar.

Forwarded IP Header Parameter:
API Proxy'ler aracılığıyla iletilen IP başlıklarının nasıl işleneceğini yapılandırır.

Routing:
API Proxy için hedef sunucu veya yol belirleme ayarlarını içerir. Proxy'nin istekleri hangi sunucuya veya yola yönlendireceğini tanımlamak için kullanılır.

Maintenance Mode:
API Proxy'i bakım moduna almak için kullanılır. Bu mod, sistem güncellemeleri veya planlı bakım işlemleri sırasında API erişimini geçici olarak durdurmak amacıyla kullanılır. API önceden tanımlanmış bir HTTP durum kodu ve mesaj yapısı ile yanıt verir.

:::info

Ayarlar detayı için Ayarlar Sekmesi (Settings Tab) sayfasını ziyaret edebilirsiniz.

::: | | Variable Butonu (Variable) | Sayfanın üst kısmındaki [<> Variable] butonu ile ilgili alanlara dinamik değer seçilebilir. Detaylı bilgi için Dinamik Değişkenler sayfasını inceleyebilirsiniz. |

API Proxy Settings ekranında oluşturulan ayarlar, proxy ve proxy gruplarına atanabilir. Bu işlem, görselde gösterildiği gibi bir seçim ekranı üzerinden gerçekleştirilir.

API Proxy ayarlarını Proxy ve Proxy Gruba ekleme ayarları aşağıdaki görsellerde gösterilmektedir:

• Kullanıcı, listelenen API Proxy'lerden bir veya birden fazlasını seçebilir.
• Benzer şekilde, API Proxy Settings aynı ekrandan Proxy gruplarına da atanabilir.

Bakım Modu ve "Global Kazanır" Semantiği

Maintenance Mode ayarı da, CORS/Cache/Idempotency gibi diğer ayar sekmeleriyle aynı "global kazanır" kuralına tabidir: bir API Proxy veya Proxy Group bu ayar grubuna bağlıysa, proxy'nin kendi Bakım Modu ekranında "Global Setting aktif!" rozeti görünür, anahtar ve Yapılandır düğmesi kapanır ve gösterilen durum kodu/mesaj her zaman ayar grubunun değeridir.

uyarı

Proxy'nin kendi Bakım Modu daha önce açık olsa bile, proxy bir sonraki grup kaydında / içe aktarma "Mevcut Olanı Değiştir" akışında / "+" ile gruba eklendiğinde bu değer ayar grubunun değeriyle ezilir. Grup Bakım Modu kapalıysa proxy'nin bakım modu da kapanır.

Proxy ayar grubundan koparıldığında (Ayar Grubu seçimi kaldırıldığında) son kopyalanan değer proxy üzerinde olduğu gibi kalır — kendiliğinden kapanmaz; kapatmak isterseniz proxy'nin kendi Bakım Modu ekranından elle kapatıp kaydetmeniz gerekir.

not

Bir Proxy Group'un Bakım Modu ayarı da aynı şekilde ayar grubundan kopyalanır ve ekranda tutarlı görünür, ancak Gateway trafiği yalnızca proxy'nin kendi Bakım Modu ayarına göre keser — Proxy Group üzerinden geçen trafik bu ayarla kesilmez. Bu davranış proxy grubu seviyesinde bir kapsam sınırıdır.

Ayar grubuna bir proxy veya proxy group eklendiğinde ya da gruptan çıkarıldığında, işlem deploy edilmiş ortamları da artık "Yeniden Yükle" (redeploy required) olarak işaretler — önceki sürümde bu işlem hiçbir ortamı işaretlemiyordu ve yeni ayarların canlıya geçtiği yanlış izlenimi oluşabiliyordu.

Ayarlar Grubu Deploy İşlemi

Ayar grubu üzerinde herhangi bir değişiklik yapıldığında, bu grubu kullanan API Proxy'lerin ve API Proxy Grupların durumu "Redeploy Required" olarak değişir. Bunları tek tek deploy etmek yerine, "Ayar Grubu Deploy" özelliği ile bu ayar grubunu kullanan tüm API Proxy'lerin ve API Proxy Grupların belirli bir çalışma ortamına (environment) toplu olarak deploy edilmesini sağlar.

Deploy işlemi başlatıldığında, bir onay dialogu açılır. Bu dialog'da aşağıdaki bilgiler ve seçenekler bulunur:

• Politika/Ayar Grubu Adı: Deploy edilecek ayar grubunun adı gösterilir. Bu bilgi, toplu işlem olduğundan onay mekanizmasında görüntülenir.
• API Proxy ve API Proxy Group Seçimi: Deploy işleminin API Proxy'lere mi, API Proxy Gruplarına mı uygulanacağını seçebilirsiniz. Her iki seçenek de işaretlenebilir.
• Filtreleme Seçeneği: Deploy edilecek API Proxy ve API Proxy Gruplarını filtrelemek için aşağıdaki seçeneklerden birini seçebilirsiniz:
  • Hepsine: Bu ayar grubunu kullanan tüm API Proxy ve API Proxy Grupları deploy edilir.
  • Sadece deployed durumunda olanlara: Sadece seçili ortamda deployed durumunda olan ve redeploy gerektirmeyen API Proxy ve API Proxy Grupları deploy edilir.
  • Sadece deployed ve redeploy required durumda olanlara: Sadece seçili ortamda deployed durumunda olan ve redeploy gerektiren API Proxy ve API Proxy Grupları deploy edilir.
• Deploy Edilecek Nesne Sayıları: Seçilen filtreleme seçeneğine göre deploy edilecek API Proxy ve API Proxy Group sayıları gösterilir.

Filtreleme seçeneği değiştirildiğinde, deploy edilecek nesne sayıları otomatik olarak güncellenir. Deploy işlemi başlatıldığında, seçilen filtreleme seçeneğine göre belirlenen API Proxy ve API Proxy Grupları deploy edilir.

Deploy işlemi tamamlandığında, kullanıcıya deploy işleminin sonucunu gösteren Deployment Results adında bir sonuç ekranı sunulur.

Ayarlar Grubu Deploy detayı aşağıdaki görselde gösterilmektedir: