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 aşamalı 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 ve 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'niz için istediğiniz davranışı yapılandırmak istiyorsanız akışlar hakkında biraz bilgi edinmeniz gerekir. (Bu konu daha önce Akışları yapılandırma bölümünde ele alınmıştı.)

Yaygın olarak kullanılan politika türlerinden biri SpikeArrest'tir. SpikeArrest, arka uç hizmetlerinizi aşırı yükleyebilecek mesaj trafiğindeki ani artışları önler.

Akışa politika ekleme

Akışa politika eklemek için:

1. Bir API proxy'si seçin ve Geliştir görünümüne gidin.
2. API Proxy Düzenleyici'de, 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çilmiştir:
   
3. Tasarım görünümünde, bir politika eklemek için istek veya yanıt akışıyla ilişkili +Adım'ı tıklayın. Örneğin:
   
   Adım Ekle iletişim kutusu açılır ve politikaların kategorilere ayrılmış listesi gösterilir.
   
4. Kaydırarak seçili akışa eklemek istediğiniz politika türünü belirleyin.
5. Aşağıdaki alanları değiştirin.

   • Görünen Ad: Politika için 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ştiriciler, politikanın ne yapmayı amaçladığını kolayca anlayabilir.

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

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

     • Ardışık tireler tek bir tireyle değiştirilir.

     • Kısa çizgiler, alt çizgiler ve boşluklar (yukarıda belirtildiği gibi değiştirilir) hariç olmak üzere, alfanümerik olmayan karakterler (ör. sterlin işareti, yüzde işareti, "ve" işareti) kaldırılır.

6. Ekle'yi tıklayın.

   Politika, seçilen akışa eklenir.

Politika eklendikten sonra, akışın Tasarımcı görünümünde (bu örnekte varsayılan proxy uç noktasının PreFlow'u) ve gezinme bölmesindeki Politikalar listesinde gösterilir. Yeni eklenen politikanın XML'sini gösteren Kod görünümü, Tasarımcı görünümünün altında gösterilir. Edge, bir dizi makul varsayılan değer içeren politika örneği oluşturur.

Politikayı akışa eklemeden ekleme

Bir politikayı akışa eklemeden eklemek için (hataları işleme konusunda yararlıdır) Gezgin görünümündeki Politikalar çubuğunda + işaretini tıklayarak Politika Ekle iletişim kutusunu açın ve politikayı ekleyin (önceki bölümdeki 4-6. adımlarda açıklandığı gibi).

Herhangi bir akışa eklenmemiş bir 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 Tasarımcı görünümündeki istediğiniz akışa sürükleyip bırakarak akışa ekleyebilirsiniz.

Politikaları akıştan ayırma

Bir politikayı Akış'tan ayırmak için Akış'ı seçin. Akışın Tasarımcı görünümünde, ilgili politikanın simgesinin üzerine gelin. Simgede görünen daire içindeki X'i tıklayın.

Politika örneğini silme

Bir politika örneğini silmek için Navigator görünümünde politikanın girişinin üzerine gelin. Girişin sağında görünen dairedeki X'i tıklayın.

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

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

<?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, ani artışları önleme politikası için en yüksek ileti oranı başlangıçta saniyede 30 ileti olarak ayarlanır. Politikanın XML'sindeki <Rate> öğe değerini değiştirerek en yüksek hızı değiştirebilirsiniz. Politikaları yapılandırma hakkında daha fazla bilgi için Politika Referansı'na bakın.

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

Kod görünümünde bir politika tanımında değişiklik yaptığınızda bu değişiklikler Özellik Denetçisi'ne yansıtılır. Bunun tam tersi de geçerlidir. Özellik denetçisinde yaptığınız değişiklikler Kod görünümündeki XML'de gösterilir.

Bu konuda kullanılan kota politikasına özel belgeler için Kota politikası başlıklı makaleye bakın.