詞彙解釋

本頁適用於 ApigeeApigee Hybrid

查看 Apigee Edge 說明文件。

以下概念是 Apigee 中具有特殊含義的常見概念。

A

API 基礎路徑和資源
API 由基礎路徑和一組資源 (又稱為「資源路徑」) 組成。您可以為每個 API 定義單一根網址 (也稱為基準路徑) 和多個資源路徑。您可以將 API 想成是一系列 URI,所有 URI 都共用相同的基本路徑。為方便管理 API,Apigee 會在這些原始 URI 中加入顯示名稱和說明。
API 使用者
應用程式開發人員同義,使用 API 供應商建立的 API。
API 開發人員
API 供應商機構中的軟體工程師,負責建構 API。這些 API 可供應用程式開發人員 (API 使用者) 用來建構應用程式。
API 產品
一組 API 資源 (URI) 與服務方案結合,並以組合形式呈現給開發人員。API 產品也可能包含一些專屬於貴商家的中繼資料,用於監控或分析。您可以在 API 產品中加入一或多個資源,然後將這些資源整合至 API 套件,以便營利。
API 供應器
API 供應商會使用 Apigee 建構 API,供 API 消費者 (應用程式開發人員) 使用。
API Proxy
可做為現有 API 外觀的 Proxy。開發人員開始呼叫 Apigee 產生的新 API,而非呼叫現有的 API。此外觀會將您的公開介面與後端 API 分離,讓開發人員不受後端變更影響,同時讓您在邊緣進行創新,而不影響內部開發團隊。在您進行後端變更時,開發人員可以繼續呼叫相同的 API,不會中斷。在更進階的情況下,Apigee 可讓您向同一個 API 公開多個介面,讓您自由自訂 API 的簽名,同時滿足各種開發人員的特殊需求。
Apigee API
可用於設定環境、機構、API Proxy 和其他混合服務的端點。
應用程式開發人員
應用程式開發人員會向 API 供應商註冊應用程式,以便取得呼叫供應商 API Proxy 所需的 API 金鑰。
應用程式
開發人員會透過應用程式存取 API 產品中的資源。建立應用程式時,您會選取要納入的 API 產品,Apigee 就會產生金鑰。每個應用程式都有一個金鑰,可提供對多個 API 產品的存取權。您可以透過應用程式控管誰可以存取您的資源。您可以透過撤銷及重新整理應用程式金鑰,控管哪些人可以存取 API 產品。您也可以透過撤銷或刪除應用程式中產品的存取權,控管資源套件的存取權。

B

餘額詳細資料
如果是預付款開發人員,則為開發人員帳戶中的餘額。

C

Cassandra

(僅限 Apigee hybrid) 執行階段資料存放區,可為在閘道上執行的應用程式儲存應用程式設定、分散式配額計數器、API 金鑰和 OAuth 權杖。

這是一項資源密集的 StatefulSet,應位於與訊息處理器不同的工作節點。

詳情請參閱「關於執行階段平面」。

集中式管理基礎架構 (或平面)
請參閱管理層
容器 [化] 映像檔
請參閱圖片。
控制層
請參閱管理層

D

部署

在 Apigee 中,您可以部署 API Proxy 至環境,讓網際網路上的應用程式用戶端 (不論是公開或私人) 都能存取。

開發人員
「開發人員」是指 Apigee 使用者可執行的角色。Apigee 中的開發人員分為兩種類型:
  • API Proxy 開發人員:建立 API Proxy 並套用政策。
  • 應用程式開發人員:建立使用 API Proxy 的應用程式。
開發人員類別費率方案
適用於特定類別中所有開發人員的費率方案,該類別中的所有開發人員均可購買。
開發人員費率方案
適用於特定開發人員的費率方案,且僅供該開發人員購買。

E

環境

Apigee 環境是指組織內的隔離軟體環境,您可以在其中部署 API Proxy。環境可擴充,以滿足在該環境中部署的 Proxy 需求。您可以在機構中建立多個環境。

環境群組

環境群組是一組 Apigee 環境,其中包含一或多個主機名稱。主機名稱是用於呼叫 API Proxy 的網址一部分,可部署至環境群組中的任何環境。

明確限制
請參閱「自訂限制」一節。

G

GCR
Google Container Repository。
GKE
Google Kubernetes Engine。Google 代管的實際工作環境,可用於將容器化應用程式部署至 Kubernetes。GKE 可讓您立即啟動並執行 Kubernetes,完全不必安裝、管理及操作自己的 Kubernetes 叢集。

