共用方式為

Azure APIM v2 層

  • 發行項

適用於：基本 v2 |標準 v2 |進階 v2

API 管理 v2 層 （SKU） 建置在新的、更可靠且可調整的平臺上，其設計目的是讓更廣泛的客戶能夠存取 API 管理，併為更廣泛的案例提供彈性選項。 除了現有傳統層 (開發人員、基本、標準和進階) 和取用層之外，還有 v2 層。 請參閱 API 管理 層的詳細比較。

下列 v2 層已正式推出：

  • 基本 v2 - 基本 v2 層是針對開發和測試情節所設計，而且使用 SLA 予以支援。

  • 標準 v2 - 標準 v2 是生產就緒層，可支援網路隔離後端。

下列 v2 層處於預覽狀態：

  • 進階 v2 - 進階 v2 提供企業功能，包括完整的虛擬網路隔離，以及針對大量工作負載進行調整。

    注意

    進階 v2 層目前處於有限預覽狀態。 若要註冊，請填寫 此窗體。

主要功能

  • 更快速的部署、設定和調整 - 在幾分鐘內部署生產就緒 APIM 執行個體。 快速套用憑證和主機名稱更新這類設定。 將基本 v2 或標準 v2 執行個體快速調整為最多 10 個單位，以符合 APIM 工作負載的需求。 將 Premium v2 實例調整為最多 30 個單位。

  • 簡化的網路 - 標準 v2 和進階 v2 層提供網路選項，以隔離 API 管理 的輸入和輸出流量。

  • 生產工作負載的其他選項 - v2 層都支援 SLA。

  • 開發人員入口網站選項 - 準備好讓 API 取用者探索您的 API 時，請啟用開發人員入口網站。

功能

API 版本

API 管理 API 2024-05-01 版或更新版本支援 v2 層的最新功能。

網路功能選項

  • 標準 v2 和進階 v2 支援虛擬網路整合，讓您的 API 管理 實例能夠連線到在單一聯機虛擬網路中隔離的 API 後端。 還是可以從網際網路公開存取 APIM 閘道、管理平面和開發人員入口網站。 虛擬網路必須與 API 管理 實例位於相同的區域和訂用帳戶中。 深入了解。

  • 進階 v2 也支援簡化的 虛擬網路插入 ，以完全隔離輸入和輸出閘道流量，而不需要網路安全組規則、路由表或服務端點。 虛擬網路必須與 API 管理 實例位於相同的區域和訂用帳戶中。 深入了解。

支援的區域

如需目前可用的 v2 層區域清單，請參閱 v2 層和工作區閘道的可用性。

傳統功能可用性

v2 層支援傳統 API 管理層的大部分功能。 但是，v2 層不支援以下功能：

  • 使用 Git 的API 管理服務設定
  • API管理執行個體的備份和恢復
  • 啟用 Azure DDoS 保護
  • 直接管理 API 存取

限制

v2 層目前無法使用下列 API 管理功能。

基礎結構和網路

  • 多區域部署 (部分機器翻譯)
  • 多重自訂網域名稱
  • 容量計量 - 由閘道的 CPU 百分比和閘道計量的記憶體百分比所取代
  • 內建分析 - 由 Azure 監視器型儀錶板取代
  • 自動調整規模
  • 使用私人端點的輸入連線
  • 從傳統層升級至 v2 層
  • CA 憑證

開發人員入口網站

  • 報表
  • 自訂 HTML 程式碼小工具與自訂小工具
  • 自我裝載的開發人員入口網站

閘道

  • 自我裝載閘道
  • 依金鑰原則的配額
  • 加密設定
  • 用戶端憑證重新交涉
  • 免費、受控的 TLS 憑證
  • 透過 localhost 對閘道的要求

資源限制

下列資源限制適用於 v2 層。

若要要求增加限制，請從 Azure 入口網站建立支援要求。 如需詳細資訊，請參閱 Azure 支援方案。

