本頁內容適用於 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，應與 Message Processor 位於不同的工作站節點。
詳情請參閱「關於執行階段平面」。
- 中央管理基礎架構 (或平面)
- 請參閱管理平面。
- 容器化映像檔
- 請參閱圖片。
- 控制層
- 請參閱管理平面。
D
- deploy
在 Apigee 中，您可以部署 API Proxy 至環境，讓網際網路上的應用程式用戶端 (公開或私下) 存取，具體取決於您的網路設定。
- 開發人員
- 開發人員是指 Apigee 使用者可執行的角色。
Apigee 有兩種類型的開發人員：
- API Proxy 開發人員 - 建立 API Proxy 並套用政策。
- 應用程式開發人員 - 建立使用 API Proxy 的應用程式。
- 開發人員類別費率方案
- 適用於特定類別中所有開發人員的費率方案，該類別中的所有開發人員皆可購買。
- 開發人員費率方案
- 適用於特定開發人員的費率方案，只有該開發人員可以購買。
E
- 環境
Apigee 環境是組織內獨立的軟體環境，您可以在其中部署 API Proxy。環境可以擴充，滿足部署在其中的 Proxy 需求。 您可以在機構中建立多個環境。
- 環境群組
-
環境群組是一組 Apigee 環境，包含一或多個主機名稱。主機名稱是網址的一部分，用於呼叫 API Proxy，這些 Proxy 會部署至環境群組中的任何環境。
- 明確限制
- 請參閱自訂上限。
G
- GCR
- Google Container Repository。
- GKE
- Google Kubernetes Engine。Google 代管的環境，專供部署容器化應用程式至 Kubernetes，隨時可用於實際工作。GKE 可讓您立即啟動並執行 Kubernetes，完全不必安裝、管理及操作自己的 Kubernetes 叢集。
I
K
- KMS
- Key Management Service。儲存、維護及提供用於加密和解密流量的金鑰和 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) Message Processor 會評估傳入的要求、執行所有 Apigee 政策，並呼叫後端系統和其他系統來擷取資料。收到這些回覆後，訊息處理器會格式化回覆，並傳回給用戶端。
MP 是 Kubernetes Deployment。這個目錄是為單一 Apigee 環境設定，指向共用檔案系統中範圍受限的子目錄，同步處理工具會將資料提供給該子目錄。
MP 會耗用大量資源，因此應與 Cassandra 位於不同的工作站節點。
詳情請參閱「關於執行階段平面」。
- 營利
- Apigee 的元件，提供簡單易用且彈性的 API 產品營利方式。
- 每月用量
- 開發人員在特定月份的總用量，包括設定費 + 交易費 + 週期性費用。
- 每月付款
- 開發人員根據購買的方案支付的週期性款項。費率方案可能包含每月向開發人員收取的經常性費用，無論使用情況如何。
否
- 命名空間
- 用於分割叢集資源的虛擬叢集。命名空間適用於使用者眾多的大型叢集；只有數十名使用者的較小叢集通常不需要命名空間。
O
- 開啟調整項
- 尚未在已發布的帳單文件中套用的調整項。
- 未結帳的帳單月份
- 尚未發布最終帳單文件的完整曆月。
- 開放原始碼 Kubernetes
- Kubernetes 的參考實作。請參閱 Kubernetes。Apigee Hybrid 執行階段會在開放原始碼 Kubernetes 和符合 CNCF 標準的 Kubernetes 開放原始碼版本上執行。
- 組織
Apigee 帳戶中所有實體的容器，包括 API Proxy、API 產品、API 套件、應用程式和開發人員。這份文件會交替使用「Apigee 機構」或「啟用混合式功能的機構」。
如要安裝及使用 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 與用戶端應用程式的互動方式。您可以使用基本路徑設定 Proxy 端點，該路徑是 API Proxy 回應的網址一部分。網址格式為
https://hostname/basepath/pathsuffixes。 請參閱「建立 API Proxy」。
R
- 房價方案
- 使用營利 API 套件中提供的 API 產品時，需支付的費用、其他費用和收益分成比例。
- 複製控制器
- 重新排定 Pod 的時間，並處理 Pod 的自我修復作業。
- 資源、資源路徑
- 資源路徑是 RESTful 概念，也是統一資源 ID (URI)，用於識別特定資源的網路路徑。
- 修訂版本
- 設定和政策的套件，以編號控管版本，並與 API Proxy 搭配組合。這個詞彙與「版本」不同，後者是開發人員使用的 API 介面。請參閱下方的「版本」一節。
- 執行階段層
您在自己的 Kubernetes 叢集上管理的 Apigee Hybrid 服務，都位於執行階段層。這些服務會透過服務帳戶與管理平台通訊。
包括 MART、Synchronizer、Message Processors、Cassandra 和其他元件。
詳情請參閱「關於執行階段平面」。
- 執行階段例項
- Apigee 可設定多個執行階段例項，每個地理區域各一個。 您可以將一或多個環境附加至執行階段例項，藉此為跨區域的 API Proxy 提供高可用性。
- 服務
在執行階段平面上，於 Kubernetes 叢集執行的容器化應用程式一般稱為「工作負載」。這些服務包括 MART、Synchronizer、Message Processors 和 Cassandra。
詳情請參閱「關於執行階段平面」。
- 有狀態節點
- 需要永久儲存空間來維持狀態的叢集節點。請參閱「設定專屬節點集區」。
- 無狀態節點
- 不需要永久儲存空間的叢集節點。請參閱「設定專屬節點集區」。
- 同步處理工具
執行階段層服務，會輪詢管理層，取得每個環境的部署設定和事件。這個指令會將已部署 Proxy 的必要中繼資料、Proxy 設定檔等內容下載至執行階段層面。
Synchronizer 會將資訊儲存在共用檔案系統中，供 Message Processor 讀取。這會以 DaemonSet 應用程式的形式執行，沒有執行階段 API 流量，且可從單一程序/Kubernetes Pod 同步處理多個環境的資料。
詳情請參閱「關於執行階段平面」。
- 目標端點
目標端點會定義 API Proxy 與後端服務的互動方式。您可以設定目標端點，將要求轉送至適當的後端服務，包括定義安全性設定、HTTP 或 HTTPS 通訊協定，以及其他連線資訊。請參閱變更目標端點。
- 加值
- 預付型開發人員為預付餘額充值的動作。
- transaction_success_def" id="transaction_success_def">交易成功
- 營利變數 (如使用) 會指出 API 交易是否營利。這個變數可用於覆寫根據 HTTP 狀態碼的預設行為。請參閱「 營利變數」。
- UAP
整合式數據分析平台。管理層中的 Apigee 服務，可處理傳入的 Analytics、偵錯和部署狀態資料，並透過 Apigee Hybrid 使用者介面或 Apigee API 提供給您。
詳情請參閱「收集偵錯、分析和部署狀態資料」。
- UDCA
通用資料收集代理程式。在執行階段層的資料收集 Pod 中執行的服務，可擷取分析、偵錯和部署狀態資料，並傳送至 UAP。
詳情請參閱「收集偵錯、分析和部署狀態資料」。