Glosarium

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Konsep berikut adalah ide umum yang memiliki arti unik di Apigee.

A

Resource dan jalur dasar API
API terdiri dari jalur dasar dan kumpulan resource (juga dikenal sebagai jalur resource). Untuk setiap API, Anda menentukan satu URL root (juga disebut jalur dasar dan beberapa jalur resource. Anda dapat menganggap API sebagai kumpulan URI, yang semuanya memiliki jalur dasar yang sama. Untuk mempermudah pengelolaan API, Apigee melengkapi URI mentah ini dengan nama dan deskripsi tampilan.
Konsumen API
Sinonim dengan developer aplikasi, yang menggunakan API yang dibuat oleh penyedia API.
Developer API
Software engineer di organisasi penyedia API yang membuat API. API tersebut digunakan oleh developer aplikasi (konsumen API) untuk mem-build aplikasi.
Produk API
Kumpulan resource API (URI) yang digabungkan dengan paket layanan dan ditampilkan kepada developer sebagai paket. Produk API juga dapat menyertakan beberapa metadata khusus untuk bisnis Anda guna pemantauan atau analisis. Satu atau beberapa resource dapat dimonetisasi dengan menyertakannya dalam produk API, yang kemudian dapat dipaketkan ke dalam paket API untuk monetisasi.
Penyedia API
Penyedia API membuat API (menggunakan Apigee) untuk digunakan oleh konsumen API (developer aplikasi).
Proxy API
Proxy yang berfungsi sebagai fasad untuk API yang ada. Daripada memanggil API yang ada, developer mulai memanggil API baru yang dihasilkan oleh Apigee. Fasad ini memisahkan antarmuka publik dari API backend, sehingga melindungi developer dari perubahan backend, sekaligus memungkinkan Anda berinovasi di edge tanpa memengaruhi tim pengembangan internal. Saat Anda membuat perubahan backend, developer akan terus memanggil API yang sama tanpa gangguan. Dalam skenario lanjutan, Apigee memungkinkan Anda mengekspos beberapa antarmuka ke API yang sama, sehingga Anda dapat menyesuaikan tanda tangan API untuk memenuhi kebutuhan berbagai niche developer secara bersamaan.
API Apigee
Endpoint yang dapat Anda gunakan untuk mengonfigurasi lingkungan, organisasi, proxy API, dan layanan campuran lainnya.
developer aplikasi
Developer aplikasi mendaftarkan aplikasi mereka ke penyedia API, yang merupakan cara developer aplikasi mendapatkan kunci API yang mereka perlukan untuk memanggil proxy API penyedia.
aplikasi
Developer Anda menggunakan aplikasi untuk mengakses resource dalam produk API Anda. Saat membuat aplikasi, Anda memilih produk API yang akan disertakan, dan Apigee akan membuat kunci. Setiap aplikasi memiliki satu kunci yang memberikan akses ke beberapa produk API. Aplikasi memungkinkan Anda mengontrol siapa yang dapat mengakses resource Anda. Anda dapat mengontrol siapa saja yang memiliki akses ke produk API Anda dengan mencabut dan memuat ulang kunci aplikasi. Selain itu, Anda dapat mengontrol akses ke paket resource dengan mencabut atau menghapus akses ke produk dalam aplikasi.

B

detail saldo
Untuk developer prabayar, saldo di akun developer.

C

Cassandra

(Khusus Apigee hybrid) Repositori data runtime yang menyimpan konfigurasi aplikasi, penghitung kuota terdistribusi, kunci API, dan token OAuth untuk aplikasi yang berjalan di gateway.

Ini adalah StatefulSet yang membutuhkan banyak resource dan harus berada di node pekerja terpisah dari Message Processor.

Untuk informasi selengkapnya, lihat Tentang platform runtime.

infrastruktur pengelolaan (atau bidang) terpusat
Lihat bidang pengelolaan.
image container[ized]
Lihat gambar.
bidang kontrol
Lihat bidang pengelolaan.

D

deploy

Di Apigee, Anda deploy proxy API ke lingkungan agar dapat diakses oleh klien aplikasi di internet, baik secara publik maupun pribadi, bergantung pada konfigurasi jaringan Anda.

developer
Developer mengacu pada peran yang dapat dilakukan pengguna Apigee. Ada dua jenis developer di Apigee:
  • Developer Proxy API - membuat proxy API dan menerapkan kebijakan.
  • Developer aplikasi - membuat aplikasi yang menggunakan Proxy API.
paket tarif kategori developer
Paket tarif yang berlaku untuk semua developer dalam kategori tertentu dan tersedia untuk dibeli oleh semua developer dalam kategori tersebut.
paket tarif developer
Paket tarif yang berlaku untuk developer tertentu dan hanya tersedia untuk dibeli oleh developer tersebut.

E

lingkungan

Lingkungan Apigee adalah lingkungan software terisolasi, dalam organisasi, tempat Anda deploy proxy API. Lingkungan dapat diskalakan untuk memenuhi permintaan proxy yang di-deploy di sana. Anda dapat membuat beberapa lingkungan di organisasi.

grup lingkungan

Grup lingkungan adalah grup lingkungan Apigee dengan satu atau beberapa nama host. Nama host adalah bagian dari URL yang digunakan untuk memanggil proxy API yang di-deploy ke lingkungan mana pun dalam grup lingkungan.

batas eksplisit
Lihat batas kustom.

G

GCR
Repositori Penampung Google.
GKE
Google Kubernetes Engine. Lingkungan siap produksi yang dikelola Google untuk men-deploy aplikasi dalam container ke Kubernetes. GKE memungkinkan Anda menyiapkan dan menjalankan Kubernetes dalam waktu singkat, dengan sepenuhnya menghilangkan kebutuhan untuk menginstal, mengelola, dan mengoperasikan cluster Kubernetes Anda sendiri.

I

repositori gambar
Sekelompok image container bersama.
batas implisit
Batas (seperti batas saldo prabayar developer) yang ditetapkan oleh monetisasi.
Ingress/Pengontrol ingress
Aplikasi dalam penampung yang merutekan traffic dari luar cluster ke layanan dalam cluster.

Rb

KMS
Key Management Service. Menyimpan, mengelola, dan menampilkan kunci serta token OAuth untuk mengenkripsi dan mendekripsi traffic. KMS Apigee mengelola kunci untuk aplikasi, developer, dan produk API.
KVM
Peta Nilai Kunci. Kumpulan kustom pasangan string kunci/nilai yang dienkripsi atau tidak dienkripsi. Untuk mengetahui informasi selengkapnya, lihat Menggunakan peta nilai kunci.
Mesin administrasi Kubernetes
Komputer lokal yang Anda gunakan untuk menjalankan perintah terhadap cluster Kubernetes. Mesin ini biasanya adalah mesin desktop yang memiliki akses ke VM Kubernetes Anda.

M

bidang pengelolaan
Layanan pusat yang dihosting Google yang berkomunikasi dengan platform runtime melalui akun layanan.
MART

API untuk data runtime berinteraksi dengan datastore runtime lokal (Cassandra). API ini berfungsi sebagai penyedia API untuk Apigee API publik guna mengakses dan mengelola data runtime.

MART adalah aplikasi stateless seperti Pemroses Pesan. Ini adalah aplikasi dalam container Kubernetes.

Untuk informasi selengkapnya, lihat Tentang platform runtime.

node master
Istilah Kubernetes untuk node yang mencakup apiserver, cloud-controller-manager (CCM), penjadwal, dan kube-controller-manager.
Message Processor

(Khusus Apigee hybrid) Message Processor mengevaluasi permintaan yang masuk, menjalankan kebijakan Apigee, dan memanggil sistem backend serta sistem lainnya untuk mengambil data. Setelah respons tersebut diterima, Message Processor akan memformat respons dan menampilkannya ke klien.

MP adalah Deployment Kubernetes. File ini dikonfigurasi untuk satu lingkungan Apigee, yang mengarah ke subdirektori cakupan dalam sistem file bersama tempat Synchronizer menyediakan data.

MP memerlukan banyak resource dan harus berada di node pekerja terpisah dari Cassandra.

Untuk informasi selengkapnya, lihat Tentang platform runtime.

monetisasi
Komponen Apigee yang menyediakan cara yang mudah digunakan dan fleksibel untuk memonetisasi produk API.
jumlah bulanan yang digunakan
Total penggunaan developer untuk bulan tertentu, yang mencakup biaya penyiapan + biaya transaksi + biaya berulang.
pembayaran bulanan
Pembayaran berulang yang dilakukan oleh developer berdasarkan paket yang dibeli. Paket tarif dapat memiliki biaya berulang yang ditagih kepada developer setiap bulan, terlepas dari penggunaannya.

N

namespace
Cluster virtual yang digunakan untuk membagi resource cluster. Namespace ditujukan untuk cluster yang lebih besar dengan banyak pengguna; cluster yang lebih kecil dengan hanya puluhan pengguna biasanya tidak memerlukan namespace.

O

penyesuaian terbuka
Penyesuaian yang belum diterapkan dalam dokumen penagihan yang dipublikasikan.
bulan penagihan terbuka
Bulan kalender lengkap yang dokumen penagihan akhir-nya belum dipublikasikan.
Kubernetes open source
Penerapan referensi Kubernetes. Lihat Kubernetes. Runtime hibrida Apigee berjalan di Kubernetes open source dan versi Kubernetes berbasis open source yang sesuai dengan CNCF.
organisasi

Penampung untuk semua entitas di akun Apigee, termasuk proxy API, produk API, paket API, aplikasi, dan developer. Dokumen ini menggunakan istilah organisasi Apigee atau organisasi yang mendukung hybrid secara bergantian.

Untuk menginstal dan menggunakan Apigee atau Apigee hybrid, Anda harus memiliki organisasi Apigee yang terikat dengan project Google Cloud. Anda melakukannya saat membuat organisasi dalam proses yang dikenal sebagai penyediaan.

Organisasi Apigee tidak sama dengan organisasi Google Cloud. Jika ada kemungkinan ambiguitas, dokumen ini harus menentukan bahwa organisasi adalah organisasi Apigee.

Untuk mengetahui informasi selengkapnya, lihat Jenis organisasi.

P

pod
pod adalah elemen penyusun dasar Kubernetes: unit terkecil dan paling sederhana dalam model objek Kubernetes yang Anda buat atau deploy. Pod mewakili proses yang berjalan di cluster Anda.
saldo prabayar
Jumlah uang yang tersedia bagi developer prabayar untuk membayar di muka untuk paket API.
developer prabayar
Developer yang membayar di muka untuk penggunaan produk API. Dana akan dipotong dari saldo developer prabayar saat produk API digunakan. Developer harus mempertahankan saldo prabayar yang cukup untuk membeli produk API. Developer diberi status prabayar atau pascabayar oleh penyedia API.
kebijakan
Langkah pemrosesan yang dijalankan sebagai unit logika atomik yang dapat digunakan kembali dalam alur API. Kebijakan umum mencakup permintaan pemilihan rute ke endpoint yang tepat, mengubah format pesan, menerapkan kontrol akses, memanggil layanan jarak jauh untuk informasi tambahan, menyamarkan data sensitif dari pengguna eksternal, memeriksa konten pesan untuk potensi ancaman, meng-cache respons umum untuk meningkatkan performa, dan sebagainya. Kebijakan dapat dijalankan secara bersyarat berdasarkan konten atau konteks pesan permintaan atau respons. Misalnya, kebijakan transformasi dapat dijalankan untuk menyesuaikan format respons jika pesan permintaan dikirim dari smartphone.
developer pascabayar
Developer yang ditagih bulanan untuk penggunaan produk API. Developer membayar penggunaan produk API berdasarkan persyaratan pembayaran yang ditetapkan oleh paket tarif. Developer diberi status pascabayar atau prabayar oleh penyedia API.
proxy
Juga proxy API. Proxy API adalah lapisan abstraksi yang menjadi bagian depan untuk API layanan backend Anda dan menyediakan fitur nilai tambah seperti keamanan, pembatasan kapasitas, kuota, analisis, dan lainnya.
endpoint proxy
Endpoint proxy menentukan cara proxy API Anda berinteraksi dengan aplikasi klien. Anda mengonfigurasi endpoint proxy dengan jalur dasar yang merupakan bagian dari URL yang direspons oleh Proxy API Anda. URL memiliki bentuk https://hostname/basepath/pathsuffixes. Lihat Membuat Proxy API.

R

paket tarif
Spesifikasi biaya, tagihan lainnya, dan pembagian keuntungan untuk penggunaan produk API yang ditawarkan dalam paket API yang dimonetisasi.
pengontrol replikasi
Menjadwalkan ulang pod dan menangani perbaikan mandiri untuk pod.
resource, resource path
Konsep RESTful, jalur resource adalah Uniform Resource Identifier (URI) yang mengidentifikasi jalur jaringan ke resource tertentu.
revisi
Paket konfigurasi dan kebijakan yang diberi nomor dan dikontrol versi yang dipaketkan ke dalam Proxy API. Istilah ini berbeda dengan versi, yang merupakan antarmuka API yang ditampilkan kepada developer. Lihat "versi" di bawah.
bidang runtime

Layanan hybrid Apigee yang Anda kelola di cluster Kubernetes Anda sendiri ada dalam platform runtime. Layanan ini berkomunikasi melalui akun layanan dengan platform pengelolaan.

Mencakup MART, Synchronizer, Message Processors, Cassandra, dan komponen lainnya.

Untuk informasi selengkapnya, lihat Tentang platform runtime.

instance runtime
Apigee dapat dikonfigurasi dengan beberapa instance runtime, satu per wilayah geografis. Satu atau beberapa Lingkungan dapat dilampirkan ke instance runtime, sehingga memberikan ketersediaan tinggi untuk proxy API di seluruh region.

S

pelanggan

Istilah umum untuk aplikasi dalam container yang berjalan di cluster Kubernetes Anda di platform runtime. Layanan ini mencakup MART, Synchronizer, Message Processors, dan Cassandra.

Untuk informasi selengkapnya, lihat Tentang platform runtime.

node stateful
Node cluster yang memerlukan penyimpanan persisten untuk mempertahankan status. Lihat Mengonfigurasi node pool khusus.
node stateless
Node cluster yang tidak memerlukan penyimpanan persisten. Lihat Mengonfigurasi node pool khusus.
Synchronizer

Layanan bidang runtime yang melakukan polling pada bidang pengelolaan untuk konfigurasi dan peristiwa deployment untuk setiap lingkungan. Alat ini mendownload metadata yang diperlukan tentang proxy yang di-deploy, file konfigurasi proxy, dan lainnya ke platform runtime.

Synchronizer menyimpan informasinya di sistem file bersama yang dibaca Message Processor. Aplikasi ini akan berjalan sebagai aplikasi DaemonSet; tidak memiliki traffic API runtime dan dapat menyinkronkan data untuk beberapa lingkungan dari satu proses/pod Kubernetes.

Untuk informasi selengkapnya, lihat Tentang platform runtime.

S

endpoint target

Endpoint target menentukan cara proxy API berinteraksi dengan layanan backend Anda. Anda mengonfigurasi endpoint target untuk meneruskan permintaan ke layanan backend yang tepat, termasuk menentukan setelan keamanan, protokol HTTP atau HTTPS, dan informasi koneksi lainnya. Lihat Mengubah endpoint target.

isi ulang
Tindakan yang dilakukan oleh developer prabayar untuk menambahkan dana ke saldo prabayar.
transaction_success_def" id="transaction_success_def">transaction success
Variabel monetisasi
, jika digunakan, menunjukkan bahwa transaksi API dimonetisasi atau tidak. Variabel ini dapat digunakan untuk mengganti perilaku default yang didasarkan pada kode status HTTP. Lihat Variabel monetisasi.

U

UAP

Platform Analisis Terpadu. Layanan Apigee di platform manajemen yang memproses data status deployment, debug, dan analisis yang masuk, serta menyediakannya kepada Anda melalui UI hybrid Apigee atau Apigee API.

Untuk informasi selengkapnya, lihat Pengumpulan data status debug, analisis, dan deployment.

UDCA

Universal Data Collection Agent. Layanan yang berjalan dalam pod pengumpulan data di platform runtime yang mengekstrak data status analisis, debug, dan deployment, lalu mengirimkannya ke UAP.

Untuk informasi selengkapnya, lihat Pengumpulan data status debug, analisis, dan deployment.

V

versi
Versi antarmuka API yang ditampilkan kepada developer. Misalnya, pivotaltracker.com/services/v3, or api.enterprise.apigee.com/v1. (Istilah ini berbeda dengan revision, yang merupakan paket konfigurasi dan kebijakan terkontrol versi bernomor yang dipaketkan ke dalam proxy API. Singkatnya, antarmuka API memiliki versi, sedangkan proxy API memiliki revisi.
volume
Penyimpanan bersama yang dapat digunakan oleh semua aplikasi dalam penampung dalam pod.