您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
本主題說明 Apigee X (有時也稱為「Apigee」) 與 Apigee Edge 的差異。本文資訊適用於正在考慮遷移至 Apigee X 的現有 Apigee Edge 客戶。
如要進一步瞭解 Apigee X 功能,請參閱 Apigee X 功能摘要。
下表列出在本主題中比較的 Apigee API 管理產品:
產品 | 代管位置 | 管理者: |
---|---|---|
公有雲的 Apigee Edge | Apigee 的雲端 | Apigee |
適用於私有雲的 Apigee Edge | 客戶的私人資料中心。 | 客戶 |
Apigee X | Google Cloud | Apigee |
Apigee Hybrid | Google Cloud 和客戶的私人資料中心 | Apigee 會管理管理層,由客戶管理執行階段層。 |
Apigee Edge 到 Apigee X 功能比較
以下各節將比較 Apigee Edge 公開/私人 Cloud 功能與 Apigee X 和混合式環境的功能。
請注意,Apigee X 限制也與 Apigee Edge 限制不同。
目前功能差異摘要
下表說明 Apigee X (和混合型) 與適用於公開與私人雲端平台的 Apigee Edge 的功能層級差異。
Apigee Edge 功能 | 支援 Apigee X 和 Hybrid |
---|---|
API Proxy 修訂版本 |
部署後無法變更 |
有效健康狀態檢查 | 支援使用 VM 的外部 MIG。使用 Private Service Connect 時不支援這項功能。如要瞭解轉送類型,請參閱「設定路徑」一文。 |
Istio 適用的 Apigee 轉接器 | 已淘汰:建議您改用 Apigee Adapter for Envoy。 |
公司 和開發人員 |
我們也有類似但不同的解決方案。請參閱「使用 AppGroup 整理應用程式擁有權」。 |
CwC (含 設定的代碼) |
已排程 |
Deployment |
|
環境 |
詳情請參閱「關於環境和環境群組」。 |
代管目標 |
請使用 Cloud Run 或 Cloud Functions |
HTTP/1.1 標頭欄位名稱處理 | 轉送至後端時,將 HTTP/1.1 標頭欄位名稱轉換為小寫。在 Apigee Edge 中,系統會保留標頭欄位名稱大小寫。 |
可透過 IAM 角色精細控管角色型存取權 |
已排程 |
使用 [@.length-x] 的 JSONPath |
Apigee X 不支援在 JSONPath 運算式中使用 在這個例子中: { "books": [ { "name": "A", }, { "name": "B", } ] } 輸入內容: |
KeyStore/Truststore |
以 Kubernetes 密鑰的形式從北行代管 |
KVM |
若要進一步瞭解如何在 UI 中建立 KVM,請參閱使用鍵/值對應。如要瞭解如何選擇合適的資料持續性機制,另請參閱「存取設定資料」一文。 |
Microgateway | 建議您改用 Apigee Adapter for Envoy。 |
營利 | 請參閱「 與營利的差異」一節 |
Node.js |
|
北行 mTLS | 已排程 |
OAuth | 新增 RevokeOAuthv2 政策後,使用者 ID 和/或應用程式 ID 就會撤銷政策。這項政策會取代 Apigee Edge API,以撤銷 OAuth2 權杖。 |
政策 |
|
reasonPhrase | 不支援。 |
資源 | 無法使用機構層級資源 |
角色和權限 |
詳情請參閱「 使用者和角色」。 |
Sense | 使用進階 API 安全性功能。 |
「建構 Proxy」精靈中的 SOAP 服務 | 不支援。請參閱 wsdl2apigee,此專案可提供 SOAP 公用程式,以便搭配 Apigee 使用。 |
追蹤記錄/偵錯工作階段 | 請參閱「與 Trace 的差異」一節。 |
虛擬主機 | 適用於 Apigee Hybrid:
如為 Apigee X:
|
與 Trace 的差異
下表比較了 Trace 在 Apigee X、混合式雲端和 Apigee Edge Cloud 中其運作方式的差異:
功能 | Apigee Edge Cloud | Apigee X 與 Hybrid |
---|---|---|
及時性 | 即時;同步 | 稍有延遲;非同步 |
工作階段名稱/ID | 接受使用者的工作階段名稱 | 不接受使用者的工作階段名稱 |
濾鏡 | 基本篩選器支援,例如標頭和查詢參數篩選 | 支援複雜的篩選邏輯,包括 AND 和 OR 邏輯運算。存取 流程變數參考資料中提及的任何流程變數。語法與條件式使用相同,如條件參考資料所示。 |
工作階段逾時 | 定義偵錯工作階段的長度,以及資料的保留時間。 透過 API 呼叫啟動時,預設值為 20 分鐘;在 UI 中啟動時,預設值為 10 分鐘。 |
僅定義偵錯工作階段的長度。起點是訊息處理者收到以偵錯模式執行的要求時。 如果工作階段透過 API 啟動,預設值為 5 分鐘;如果是透過 UI 啟動,則預設值為 10 分鐘。 資料會保留 24 小時,之後混合就會自動刪除。 |
工作階段有效性 | 工作階段建立要求的有效時間長度。如果偵錯工作階段未在這段時間內啟動,同步處理器可以忽略工作階段建立要求。請務必按照必備條件中的說明,讓同步程式的時鐘保持同步。 | |
追蹤記錄要求數量 | 每個訊息處理器最多 20 個 | 預設值為每個「訊息處理器」10;上限為 15。 |
API | Apigee Edge Cloud | Apigee X |
Apigee X 公開 Debug Session API 和 Debug Session Data API,但不支援透過 Apigee X API 支援下列項目: | ||
停止偵錯工作階段 | ||
刪除特定交易 |
與營利的差異
下表比較 Apigee Edge Monetization 和 Apigee X Monetize 的主要功能。
Apigee Edge 營利 | Apigee X/混合型營利 |
---|---|
費率方案與可附加至多項 API 產品的 API 產品套裝組合相關聯 | 費率方案與 API 產品相關聯 (一對一關係) |
應用程式開發人員購買費率方案 | 應用程式開發人員購買 API 產品 |
配額是在 API Proxy 層級進行管理 | 配額是由 API 產品層級管理 (商家層級) |
已發布的費率方案只能過期,無法編輯或刪除 | 已發布的費率方案可能會處於過期、編輯、移至草稿或已刪除狀態 |
複雜的設定 (沒有精靈或預覽工具) | 使用精靈和預覽工具簡化費率方案設定 |
如果應用程式開發人員尚未購買訂閱項目,MonetizationLimitsCheck 政策會在系統處理第一個 API 呼叫後封鎖存取權 |
如果應用程式開發人員尚未購買訂閱項目或超過配額,MonetizationLimitsCheck 政策會立即封鎖存取權 |
可以在交易記錄政策中使用自訂變數擷取交易營利資料。 | Apigee 會自動擷取營利資料,交易的營利資料則可使用 DataCapture 政策覆寫。詳情請參閱「擷取營利資料」一文。 |
您可以為開發人員和費率方案設定預付帳戶和後付帳戶。 | 只能為開發人員設定預付帳戶和後付帳戶。 |
Apigee X 不支援哪些 Apigee Edge 功能?
Google 不打算支援下列功能:
- Apigee Edge 擴充功能
- OpenAPI 規格儲存庫
- 用於搜尋或撤銷 OAuth 存取權杖的 API (因為權杖經過雜湊處理)
- OAuth v1 或 OAuthv1.0a 政策
- Trireme (EOL 發行日期:2019 年 10 月 10 日)
- Apigee X 不支援前置字串為「X-Apigee-」的標頭,因此會先從要求和回應中移除標頭,然後再傳送至目標和用戶端。
API 比較
一般來說,Apigee Edge API 大多都有 Apigee API 對等項目,本節提供:
- 與 Apigee X API 相比,所有 Apigee Edge API 的行為變更摘要
- Apigee Edge 和 Apigee X 指標 API 的差異
- 不支援的 Edge API 清單 (沒有 Apigee X API 對等項目)。
使用 API 的變更摘要
以下列出與 Apigee Edge API 相比,所有 Apigee X API 的行為變化。
行為 | Apigee Edge API | Apigee X API |
---|---|---|
基本網域 | api.enterprise.apigee.com |
apigee.googleapis.com |
媒體類型 | application/json application/xml |
application/json |
驗證 | OAuth2、SAML、基本 | OAuth2 |
索引鍵中的時間戳記 | int64 格式
|
String 格式
|
expand=false 查詢參數的結構 |
[ "helloworld", "weather" ] |
{ "proxies": [ { "name": "helloworld" }, { "name": "weather" } ] } |
查詢參數前面加上底線 | 支援 (_optimal=true ) |
不支援 (optimal=true ) |
酬載中的屬性:
|
有權限 | 無權限 |
酬載中的預設值 | 已納入 | 不包含 |
錯誤處理結構 | { "code": "...", "message": "..", "contexts": [] } |
{ "error": { "code": 409, "message": "...", "status": "ABORTED", "details": [...] } } |
快取刪除回應 | 傳回:200 OK 和快取詳細資料 |
傳回:204 No Content |
快取 API 作業 | List、 create、 get、 update、 Delete、 全部清除 及 [清除] 選項。 | 僅限 List 和 delete。部署 API Proxy 時,系統會自動建立短期 L1 快取。詳情請參閱「快取內部快取」。 |
Apigee Edge 和 Apigee X 指標 API 的差異
使用 API 的變更摘要列出 Apigee Edge API 和 Apigee X API 之間的一般差異。下表列出指標 API 的特定差異:
功能 | Apigee Edge API | Apigee X API |
---|---|---|
API 端點 | api.enterprise.apigee.com
|
apigee.googleapis.com
|
每日數據分析電子郵件 | 不支援任何 API | |
Async Query List API | 取得非同步分析查詢清單 | 回應中會省略 userId 屬性。請參閱
方法:organization.environments.queries.list。 |
自訂報表 API | Reports API | createdBy 和 lastModifiedBy 屬性已從回應中移除。請參閱 Reports API。 |
不支援的 Apigee Edge API
下表列出不支援的 Apigee Edge API (不具備 Apigee X API 同等項目)。
API 類別 | 不支援的 Apigee Edge API |
---|---|
API Monitoring | 不支援任何 API |
API Proxy |
|
稽核 | 使用 Stackdriver Logging API |
快取記錄檔 | 不支援任何 API |
公司 | 不支援任何 API |
公司應用程式 | 不支援任何 API |
公司應用程式系列 | 不支援任何 API |
公司應用程式金鑰 | 不支援任何 API |
偵錯工作階段 |
詳情請參閱與 Trace 的差異。 |
開發人員應用程式 | 取得 API 資源數量 |
開發人員應用程式系列 | 不支援任何 API |
擴充功能 | 不支援任何 API |
KeyStore:Truststore | 測試 KeyStore 或 Truststore |
LDAP | 不支援任何 API |
營利 | 不支援任何 API |
OAuth 第 2 版 | 不支援任何 API |
政策 | 不支援任何 API |
資源檔案 |
|
Sense | 不支援任何 API |
使用者和使用者角色 | 按照使用 API 管理使用者、角色和權限一文中的說明,使用 Google Identity and Access Management (IAM) 相關 API |
虛擬主機 | 不支援任何 API |
適用於私人雲端的 Apigee Edge 與 Apigee Hybrid
下表比較了適用於私有雲和 Apigee 混合的 Apigee Edge:
服務 | Apigee 產品或功能領域 | ||
---|---|---|---|
私有雲的 Apigee Edge | Apigee Hybrid | ||
數據分析 | Qpid 和 Postgres 伺服器 | 執行階段層中的資料收集 Pod 會使用 fluentd 和 UDCA (通用資料收集代理程式),收集資料並將資料提供給管理層中的 UAP (整合式數據分析平台)。 | |
API Proxy 閘道 | 訊息處理器 | 訊息處理器 (MP) 會處理傳入的要求。MP 是在執行階段層中以一或多個容器化應用程式的形式實作。 | |
永久性 | Cassandra 節點或環 | Cassandra 提供 KMS、KVM、配額和快取功能的持續性。 | |
部署作業 | ZooKeeper | Synchronizer 可確保 API Proxy 設定、環境資訊和其他資料在管理層和執行階段層之間保持最新狀態。 | |
管理使用者介面 | Apigee Edge UI 是由管理伺服器託管 | Apigee UI 託管於管理層。 | |
負載平衡 | 路由器 | Istio Ingress 控制器會將要求交給執行階段層中的 Message Processor (MP) 容器化應用程式。 | |
API | 管理伺服器 | 您可以透過管理伺服器和 MART 存取 Apigee X API。MART 會與本機 Cassandra 資料儲存庫互動,並做為 API 供應商,讓 Apigee X API 存取及管理執行階段資料實體。 | |
指標 | 設定 JMX 的所有元件 | 由每個叢集為各叢集的單一 Prometheus 伺服器管理,以提供所有服務。 |