Glosarium

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

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

A

Jalur dasar dan resource API
API terdiri dari jalur dasar dan sekumpulan resource (juga dikenal sebagai jalur resource). Untuk setiap API, Anda menentukan satu URL root (disebut juga jalur dasar dan beberapa jalur resource. Anda dapat menganggap API hanya sebagai sekumpulan URI, yang semuanya memiliki jalur dasar yang sama. Untuk mempermudah pengelolaan API, Apigee melengkapi URI mentah ini dengan nama tampilan dan deskripsi.
Konsumen API
Sinonim dengan developer aplikasi, yang menggunakan API yang dibuat oleh penyedia API.
Developer API
Seorang software engineer di organisasi penyedia API yang membangun API. API tersebut digunakan oleh developer aplikasi (konsumen API) untuk membangun aplikasi.
Produk API
Kumpulan resource API (URI) yang digabungkan dengan paket layanan dan ditampilkan kepada developer sebagai satu 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 digabungkan ke dalam paket API untuk monetisasi.
Penyedia API
Penyedia API membangun API (menggunakan Apigee) untuk digunakan oleh konsumen API (developer aplikasi).
Proxy API
Proxy yang bertindak sebagai fasad untuk API Anda yang sudah ada. Daripada memanggil API yang sudah ada, developer mulai memanggil API baru yang dihasilkan oleh Apigee. Fasad ini memisahkan antarmuka publik dari API backend Anda, melindungi developer dari perubahan backend, sekaligus memungkinkan Anda berinovasi di edge tanpa memengaruhi tim pengembangan internal. Saat Anda membuat perubahan backend, developer terus memanggil API yang sama tanpa gangguan. Dalam skenario yang lebih canggih, Apigee memungkinkan Anda mengekspos berbagai antarmuka ke API yang sama, sehingga Anda tidak perlu menyesuaikan tanda tangan API untuk memenuhi kebutuhan berbagai segmen developer secara bersamaan.
API Apigee
Endpoint yang dapat Anda gunakan untuk mengonfigurasi lingkungan, organisasi, proxy API, dan layanan hybrid lainnya.
developer aplikasi
Developer aplikasi mendaftarkan aplikasinya ke penyedia API, yang merupakan cara developer aplikasi mendapatkan kunci API yang diperlukan untuk memanggil proxy API penyedia.
aplikasi
Developer menggunakan aplikasi untuk mengakses resource di produk API Anda. Saat membuat aplikasi, Anda memilih produk API yang akan disertakan, dan Apigee akan menghasilkan 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 yang memiliki akses ke produk API Anda dengan mencabut dan memuat ulang kunci aplikasi. Anda juga 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 memerlukan banyak resource dan harus berada di node pekerja yang terpisah dari Pemroses Pesan.

Untuk informasi selengkapnya, lihat Tentang bidang runtime.

infrastruktur pengelolaan terpusat (atau bidang)
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, tergantung 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.
  • Pengembang 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 yang terisolasi, dalam organisasi, tempat Anda deploy proxy API. Lingkungan dapat diskalakan untuk memenuhi permintaan {i>proxy<i} yang di-deploy di sana. Anda dapat membuat beberapa lingkungan dalam sebuah organisasi.

grup lingkungan

Grup lingkungan adalah sekumpulan 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 di grup lingkungan.

batas eksplisit
Lihat batas khusus.

G

GCR
Repositori Container 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 menghilangkan sepenuhnya kebutuhan untuk menginstal, mengelola, dan mengoperasikan cluster Kubernetes Anda sendiri.

I

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

Rb

KMS
Layanan Pengelolaan Kunci. Menyimpan, memelihara, dan menyajikan kunci dan 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
Mesin lokal yang Anda gunakan untuk menjalankan perintah pada cluster Kubernetes. Mesin ini biasanya adalah mesin desktop yang memiliki akses ke VM Kubernetes Anda.

M

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

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

MART adalah aplikasi stateless seperti Message Processors. Library ini adalah aplikasi dalam container Kubernetes.

Untuk informasi selengkapnya, lihat Tentang bidang runtime.

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

(Khusus Apigee Hybrid) Pemroses Pesan mengevaluasi permintaan yang masuk, mengeksekusi semua kebijakan Apigee, dan memanggil sistem backend serta sistem lainnya untuk mengambil data. Setelah respons tersebut diterima, Pemroses Pesan akan memformat respons dan menampilkannya ke klien.

MP adalah Deployment Kubernetes. File ini dikonfigurasi untuk lingkungan Apigee tunggal, yang mengarah ke subdirektori cakupan dalam sistem file bersama yang disediakan oleh Synchronizer.

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

Untuk informasi selengkapnya, lihat Tentang bidang runtime.

monetisasi
Komponen Apigee yang menyediakan cara yang mudah digunakan dan fleksibel untuk memonetisasi produk API.
jumlah penggunaan bulanan
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 ditagihkan kepada developer setiap bulan, terlepas dari penggunaannya.

N

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

O

buka penyesuaian
Penyesuaian yang belum diterapkan dalam dokumen penagihan yang dipublikasikan.
bulan penagihan terbuka
Satu bulan kalender lengkap ketika dokumen penagihan final belum dipublikasikan.
Kubernetes open source
Implementasi referensi Kubernetes. Lihat Kubernetes. Runtime hybrid Apigee berjalan di Kubernetes open source dan Kubernetes versi berbasis open source yang sesuai dengan CNCF.
organisasi

Container untuk semua entity 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 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
Sejumlah 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 dipotong dari saldo developer prabayar saat produk API digunakan. Developer harus memiliki saldo prabayar yang memadai 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 pemilihan rute permintaan ke endpoint yang tepat, mengubah format pesan, menerapkan kontrol akses, memanggil layanan jarak jauh untuk mendapatkan informasi tambahan, menyamarkan data sensitif dari pengguna eksternal, memeriksa konten pesan untuk menemukan potensi ancaman, menyimpan respons umum dalam cache untuk meningkatkan performa, dan sebagainya. Kebijakan dapat dieksekusi secara bersyarat berdasarkan konten atau konteks permintaan atau pesan respons. Misalnya, kebijakan transformasi dapat dijalankan untuk menyesuaikan format respons jika pesan permintaan dikirim dari smartphone.
developer pascabayar
Developer yang ditagih setiap bulan 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 menghadapi API layanan backend Anda dan menyediakan fitur bernilai 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-nya memiliki bentuk https://hostname/basepath/pathsuffixes. Lihat Membuat Proxy API.

R

paket tarif
Spesifikasi biaya, biaya lainnya, dan pembagian keuntungan untuk penggunaan produk API yang ditawarkan dalam paket API yang dimonetisasi.
pengontrol replikasi
Menjadwal ulang pod dan menangani pemulihan mandiri untuk pod.
resource, jalur resource
Konsep RESTful, jalur resource adalah Uniform Resource Identifier (URI) yang mengidentifikasi jalur jaringan ke resource tertentu.
revisi
Paket konfigurasi dan kebijakan bernomor yang dikontrol versi dan dipaketkan menjadi Proxy API. Istilah ini dibedakan dengan versi, yang merupakan antarmuka API yang dapat digunakan developer. Lihat "versi" di bawah.
bidang runtime

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

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

Untuk informasi selengkapnya, lihat Tentang bidang runtime.

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

S

pelanggan

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

Untuk informasi selengkapnya, lihat Tentang bidang 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.
Penyinkron

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

Sinkronisasi menyimpan informasinya pada sistem file bersama yang dibaca oleh Pemroses Pesan. Ini akan dijalankan sebagai aplikasi DaemonSet; aplikasi ini tidak memiliki traffic API runtime dan dapat menyinkronkan data untuk beberapa lingkungan dari satu pod proses/Kubernetes.

Untuk informasi selengkapnya, lihat Tentang bidang runtime.

T

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.

penambahan saldo
Tindakan yang diambil oleh developer prabayar untuk menambahkan dana ke saldo prabayar.
transaksi_berhasil_def" id="transaction_problem_def">berhasil transaksi
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 Analytics Terpadu. Layanan Apigee di bidang pengelolaan yang memproses data analisis, debug, dan status deployment yang masuk serta menyediakannya untuk Anda melalui UI hybrid Apigee atau Apigee API.

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

UDCA

Agen Pengumpulan Data Universal. Layanan yang berjalan di dalam pod pengumpulan data di bidang runtime yang mengekstrak data analisis, debug, dan status deployment, lalu mengirimkannya ke UAP.

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

V

versi
Versi antarmuka API yang dapat dilihat oleh developer. Misalnya: pivotaltracker.com/services/v3, or api.enterprise.apigee.com/v1. (Istilah ini dibedakan dari revision, yang merupakan paket konfigurasi dan kebijakan bernomor yang dikontrol versi yang dipaketkan menjadi proxy API. Singkatnya, antarmuka API memiliki beberapa versi, sedangkan proxy API memiliki revisi.
volume
Penyimpanan bersama yang dapat digunakan oleh semua aplikasi dalam container di dalam sebuah pod.