Apigee Edge 與 Apigee X 之間的差異

您正在查看 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
  • 非同步部署
  • 系統會依據執行階段層「簽收」管理層的最後時間擷取部署狀態
環境
  • 支援環境群組
  • 透過 Apigee UI 和 API 自助服務
  • 提供拓撲的彈性
  • MP Pod 只能放送一個環境

詳情請參閱「關於環境和環境群組」。

代管目標

請使用 Cloud RunCloud Functions

HTTP/1.1 標頭欄位名稱處理 轉送至後端時,將 HTTP/1.1 標頭欄位名稱轉換為小寫。在 Apigee Edge 中,系統會保留標頭欄位名稱大小寫。
可透過 IAM 角色精細控管角色型存取權

已排程

使用 [@.length-x] 的 JSONPath

Apigee X 不支援在 JSONPath 運算式中使用 [@.length-x]。 JSONPath 規格指出運算式視基礎指令碼語言而定。length-x 是 JavaScript 建構,不是 Java,[@.length-x] 並未實作為規格的一部分。在 Apigee X 中,運算式 [@.length-x] 已由索引配置 ([-x]) 取代。

在這個例子中:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

輸入內容:$.books[@.length-1] 會在 Apigee Edge 中傳回 {“name”: “B”},並在 Apigee X 中傳回 [{“name”: “B”}]

KeyStore/Truststore

以 Kubernetes 密鑰的形式從北行代管

KVM
  • 您可以在 Apigee UI 中建立加密且以環境為範圍的 KVM。KVM 一律會經過加密處理。您無法在 UI 中新增、更新或查看 KVM 項目。
  • 透過 GET 指令存取 KVM 時,如要在偵錯 (Trace) 工作階段中隱藏 KVM 資訊,請使用 private. 屬性搭配所有變數。如未使用 private. 屬性,KVM 仍會經過加密,但 KVM 資訊會顯示在偵錯 Trace 工作階段中,且不會擲回例外狀況。
  • 您可以使用 keyvaluemaps.entries API KeyValueMapOperations 政策管理 KVM 項目。
  • 屬性集可用於 KVM 的部分相同用途。請參閱「使用屬性集」一文。
  • <MapName> 元素可啟用 KeyValueMapOperations 政策,找出要在執行階段動態使用哪一個 KVM。

若要進一步瞭解如何在 UI 中建立 KVM,請參閱使用鍵/值對應。如要瞭解如何選擇合適的資料持續性機制,另請參閱「存取設定資料」一文。

Microgateway 建議您改用 Apigee Adapter for Envoy
營利 請參閱「 與營利的差異」一節
Node.js
  • 不支援 Node.js API Proxy。
  • Apigee 建議您將 Node.js 應用程式託管為 Kubernetes (相同或不同叢集) 中的個別容器
北行 mTLS 已排程
OAuth 新增 RevokeOAuthv2 政策後,使用者 ID 和/或應用程式 ID 就會撤銷政策。這項政策會取代 Apigee Edge API,以撤銷 OAuth2 權杖。
政策
reasonPhrase 不支援。
資源 無法使用機構層級資源
角色和權限
  • 透過 Google Cloud 控制台的 IAM 服務管理
  • 系統提供幾個現成的精選角色
  • 您可以建立自訂角色,並加入其他 Google Cloud 權限。

詳情請參閱「 使用者和角色」。

Sense 使用進階 API 安全性功能。
「建構 Proxy」精靈中的 SOAP 服務 不支援。請參閱 wsdl2apigee,此專案可提供 SOAP 公用程式,以便搭配 Apigee 使用。
追蹤記錄/偵錯工作階段 請參閱「與 Trace 的差異」一節。
虛擬主機

適用於 Apigee Hybrid:

  • Ingress 會透過 Anthos 服務網格實作。
  • 金鑰和憑證會直接部署至 Kubernetes。

如為 Apigee X:

  • 每個執行個體都會透過自行簽署的憑證公開 HTTPS 端點。您可以查詢機構來下載憑證的 CA。

與 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 對等項目,本節提供:

使用 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 格式
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
String 格式
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
expand=false 查詢參數的結構
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
查詢參數前面加上底線 支援 (_optimal=true) 不支援 (optimal=true)
酬載中的屬性:
  • created_by
  • modified_by
  • self
有權限 無權限
酬載中的預設值 已納入 不包含
錯誤處理結構
{
        "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 createdBylastModifiedBy 屬性已從回應中移除。請參閱 Reports API

不支援的 Apigee Edge API

下表列出不支援的 Apigee Edge API (不具備 Apigee X API 同等項目)。

API 類別 不支援的 Apigee Edge API
API Monitoring 不支援任何 API
API Proxy
  • 強制取消部署 API Proxy
  • 取得 npm 依附元件
  • 管理 npm 模組
稽核 使用 Stackdriver Logging API
快取記錄檔 不支援任何 API
公司 不支援任何 API
公司應用程式 不支援任何 API
公司應用程式系列 不支援任何 API
公司應用程式金鑰 不支援任何 API
偵錯工作階段
  • 無法停止追蹤工作階段
  • 無法刪除個別交易

詳情請參閱與 Trace 的差異

開發人員應用程式 取得 API 資源數量
開發人員應用程式系列 不支援任何 API
擴充功能 不支援任何 API
KeyStore:Truststore 測試 KeyStore 或 Truststore
LDAP 不支援任何 API
營利 不支援任何 API
OAuth 第 2 版 不支援任何 API
政策 不支援任何 API
資源檔案
  • API Proxy 修訂版本範圍
  • 機構範圍
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 會使用 fluentdUDCA (通用資料收集代理程式),收集資料並將資料提供給管理層中的 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 伺服器管理,以提供所有服務。