資源 基本 v2 標準 v2 進階 v2
縮放單位數上限 10 10 30
每個服務執行個體的快取大小上限 250 MB 1 GB 5 GB
每個服務執行個體的 API 數目上限 150 500 2,500
每個服務執行個體的 API 作業數目上限 3,000 10,000 20,000
每個服務執行個體的訂用帳戶數目上限 500 2,000 4,000
每個服務執行個體的產品數目上限 50 200 400
每個服務執行個體的使用者數目上限 300 2,000 4,000
每個服務執行個體的群組數目上限 20 100 200
每個服務執行個體的授權伺服器數目上限 10 500 500
每個服務執行個體的原則片段數目上限 50 50 100
每個服務執行個體的 OpenID Connect 提供者數目上限 10 10 20
每個服務執行個體的憑證數目上限 100 100 100
每個服務執行個體的後端數目上限 100 100 100
每個服務執行個體的快取數目上限 100 100 100
每個服務執行個體的具名值數目上限 100 100 100
每個服務執行個體的記錄器數目上限 100 100 100
每個服務執行個體的結構描述數目上限 100 100 100
每個 API 的結構描述數目上限 100 100 100
每個服務執行個體的標籤數目上限 100 100 100
每個 API 的標籤數目上限 100 100 100
每個服務執行個體的版本集合數目上限 100 100 100
每個 API 版本數目上限 100 100 100
每個 API 的作業數目上限 100 100 100
每個服務執行個體的 GraphQL 解析程式數目上限 100 100 100
每個 API 的 GraphQL 解析程式數目上限 100 100 100
每個產品的 API 數目上限 100 100 100
每個訂用帳戶的 API 數目上限 100 100 100
每個訂用帳戶的產品數目上限 100 100 100
每個產品的群組數目上限 100 100 100
每個產品的標籤數目上限 100 100 100
每個 HTTP 授權單位的並行後端連線數目1 2,048 2,048 2,048
最大快取回應大小 2 MiB 2 MiB 2 MiB
原則文件大小上限 256 KiB 256 KiB 256 KiB
要求承載大小上限 1 GiB 1 GiB 1 GiB
緩衝承載大小上限 2 MiB 2 MiB 2 MiB
診斷記錄中的要求/回應承載大小上限 8,192 個位元組 8,192 個位元組 8,192 個位元組
要求 URL 大小上限2 16,384 個位元組 16,384 個位元組 16,384 個位元組
URL 路徑區段的最大長度 1,024 個字元 1,024 個字元 1,024 個字元
具名值的字元長度上限 4,096 個字元 4,096 個字元 4,096 個字元
驗證內容原則中要求或回應主體的大小上限 100 KiB 100 KiB 100 KiB
驗證原則所使用的 API 結構描述大小上限 4 MB 4 MB 4 MB
每個單位的作用中 WebSocket 連線數目上限3 5,000 5,000 5,000

1 除非後端明確關閉連線，否則連線會經過集區化和重複使用。
2 包含最多 2048 個位元組長的查詢字串。
3 每個服務執行個體最多有 60,000 個連線。

開發人員入口網站限制

下列限制適用於 v2 層中的開發人員入口網站。

項目 基本 v2 標準 v2 進階 v2
要上傳的媒體檔案數目上限 15 15 15
媒體檔案的大小上限 500 KB 500 KB 500 KB
分頁數目上限 30 50 50
小工具數目上限1 30 50 50
每個分頁的中繼資料大小上限 350 KB 350 KB 350 KB
每個小工具的中繼資料大小上限1 350 KB 350 KB 350 KB
每分鐘用戶端要求數目上限 200 200 200

1 內建小工具的限制，例如文字、影像或 API 清單。 目前 v2 層不支援自訂小工具和自訂 HTML 程式碼小工具。

部署

使用 Azure 入口網站 或使用 Azure REST API、Azure Resource Manager、Bicep 範本或 Terraform 等工具來部署 v2 層實例。

常見問題集

問：是否可以從現有的 APIM 執行個體移轉至新的 v2 層執行個體？

A: 不可以。 您目前無法將現有的 APIM 執行個體 (在取用、開發人員、基本、標準或進階層中) 移轉至新的 v2 層執行個體。 v2 層目前僅適用於新建立的服務執行個體。

問：stv2 計算平台與 v2 層之間的關聯性有何？

答：無關。 stv2 是開發人員、基本、標準和進階層服務執行個體的計算平台版本。 stv2 是 stv1 計算平臺 的繼任者，於 2024 年淘汰。

問：我仍然可以布建開發人員、基本、標準或進階層服務嗎？

答：是，傳統開發人員、基本、標準或進階層沒有任何變更。

問：標準 v2 層中的虛擬網路整合和進階 v2 層中的虛擬網路插入有何差異？

答：標準 v2 服務實例可以與虛擬網路整合，以提供對位於該處後端的安全存取。 與虛擬網路整合的標準 v2 服務實例具有用於輸入存取的公用IP位址。

進階層和進階 v2 層藉由將部署 （插入） 部署至虛擬網路來支援完整的網路隔離，而不會公開公用IP位址。 深入瞭解 API 管理 中的網路選項。

問：我可以在虛擬網路中完全部署基本 v2 或標準 v2 層的實例嗎？

答：否，進階和進階 v2 層僅支援這類部署。

相關內容