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 dengan menggunakan kebijakan. Kebijakan ibarat modul yang mengimplementasikan fungsi pengelolaan terbatas yang spesifik. Kebijakan didesain agar Anda dapat 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 pada 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 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 bagian Apigee, lakukan salah satu tindakan berikut berdasarkan tempat Anda ingin melampirkan kebijakan:

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

    Wizard Buat kebijakan akan terbuka.

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

  3. Masukkan nama unik untuk kebijakan tersebut, lalu tekan Enter. Kebijakan ini akan ditambahkan ke folder /policies untuk proxy API atau alur 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 akan dijalankan 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 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>