Halaman ini berlaku untuk Apigee dan Apigee hybrid.
Lihat dokumentasi
Apigee Edge.
Fitur persistensi Apigee mencakup cache, peta nilai kunci, dan set properti. Jika menggunakan Apigee hybrid, Anda dapat menggunakan secret Kubernetes untuk mempertahankan data sensitif.
| Fitur | Gunakan |
|---|---|
| Cache | Dengan menggunakan kebijakan untuk penyimpanan dalam cache tujuan umum, Anda dapat mempertahankan objek apa pun yang diperlukan proxy
di beberapa sesi permintaan/respons. Anda juga dapat meng-cache respons resource backend dengan
kebijakan ResponseCache. Penyimpanan respons dalam cache sangat membantu saat data backend hanya diperbarui secara berkala. Kebijakan ResponseCache dapat mengurangi panggilan ke sumber data
backend. |
| Peta nilai kunci | Peta nilai kunci (KVM) menyediakan penyimpanan runtime umum untuk data yang dapat berubah secara berkala. Misalnya: data sesi pengguna, keranjang belanja, dll. Entri KVM dapat dienkripsi. |
| Kumpulan properti | Set properti cocok untuk menyimpan data konfigurasi yang tidak sering berubah. |
| Secret Kubernetes | (Khusus Apigee hybrid) Gunakan Secret untuk menyimpan data sensitif seperti kredensial pengguna. |
Menyimpan data ke dalam cache
Resource cache cakupan lingkungan dibuat secara dinamis saat kebijakan cache dieksekusi dalam alur proxy API. Kebijakan cache mencakup kebijakan PopulateCache, kebijakan LookupCache, kebijakan InvalidateCache, dan kebijakan ResponseCache.
Item yang di-cache tetap berada di memori (L1) selama satu detik. Anda tidak dapat mengubah konfigurasi ini. Setelah satu detik, objek yang di-cache ditempatkan di database (L2) tempat objek tersebut tersedia hingga cache berakhir masa berlakunya. Untuk mengetahui detailnya, lihat Tingkat cache persisten dalam memori. Anda mengelola detail cache, seperti waktu habis masa berlaku, melalui konfigurasi kebijakan cache. Apigee API disediakan yang memungkinkan Anda mencantumkan dan menghapus resource cache.
Saat menggunakan kebijakan cache, Anda memastikan keunikan kunci nilai yang di-cache dengan mengonfigurasi kunci cache. Kunci cache, bersama dengan nilai lain yang dapat Anda konfigurasi, memberi Anda cara yang andal untuk mendapatkan data yang sama dengan yang Anda masukkan. Ukuran cache dan ketersediaannya tunduk pada batas tertentu.
Sebaiknya gunakan cache untuk:
- Mengurangi latensi dan traffic. Permintaan dipenuhi dalam waktu yang lebih singkat dan dengan representasi yang digunakan kembali.
- Mempertahankan data di seluruh transaksi. Anda dapat menyimpan data sesi untuk digunakan kembali di seluruh transaksi HTTP.
- Mendukung keamanan. Cakupan akses ke entri cache agar hanya dapat diakses di lingkungan tertentu atau oleh proxy API tertentu.
Penyimpanan dalam cache respons backend
Anda dapat meng-cache respons resource backend dengan
kebijakan ResponseCache.
Hal ini sangat berguna jika data backend hanya diperbarui secara berkala. Kebijakan ResponseCache
dapat mengurangi panggilan ke sumber data backend.
Melalui kebijakan ResponseCache, Anda juga dapat meminta Apigee untuk melihat header caching respons HTTP tertentu dan mengambil tindakan sesuai dengan perintah header. Misalnya, pada respons dari target backend, Apigee mendukung header Cache-Control. Header ini dapat digunakan untuk mengontrol, antara lain, usia maksimum respons yang di-cache. Untuk mengetahui informasi selengkapnya, lihat
Dukungan untuk header respons HTTP.
Cache tujuan umum jangka pendek
Dengan menggunakan kebijakan untuk penyimpanan dalam cache tujuan umum, Anda dapat mempertahankan objek apa pun yang diperlukan proxy Anda di beberapa sesi permintaan/respons.
Dengan kebijakan PopulateCache, kebijakan LookupCache, dan kebijakan InvalidateCache,
Anda dapat mengisi, mengambil, dan menghapus data yang di-cache saat runtime.
Misalnya, Anda dapat menyimpan untuk sementara:
- ID sesi untuk pengelolaan sesi.
- Kredensial untuk panggilan keluar (seperti kunci API atau token akses OAuth).
- Konten respons yang harus diberi penomoran halaman untuk aplikasi.
Saat runtime, kebijakan cache Anda akan menyalin nilai antara variabel proxy dan cache yang dikonfigurasi yang Anda tentukan. Saat ditempatkan di cache, nilai akan disalin dari variabel yang Anda tentukan ke cache. Saat diambil dari cache, data akan disalin ke dalam variabel untuk digunakan oleh proxy Anda.
Untuk contoh dengan kode, lihat Contoh: Cache tujuan umum.
Mengelola cache dengan Apigee API
Anda dapat membuat daftar dan menghapus cache menggunakan caches API.
Persistensi jangka panjang dengan peta nilai kunci (KVM)
Untuk menyimpan data terstruktur yang dienkripsi atau tidak dienkripsi tanpa batas waktu, Anda dapat membuat dan mengisi peta nilai kunci (KVM) yang berisi pasangan nilai kunci arbitrer. Misalnya, Anda dapat menyimpan:
- Peta yang menghubungkan alamat IP ke kode negara.
- Daftar alamat IP yang diizinkan/ditolak aksesnya.
- Peta yang menghubungkan URL panjang ke URL singkat.
- Data khusus lingkungan, seperti jumlah kuota dan waktu habis masa berlaku token OAuth.
KVM dapat memiliki salah satu dari tiga cakupan: organisasi, lingkungan, apiproxy. Misalnya, jika pasangan nilai kunci akan digunakan untuk semua API di organisasi, buat KVM di cakupan organisasi; atau jika hanya proxy API tertentu yang harus memiliki akses ke kunci/nilai, buat KVM di cakupan apiproxy. Untuk mengetahui informasi selengkapnya, lihat Menggunakan peta nilai kunci.
Kumpulan properti
Set properti adalah kumpulan kustom key-value pair yang menyimpan data. Proxy API dapat mengambil data ini saat dieksekusi.
Biasanya, Anda menggunakan kumpulan properti untuk menyimpan data yang tidak habis masa berlakunya dan tidak boleh di-hardcode dalam logika proxy API, seperti data konfigurasi. Anda dapat mengakses data kumpulan properti di mana saja di proxy tempat Anda dapat mengakses variabel alur.
Kasus penggunaan umum untuk kumpulan properti adalah memberikan nilai yang dikaitkan dengan satu lingkungan atau lingkungan lainnya. Misalnya, Anda dapat membuat kumpulan properti cakupan lingkungan dengan nilai konfigurasi yang spesifik untuk proxy yang berjalan di lingkungan pengujian, dan kumpulan lain untuk lingkungan produksi.
Untuk mengetahui informasi selengkapnya, lihat Menggunakan set properti.
Secret Kubernetes
(Khusus Apigee hybrid) Jika sudah menggunakan Kubernetes untuk pengelolaan secret di vault kustom untuk data sensitif, sebaiknya pertimbangkan untuk menggunakan Kubernetes Secrets. Sama seperti data KVM, Anda dapat mengakses data secret Kubernetes di variabel alur proxy API. Untuk informasi selengkapnya, lihat Menyimpan data di secret Kubernetes.