I

映像檔存放區
一組共用容器映像檔。
隱含限制
營利功能設定的上限 (例如開發人員預付餘額上限)。
Ingress/Ingress 控制器
容器化應用程式,可將來自叢集外部的流量轉送至叢集內的服務。

K

KMS
金鑰管理服務。儲存、維護及顯示用於加密及解密流量的金鑰和 OAuth 權杖。Apigee KMS 會管理應用程式、開發人員和 API 產品的金鑰。
KVM
鍵/值對應。一組自訂的鍵/值字串組合,可加密或不加密。詳情請參閱使用鍵/值對應
Kubernetes 管理機器
您用來對 Kubernetes 叢集執行指令的本機電腦。這個機器通常是可存取 Kubernetes VM 的桌上型電腦。

M

管理層
Google 代管的中央服務,可透過服務帳戶與執行階段平面進行通訊。
MART

執行階段資料 API 會與本機執行階段資料儲存庫 (Cassandra) 互動。它可做為公用 Apigee API 的 API 供應器,用於存取及管理執行階段資料。

就像訊息處理器一樣,MART 也是無狀態應用程式。這是 Kubernetes 容器化應用程式。

詳情請參閱「關於執行階段平面」。

主要節點
Kubernetes 術語,用於指稱包含 apiserver、cloud-controller-manager (CCM)、排程器和 kube-controller-manager 的節點。
訊息處理器

(僅限 Apigee hybrid) 訊息處理器會評估傳入的要求、執行任何 Apigee 政策,並呼叫後端系統和其他系統來擷取資料。收到這些回應後,訊息處理器會將回應格式化並傳回給用戶端。

MP 是 Kubernetes Deployment。它會針對單一 Apigee 環境進行設定,並指向共用檔案系統中範圍指定的子目錄,同步處理工具會為該目錄提供資料。

MP 會大量消耗資源,因此應放在 Cassandra 的不同工作站節點上。

詳情請參閱「關於執行階段平面」。

營利
Apigee 的元件,可提供簡單易用且彈性的 API 產品營利方式。
每月使用金額
開發人員在特定月份的總用量,包括設定費 + 交易費 + 週期性費用。
每月付款
開發人員根據購買的方案支付的週期性付款。費率方案可能會收取重複收費,無論使用量為何,每月都會向開發人員收取費用。

命名空間
用於分割叢集資源的虛擬叢集。命名空間適用於擁有大量使用者的大型叢集;只有幾十位使用者的較小叢集通常不需要命名空間。

O

開啟調整
尚未在已發布的帳單文件中套用的調整項目。
開啟帳單月份
尚未發布最終的月結單,但已過了整個日曆月份。
開放原始碼 Kubernetes
Kubernetes 的參考實作項目。請參閱 Kubernetes。Apigee Hybrid 執行階段會在符合 CNCF 規範的開放原始碼 Kubernetes 和開放原始碼版本的 Kubernetes 上執行。
機構

Apigee 帳戶中所有實體的容器,包括 API Proxy、API 產品、API 套件、應用程式和開發人員。本文件會交替使用「Apigee 機構」或「支援 Hybrid 的機構」等字詞。

如要安裝及使用 Apigee 或 Apigee Hybrid,您必須擁有與 Google Cloud 專案繫結的 Apigee 機構。您可以在佈建程序中建立機構。

Apigee 機構與 Google Cloud 機構不同。如果可能出現模糊情形,這份文件應明確指出「機構」是「Apigee 機構」

詳情請參閱「機構類型」。

P

