Menambahkan fitur menggunakan kebijakan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Apigee memungkinkan Anda memprogram perilaku API tanpa menulis kode apa pun menggunakan policies. Kebijakan seperti modul yang menerapkan fungsi pengelolaan tertentu dan terbatas. Kebijakan dirancang agar Anda dapat menambahkan jenis kemampuan pengelolaan umum ke API secara efisien dan andal.

Kebijakan menyediakan fitur seperti keamanan, pembatasan kapasitas, transformasi, dan mediasi, sehingga Anda tidak perlu membuat dan mengelola kode sendiri. Anda tidak dibatasi pada kumpulan jenis kebijakan yang disediakan oleh Apigee. Anda juga dapat menulis skrip dan kode kustom (seperti aplikasi JavaScript) yang memperluas fungsi proxy API dan memungkinkan Anda berinovasi di atas kemampuan pengelolaan dasar yang didukung oleh kebijakan Apigee.

Buat dan lampirkan kebijakan ke proxy API dan alur bersama menggunakan Apigee di Cloud Code seperti yang dijelaskan di bagian berikut. Bergantung pada jenis kebijakan, Anda mungkin perlu membuat resource, seperti yang dijelaskan dalam Mengelola resource. Lihat juga Mengelola folder dan file di ruang kerja Apigee.

Membuat kebijakan

Untuk membuat kebijakan menggunakan Apigee di Cloud Code:

  1. Di ruang kerja Apigee, lakukan salah satu tindakan berikut berdasarkan tempat Anda ingin melampirkan kebijakan:

    Lampirkan ke Tindakan
    Proxy API Lakukan salah satu tindakan berikut:
    • Posisikan kursor di atas salah satu folder berikut, klik Membuat ikon kebijakan Apigee, lalu pilih Buat kebijakan:
      • Paket proxy apiproxy-name
      • apiproxy-name/apiproxy
    • Arahkan kursor ke folder apiproxy-name/apiproxy/policies untuk proxy API, lalu klik Membuat ikon proxy API.
    Alur bersama Lakukan salah satu tindakan berikut:
    • Posisikan kursor di atas salah satu folder berikut, klik Membuat ikon alur bersama, lalu pilih Buat kebijakan:
      • sharedflow-name paket alur bersama
      • sharedflow-name/sharedflowbundle
    • Arahkan kursor ke folder sharedflow-name/sharedflowbundle/policies untuk alur bersama, lalu klik Membuat ikon alur bersama.

Wizard Create policy akan terbuka.

  1. Pilih kategori kebijakan yang ingin Anda buat dari daftar. Untuk deskripsi kategori kebijakan, lihat Ringkasan referensi kebijakan.

  2. Masukkan nama unik untuk kebijakan, lalu tekan Enter. Kebijakan ditambahkan ke folder /policies untuk proxy API atau alur bersama di bagian Apigee dan dibuka di editor.

  3. Edit file, sesuai kebutuhan, lalu pilih File > Save atau ⌘S untuk menyimpan hasil edit. Untuk informasi selengkapnya tentang cara mengonfigurasi kebijakan, lihat Ringkasan referensi kebijakan.

  4. Buat resource jika diperlukan oleh jenis kebijakan, seperti yang dijelaskan dalam Mengelola resource.

Melampirkan kebijakan ke alur

Kebijakan tidak akan dieksekusi hingga dilampirkan ke alur. Anda dapat melampirkan kebijakan ke alur dengan menambahkan elemen <Step> ke elemen alur permintaan atau respons yang sesuai dalam konfigurasi ProxyEndpoint atau TargetEndpoint, seperti yang dijelaskan dalam topik berikut:

Misalnya, konfigurasi berikut melampirkan QuotaPolicy ke <PreFlow> ProxyEndpoint untuk mengonfigurasi jumlah pesan permintaan yang diizinkan proxy API selama jangka waktu tertentu.

<ProxyEndpoint name="default">
  <PreFlow>
    <Request>
      <Step><Name>QuotaPolicy</Name></Step>
    </Request>
  </PreFlow>
  <HTTPProxyConnection>
    <BasePath>/weather</BasePath>
  </HTTPProxyConnection>
  <RouteRule name="default">
    <TargetEndpoint>default</TargetEndpoint>
  </RouteRule>
</ProxyEndpoint>