本頁適用於 Apigee 和 Apigee 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
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 Proxy。API 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 提供高可用性。
- 服務
在執行階段平面中,在 Kubernetes 叢集上執行的容器化應用程式一般稱為「應用程式」。這些服務包括 MART、Synchronizer、訊息處理器和 Cassandra。
詳情請參閱「關於執行階段平面」。
- 有狀態節點
- 需要持久性儲存空間來維持狀態的叢集節點。請參閱「設定專屬節點集區」。
- 無狀態節點
- 不需要永久性儲存空間的叢集節點。請參閱「設定專屬節點集區」。
- 同步處理工具
這個執行階段層服務會輪詢管理層,取得各個環境的部署設定和事件。並將有關部署 Proxy、Proxy 設定檔等的必要中繼資料下載至執行階段平面。
同步器會將資訊儲存在訊息處理器可讀取的共用檔案系統中。這會以 DaemonSet 應用程式形式執行,沒有執行階段 API 流量,且可從單一程序/Kubernetes pod 同步多個環境的資料。
詳情請參閱「關於執行階段平面」。
- 目標端點
目標端點會定義 API Proxy 與後端服務互動的方式。您可以設定目標端點,將要求轉送至適當的後端服務,包括定義安全性設定、HTTP 或 HTTPS 通訊協定,以及其他連線資訊。請參閱「變更目標端點」。
- 儲值
- 預付開發人員為預付帳戶餘額增值的動作。
- transaction_success_def" id="transaction_success_def">交易成功 如果使用
- 營利變數,系統會指出 API 交易是否已營利。這個變數可用於覆寫根據 HTTP 狀態碼的預設行為。請參閱「 營利變數」。
- UAP
整合式數據分析平台。管理層中的 Apigee 服務,可處理傳入的分析、偵錯和部署狀態資料,並透過 Apigee Hybrid UI 或 Apigee API 提供給您。
詳情請參閱「收集偵錯、分析和部署狀態資料」。
- UDCA
通用資料收集代理程式。在執行階段平面中資料收集 Pod 中執行的服務,可擷取分析、偵錯和部署狀態資料,並將這些資料傳送至 UAP。
詳情請參閱「收集偵錯、分析和部署狀態資料」。