Menambahkan fitur menggunakan kebijakan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Apigee memungkinkan Anda memprogram perilaku API tanpa menulis kode apa pun menggunakan kebijakan. Kebijakan itu seperti modul yang mengimplementasikan fungsi manajemen tertentu yang terbatas. Kebijakan dirancang untuk memungkinkan Anda menambahkan jenis kemampuan pengelolaan umum ke API dengan mudah dan andal.

Kebijakan menyediakan fitur seperti kemampuan keamanan, pembatasan kapasitas, transformasi, dan mediasi, sehingga Anda tidak perlu membuat kode dan mengelola fungsi ini sendiri. Anda tidak dibatasi oleh serangkaian 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 selain dengan 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 kebijakannya, 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 bagian Apigee, lakukan salah satu tindakan berikut berdasarkan tempat Anda ingin melampirkan kebijakan:

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

    Wizard Buat kebijakan akan terbuka.

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

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

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

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

Melampirkan kebijakan ke flow

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

Misalnya, konfigurasi berikut melampirkan QuotaPolicy ke <PreFlow> dari ProxyEndpoint untuk mengonfigurasi jumlah pesan permintaan yang diizinkan oleh 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>