Kullanıcı arayüzünde politika ekleme ve yapılandırma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

API proxy'sine politika tabanlı özellikler eklemek iki adımlı bir işlemdir:

1. Bir politika türünün örneğini yapılandırın.
2. Politika örneğini bir Akışa ekleyin.

Aşağıdaki şemada, politikalar ile Akışlar arasındaki ilişki gösterilmektedir. Gördüğünüz gibi bir politika işleme "Adımı" olarak bir Akışa eklenir. API'nizde istenen davranışı yapılandırmak için Akışlar hakkında biraz bilgi sahibi olmanız gerekir. (Bu konu, daha önce Akışları yapılandırma bölümünde ele almıştı.)

Yaygın olarak kullanılan bir politika türü SpikeArrest'tir. SpikeArrest, arka uç hizmetlerinizi boğabilecek mesaj trafiğindeki ani artışları önler.

Akışa politika ekleme

Bir Akışa politika eklemek için:

1. Bir API proxy'si seçin ve Geliştirme görünümüne gidin.
2. API Proxy Düzenleyici'deki Gezgin bölmesinde, politika eklemek istediğiniz akışı seçin.
   Örneğin, aşağıdaki şekilde varsayılan API proxy uç noktası için PreFlow akışı seçildi:
   
3. Tasarım görünümünde, politika eklemek için istek veya yanıt akışıyla ilişkili +Adım'ı tıklayın. Örneğin:
   
   Politikaların kategorilere ayrılmış bir listesini gösteren Adım Ekle iletişim kutusu açılır.
   
4. Seçili akışa eklemek istediğiniz politika türünü kaydırın ve seçin.
5. Aşağıdaki alanlarda gerekli değişiklikleri yapın.

   • Görünen Ad: Politikanın benzersiz görünen adı. Kullanıcı arayüzü, varsayılan bir ad oluşturur ancak politika için açıklayıcı bir ad oluşturmanız önerilir. Bu sayede kuruluşunuzdaki diğer geliştiricilerin, politikanın amacını anlamasını kolaylaştırabilirsiniz.

   • Ad: Politikanın benzersiz adı. Politika adı, aşağıdaki istisnalarla görünen adla eşleşir:

     • Boşlukların yerini tireler alır.

     • Ardışık tireler tek bir kısa çizgiyle değiştirilir.

     • Tire, alt çizgi ve boşluk (yukarıda belirtildiği gibi değiştirilmiştir) dışında, pound işareti, yüzde işareti, "ve" işareti gibi alfanümerik olmayan karakterler kaldırılır.

6. Ekle'yi tıklayın.

   Politika, seçilen akışa eklendi.

Politika eklendikten sonra, politikanın akışın Tasarımcı görünümünde, bu örnekte varsayılan proxy uç noktasının PreFlow'unda ve Gezinme bölmesindeki Politikalar listesinde görüntülendiğini görürsünüz. Yeni eklenen politika için XML'i görüntüleyen Kod görünümü, Tasarımcı görünümünün altında görüntülenir. Edge, politikanın bir dizi makul varsayılan değer içeren bir örneğini oluşturur.

Akışa eklemeden politika ekleme

Bir politikayı akışa eklemeden eklemek için (Hataları işleme açısından kullanışlıdır) Gezgin görünümündeki Politikalar çubuğundaki + simgesini tıklayarak Politika Ekle iletişim kutusunu açın ve politikayı ekleyin (önceki bölümde 4-6. adımlarda açıklandığı gibi).

Herhangi bir akışa ekli olmayan politika, önceki şekilde gösterilen API anahtarı mesaj politikasının yanında gösterildiği gibi, Politikalar listesinde "ayrılmış" simgesiyle işaretlenir.

Politikayı oluşturduktan sonra Politikalar listesinden sürükleyip Tasarımcı görünümünde istediğiniz akışa bırakarak bir akışa ekleyebilirsiniz.

Bir akıştan politikaları ayırma

Bir politikayı Akıştan çıkarmak için Akış'ı seçin. Akış'ın Tasarımcı görünümünde fareyle politika simgesinin üzerine gelin. Simgede görünen dairenin içindeki X simgesini tıklayın.

Politika örneğini silme

Bir politika örneğini silmek için Gezgin görünümünde fareyle politika girişinin üzerine gelin. Girişin sağında görünen dairenin içindeki X işaretini tıklayın.

Kullanıcı arayüzünde politikaları yapılandırma

Kullanıcı arayüzü bir politika örneği oluşturduğunda, genel ayarlar için makul varsayılan değerleri uygular. Bu ayarları gereksinimlerinizi karşılayacak şekilde değiştirmeniz gerekebilir.

Örneğin:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SpikeArrest async="false" continueOnError="false" enabled="true" name="spikearrest-1">
  <DisplayName>SpikeArrest-1</DisplayName>
  <FaultRules/>
  <Properties/>
  <Identifier ref="request.header.some-header-name"/>
  <MessageWeight ref="request.header.weight"/>
  <Rate>30ps</Rate>
</SpikeArrest>

Bir politikayı, XML yapılandırmasını doğrudan Kod görünümünde düzenleyerek yapılandırabilirsiniz. Örneğin, Spike Arrest politikası için en yüksek mesaj hızı başlangıçta saniyede 30 mesaj olarak ayarlanmıştır. Politika için XML'deki <Rate> öğesinin değerini değiştirerek en yüksek hızı değiştirebilirsiniz. Politikaları yapılandırma hakkında daha fazla bilgi edinmek için Politika Referansı'nı inceleyin.

Ayrıca politikaları kesip Kod görünümüne de yapıştırabilirsiniz. Bu, GitHub'da bulunan örneklerdeki politikaları yeniden kullanmak için mükemmel bir yoldur.

Kod görünümünde bir politika tanımında değişiklik yaptığınızda, bu değişiklikler Özellik Denetleyicisi'ne yansıtılır. Bunun tersi de geçerlidir. Değişiklikleri Özellik Denetleyici'de yapın ve bu değişiklikler XML'de Kod görünümünde görünür.

Bu konuda kullanılan Kota politikasına özel dokümanlar için Kota politikası bölümüne bakın.