Pod
Pod 是 Kubernetes 的基本建構區塊,也是您建立或部署的 Kubernetes 物件模型中最小且最簡單的單位。Pod 代表叢集中執行的程序。
預付餘額
預付開發人員可預先支付的 API 套件費用。
預付開發人員
為使用 API 產品而預先付費的開發人員。使用 API 產品時,系統會從預付開發人員的餘額扣款。開發人員必須維持足夠的預付款餘額,才能購買 API 產品。API 供應商會為開發人員指派預付或後付狀態。
政策
在 API 流程中,以原子可重複使用的邏輯單元執行的處理步驟。常見的政策包括將要求轉送至適當的端點、轉換訊息格式、強制執行存取控制、呼叫遠端服務以取得其他資訊、遮蔽外部使用者的敏感資料、檢查訊息內容是否有潛在威脅、快取常見回應以提升效能等等。系統可能會根據要求或回應訊息的內容或背景,有條件地執行政策。舉例來說,如果要求訊息是從智慧型手機傳送,系統可能會執行轉換政策,以自訂回應格式。
後付開發人員
使用 API 產品的開發人員,每月須支付費用。開發人員會根據費率方案設定的付款條件,支付 API 產品的使用費用。API 供應商會為開發人員指派後付或預付狀態。
proxy
也包括 API ProxyAPI Proxy 是為後端服務 API 前端的抽象層,可提供安全性、頻率限制、配額、數據分析等加值功能。
Proxy 端點
Proxy 端點定義 API Proxy 與用戶端應用程式互動的方式。您可以使用 basepath 設定 Proxy 端點,該 basepath 是 API Proxy 回應的網址的一部分。網址格式為 https://hostname/basepath/pathsuffixes。請參閱「建立 API Proxy」一文。

R

費率方案
說明在已啟用營利 API 套件中提供的 API 產品,使用者須支付的費用、其他收費和收益分潤。
複製控制器
重新排程 Pod,並處理 Pod 的自我修復作業。
資源、資源路徑
資源路徑是 RESTful 概念,可識別特定資源的網路路徑,為統一資源 ID (URI)。
修訂版本
已編號且受版本控制的設定和政策套件,已整合至 API Proxy。這個詞與「版本」不同,後者是面向開發人員的 API 介面。請參閱下方的「版本」一節。
執行階段層

您在自家 Kubernetes 叢集中管理的 Apigee Hybrid 服務,會位於執行階段層。這些服務會透過服務帳戶與管理層通訊。

包括 MART、Synchronizer、訊息處理器、Cassandra 和其他元件。

詳情請參閱「關於執行階段平面」。

執行階段執行個體
Apigee 可設定多個執行階段例項,每個地理區域一個。您可以將一或多個環境附加至執行階段執行個體,為跨區域的 API Proxy 提供高可用性。

S

服務

在執行階段平面中,在 Kubernetes 叢集上執行的容器化應用程式一般稱為「應用程式」。這些服務包括 MART、Synchronizer、訊息處理器和 Cassandra。

詳情請參閱「關於執行階段平面」。

有狀態節點
需要持久性儲存空間來維持狀態的叢集節點。請參閱「設定專屬節點集區」。
無狀態節點
不需要永久性儲存空間的叢集節點。請參閱「設定專屬節點集區」。
同步處理工具

這個執行階段層服務會輪詢管理層,取得各個環境的部署設定和事件。並將有關部署 Proxy、Proxy 設定檔等的必要中繼資料下載至執行階段平面。

同步器會將資訊儲存在訊息處理器可讀取的共用檔案系統中。這會以 DaemonSet 應用程式形式執行,沒有執行階段 API 流量,且可從單一程序/Kubernetes pod 同步多個環境的資料。

詳情請參閱「關於執行階段平面」。

T

目標端點

目標端點會定義 API Proxy 與後端服務互動的方式。您可以設定目標端點,將要求轉送至適當的後端服務,包括定義安全性設定、HTTP 或 HTTPS 通訊協定,以及其他連線資訊。請參閱「變更目標端點」。

儲值
預付開發人員為預付帳戶餘額增值的動作。
transaction_success_def" id="transaction_success_def">交易成功
如果使用
營利變數,系統會指出 API 交易是否已營利。這個變數可用於覆寫根據 HTTP 狀態碼的預設行為。請參閱「 營利變數」。

UAP

整合式數據分析平台。管理層中的 Apigee 服務,可處理傳入的分析、偵錯和部署狀態資料,並透過 Apigee Hybrid UI 或 Apigee API 提供給您。

詳情請參閱「收集偵錯、分析和部署狀態資料」。

UDCA

通用資料收集代理程式。在執行階段平面中資料收集 Pod 中執行的服務,可擷取分析、偵錯和部署狀態資料,並將這些資料傳送至 UAP。

詳情請參閱「收集偵錯、分析和部署狀態資料」。

V

版本
開發人員專用的 API 介面版本。例如:pivotaltracker.com/services/v3, or api.enterprise.apigee.com/v1。(這個詞與 revision 不同,後者是編號的版本控制套件,其中包含組合至 API Proxy 的設定和政策。簡單來說,API 介面有版本,而 API Proxy 則有修訂版本。
磁碟區
可供 Pod 內所有容器化應用程式使用的共用儲存空間。