Menggunakan modul akses apigee

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Modul apigee-access memungkinkan Anda mengakses variabel dan cache alur proxy API dari dalam kode aplikasi Node.js. Modul ini disertakan dengan platform Apigee Edge; Anda tidak perlu menginstalnya seperti yang Anda lakukan dengan modul Node.js lainnya.

Mendapatkan apigee-access

Modul apigee-access terintegrasi ke dalam platform Apigee Edge. Saat Anda men-deploy kode Node.js ke Edge, modul ini tersedia untuk Anda. Anda hanya perlu memerlukannya dalam kode Node.js yang Anda deploy. Contoh:

var access=require('apigee-access');

Mengakses variabel alur

Saat men-deploy aplikasi Node.js ke Edge, Anda dapat mengakses salah satu variabel alur "langsung pakai" yang didukung, variabel alur yang dibuat oleh kebijakan, dan variabel alur yang Anda buat sendiri dari dalam kode Node.js. Variabel alur dibuat dan ada dalam konteks proxy API yang berjalan di Edge. Untuk mengetahui informasi mendetail, lihat Mengakses variabel alur di Node.js.

Mengakses cache

Modul apigee-access memungkinkan Anda mengakses cache terdistribusi Apigee Edge dari kode Node.js. Untuk mengetahui informasi mendetail, lihat Mengakses cache di Node.js.

Menggunakan layanan kuota

Modul apigee-access memungkinkan Anda mengakses layanan kuota Apigee Edge dari kode Node.js. Untuk mengetahui informasi mendetail, lihat Mengakses layanan kuota di Node.js.

Mengakses Peta Nilai Kunci

Modul apigee-access memungkinkan Anda mengakses peta nilai kunci (KVM) Apigee Edge dari kode Node.js. Untuk mengetahui informasi mendetail, lihat Mengakses peta nilai kunci di Node.js.

Menjalankan dalam mode lokal vs mode yang di-deploy

Untuk mendukung pengembangan dan pengujian lokal, modul apigee-access berfungsi dalam mode lokal tanpa dependensi pada Apigee Edge; namun, saat modul digunakan dengan proxy API yang di-deploy ke Edge, fungsi "lokal" akan diganti dengan fungsi Edge native. Misalnya, variabel alur lengkap dapat diakses dalam mode yang di-deploy, sedangkan hanya sebagian kecil yang tersedia saat Anda menjalankan aplikasi Node.js secara lokal. Untuk mengetahui daftar variabel mode lokal ini, lihat Menjalankan dalam mode lokal.

Menentukan mode tempat modul berjalan

Untuk menentukan mode tempat Anda menjalankan apigee-access:

var access = require('apigee-access')
console.log('The deployment mode is ' + access.getMode());

Nilai yang ditampilkan getMode() memberi tahu Anda apakah aplikasi Node.js di-deploy ke Apigee Edge atau berjalan dalam mode mandiri. Metode ini menampilkan salah satu dari dua hasil string berikut:

  • apigee - Aplikasi Node.js berjalan di Apigee Edge dan semua fungsi didukung.
  • standalone - Aplikasi Node.js berjalan di luar lingkungan Apigee Edge dan fungsi default yang dijelaskan di bagian atas dokumen akan berlaku.

Menjalankan dalam mode yang di-deploy

Saat di-deploy ke Edge, variabel yang ditetapkan oleh kebijakan akan terlihat oleh apigee-access, dan variabel yang ditambahkan atau diubah oleh metode modul ini akan terlihat oleh kebijakan berikutnya dalam alur proxy.

Anda dapat menemukan link variabel yang didukung di Referensi Variabel. Variabel ini, dan variabel apa pun yang Anda buat dengan nama Anda sendiri, akan terlihat oleh apigee-access. Perhatikan bahwa beberapa variabel bersifat hanya baca. Variabel tersebut diidentifikasi dalam Referensi Variabel.

Menjalankan dalam mode lokal

Dalam "mode lokal", Anda menjalankan kode Node.js di luar konteks Apigee Edge. Dalam mode ini, sebagian besar variabel alur yang telah ditentukan sebelumnya tidak dapat diakses dalam kode Node.js code. Tabel ini menampilkan sebagian kecil variabel alur yang tersedia. Variabel ini didukung di sini untuk mendukung pengembangan dan pengujian lokal aplikasi Node.js untuk Apigee Edge.

Variabel Hanya Baca Jenis Catatan
client.received.start.time Ya String Waktu saat permintaan diterima
client.received.end.time Ya String Waktu saat permintaan diterima
client.received.start.timestamp Ya Bilangan bulat Waktu saat permintaan diterima
client.received.end.timestamp Ya Bilangan bulat Waktu saat permintaan diterima

Sekali lagi, di platform Apigee Edge, kumpulan variabel yang telah ditentukan sebelumnya yang jauh lebih besar didukung. Lihat Referensi Variabel Apigee Edge untuk mengetahui daftar lengkapnya.