4.16.09 - Edge for Private Cloud 版本資訊

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

我們已於 2016 年 9 月 19 日 (星期一) 發布新版 Apigee Edge for Private Cloud。

自上一個 Edge for Private Cloud 功能版本發布以來，已推出下列版本，並納入這個功能版本：

• 雲端：16.04.13 (UI)、16.04.13 (營利)、16.04.20 (UI)、16.04.27 (營利)、16.04.27 (UI)、16.05.04 (UI)、16.05.11 (UI)、16.05.11 (營利)、16.05.18 (UI)、16.05.25 (營利)、16.06.08 (營利)、16.06.15 (UI)、16.06.22 (營利)、16.06.29 (UI)、16.07.06 (營利)、16.07.06.02 (營利)、16.07.13 (UI)、16.07.20.01 (營利)、16.07.27 (UI)、16.08.17

請參閱「關於版本編號」，瞭解如何判斷特定雲端版本是否包含在 Edge for Private Cloud 版本中。

版本總覽

在這個版本中，我們移除了傳統 API Proxy 編輯器，並以新版 Proxy 編輯器取而代之。新版編輯器先前可與傳統編輯器並用。其他值得注意的強化功能包括：改善 API 產品資源路徑的行為、改善對「指派訊息」和「引發錯誤」政策中定義的 JSON 酬載處理方式、強化 XML 至 JSON 的轉換、改善資源驗證、能夠為個別 API Proxy 設定逾時、更新 API Proxy 精靈中的 SOAP Proxy 產生方式，以及適用於 JavaScript 的高效能 Crypto 物件。

貨幣化功能強化包括：提供通知費率方案的新通知功能、可將開發人員遷移至貨幣化的 API，以及將費率方案設為公開或私人的功能。

本主題的其餘部分將詳細說明這個版本中的所有新功能、更新和錯誤修正。

已淘汰

API 服務

移除傳統 Proxy 編輯器 (Cloud 16.04.20 UI)

新版 API Proxy 編輯器是目前唯一支援的版本。傳統版已無法使用，且「存取 Proxy 編輯器的傳統版」連結已移除。如果您使用舊版，系統會在新版編輯器中自動載入 API Proxy。(EDGEUI-498)

營利

下列已淘汰的功能已移除，系統不再提供支援：

• 設定限制
• 傳送限制通知

或者，您也可以按照下列各節的說明設定通知：

• 設定活動通知
• 為費率方案建立用量限制通知

(DEVRT-2742)

新功能與最新消息

這個版本的新功能和強化功能如下。除了下列強化功能外，這個版本也包含多項可用性、效能、安全性及穩定性強化功能。

如需更多詳細資料和操作說明，請參閱 Edge for Private Cloud 說明文件。

私有雲

將 PostgreSQL 升級至 9.4 版

本次發布包括升級至 Postgres 9.4。如需更新系統的操作說明，請參閱「將 Apigee Edge 更新至 4.16.09 版」。

Edge UI 支援 GeoMap

地理位置匯總功能可讓您根據地理屬性 (例如區域、洲別、國家/地區和城市) 收集 API 呼叫的 Analytics 資料。您可以從這項分析資料，在 Edge UI 中查看 GeoMap，瞭解 API 要求的來源位置。

詳情請參閱「啟用地理位置匯總和地理位置地圖」。

API BaaS

已新增下列主題的說明文件：

• 如何設定 API BaaS 使用 TLS。詳情請參閱「為 API BaaS 設定 TLS」。
• 如何設定所有 API BaaS Stack 節點使用共用儲存空間，讓所有資產都能供所有 API BaaS Stack 節點使用。詳情請參閱「上傳素材資源」。
• 如何在設定 BaaS Stack 節點時加密 Cassandra 密碼。詳情請參閱「重設 Edge 密碼」。

監控工具和資訊主頁的 Beta 版

這個版本包含 Edge 的新監控工具和資訊主頁 Beta 版。 這項工具可讓您瞭解各種元件 (路由器、訊息處理器、ZooKeeper、Cassandra) 的健康狀態，以及部署作業中各種機構和環境的 HTTP 錯誤代碼。您也可以擷取資訊主頁資料的快照，並與 Apigee 分享，協助解決支援事件。

說明文件 (包括安裝說明) 隨附於 4.16.09 版 Edge 文件，請參閱版本 4.18.01。

不過，您必須先完成 Apigee 評估協議 (也可在版本 4.18.01 中取得)，然後透過電子郵件傳送至 orders@apigee.com，才能安裝及使用資訊主頁。

分析收集器工具 Beta 版

所有 Edge for Private Cloud 客戶都必須向 Apigee 提交 API 代理伺服器流量統計資料。Apigee 建議客戶每天上傳一次這類資訊，或許可以建立 Cron 工作。

為協助上傳這項資料，Apigee 提供 apigee-analytics-collector 指令列公用程式的 Beta 版。這項公用程式會將 API 呼叫量報表傳回 Apigee。每個 Edge for Private Cloud 安裝作業都可以使用這項公用程式，向 Apigee 擷取及回報流量資料。

詳情請參閱「將 API 流量資料上傳至 Apigee - Beta 版」。

API 服務

指派訊息和引發錯誤中的 JSON 酬載 (Cloud 16.08.17)

這項強化功能可確保 JSON 訊息格式正確，且您可以使用大括號指定變數，不必再使用變通方法，也不會建立無效的 JSON。舉例來說，下列程式碼會在 JSON 訊息中插入 message.content 的值：

<Payload contentType="application/json">{"Message: " : "{message.content}"}</Payload>

如果您使用變通方法，程式碼會繼續照常運作。您也可以使用 variablePrefix 和 variableSuffix，而非大括號來表示變數。

請參閱「指派訊息政策」和「引發錯誤政策」參考文件中的「<Set><Payload>」元素。(APIRT-1160)

XML 轉 JSON 政策強化功能 (Cloud 16.08.17)

XML 到 JSON 政策已強化，具備下列功能。您可以設定政策，以便：

• 在轉換期間，將部分 XML 元素視為陣列，這會將值放在 JSON 文件中的方括號「[ ]」內。
• 在最終的 JSON 文件中，剝除或消除 XML 文件階層的層級。

詳情請參閱「XML 轉 JSON 政策」。(APIRT-1144)

API 產品資源路徑中的多個萬用字元 (Cloud 16.08.17)

在 API 產品中定義資源路徑時，您可以在資源路徑的多個位置加入萬用字元。舉例來說，/team/*/invoices/** 允許在 /team 後方使用任何值發出 API 呼叫，並在 invoices/ 後方使用任何資源路徑。API 呼叫中允許的 URI 為 proxyBasePath/team/finance/invoices/company/a。

如果發布這個版本後，現有的 API 產品資源路徑停止正常運作，請在機構上設定下列屬性，還原先前的行為：features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript 中的加密函式 (Cloud 16.08.17)

我們提供一組全新的高效能 JavaScript crypto 函式，可建立、取得及更新下列雜湊物件：MD5、SHA-1、SHA256、SHA512。crypto 物件也支援以各種格式取得日期。詳情請參閱 JavaScript 物件模型。 (APIRT-2886)

檢查 Java Callout JAR 版本 (Cloud 16.08.17)

將 Java JAR 資源上傳至 API Proxy 時，如果 Java 資源版本與 Edge 支援的 Java 版本不相容 (如「支援的軟體和支援的版本」一文所述)，系統會傳回 HTTP 400 狀態碼 (而非 500)。(MGMT-3420)

API Proxy 資源驗證 (Cloud 16.08.17)

如果 API 代理資源檔案 (例如 JavaScript 或 Java JAR) 儲存在環境或機構範圍，驗證架構就不會要求您在代理組合中納入這些資源，以便匯入並通過驗證。資源驗證現在會在部署時進行，而非匯入時。(MGMT-1430)

設定個別 API Proxy 的逾時時間 (Cloud 16.08.17)

您可以設定 API Proxy 在指定時間後逾時 (狀態為 504 閘道逾時)。主要適用於執行時間較長的 API Proxy，這類 API Proxy 通常是 Private Cloud 客戶所使用。舉例來說，假設您需要特定 Proxy 在 3 分鐘後逾時，您可以在 API Proxy 的設定中使用新的 api.timeout 屬性。以下是 3 分鐘的範例：

1. 首先，請務必將負載平衡器、路由器和訊息處理器設定為在 3 分鐘後逾時。
2. 然後將相關 Proxy 設定為在 3 分鐘後逾時。指定值時需以毫秒為單位。例如：

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. 不過請注意，提高系統逾時可能會導致效能問題，因為所有沒有 api.timeout 設定的 Proxy 都會使用新的較高負載平衡器、路由器和訊息處理器逾時。因此，請將不需要較長逾時時間的其他 API Proxy 設定為使用較短的逾時時間。舉例來說，下列程式碼會將 API Proxy 設為在 1 分鐘後逾時：
   <Property name="api.timeout">60000</Property>

如果 Cloud 客戶無法修改 Edge 超時，只要超時時間短於標準 Edge 訊息處理器超時時間 (57 秒)，也可以設定 API Proxy 超時。

您無法使用變數填入值。這個屬性已收錄在端點屬性參考資料中。(APIRT-1778)

使用 Proxy 精靈時的 SOAP Proxy 行為 (Cloud 16.07.27 UI)

使用 Proxy 精靈從 WSDL 建立 SOAP 型 Proxy 時，有兩種 Proxy 建立選項：

• 直通 SOAP：Proxy 只會直接傳送 SOAP 要求酬載。
• REST 到 SOAP 再到 REST：Proxy 會將傳入的酬載 (例如 JSON) 轉換為 SOAP 酬載，然後將 SOAP 回應轉換回呼叫端預期的格式。

這個版本更新了這些選項的運作方式。新舊行為的差異在於 Proxy 精靈自動產生的政策和設定。

Pass-Through SOAP

• 所有 WSDL 作業現在都會傳送至 Proxy 基礎路徑「/」，而非 Proxy 資源 (例如「/cityforecastbyzip」)。作業名稱會傳遞至目標 SOAP 服務。這項行為符合 SOAP 規格。

• 產生的 Proxy 不再支援要求中的 JSON。僅支援 XML。Proxy 可確保 SOAP 要求具有封包、主體和命名空間。

REST 至 SOAP 至 REST

• 不支援 WSDL 2.0。
• 新行為尚未透過 WS-Policy 測試。
• 透過 Proxy，您可以 POST JSON 資料，而非 FormParams。
• 使用 Proxy 建立工具在 Proxy 中新增 CORS (跨源資源共享) 支援時，您會看到下列強化功能：
  • Access-Control-Allow-Headers 標頭：除了 Origin、x-requested-with 和 Accept 標頭，Access-Control-Allow-Headers 標頭也包含 Content-Type、Accept-Encoding、Accept-Language、Host、Pragma、Referrer、User-Agent 和 Cache-Control。
  • Access-Control-Allow-Methods 標頭：除了 GET、PUT、POST、DELETE 之外，這個標頭也包含 PATCH 和 OPTIONS 動詞。
• 為 WSDL 產生 API Proxy 時，Edge 會讀取 WSDL 中定義為抽象的任何 ComplexTypes，並正確識別以抽象型別為基礎的任何執行個體型別。

wsdl2apigee 開放原始碼指令列公用程式

Apigee 也提供開放原始碼指令列公用程式，可從 WSDL 產生直通或 REST-to-SOAP API Proxy。請參閱 https://github.com/apigee/wsdl2apigee。

(EDGEUI-614)

鍵/值對應作業政策中的預設到期/重新整理時間 (Cloud 16.06.15 UI)

您可以透過「鍵/值對應作業」政策，決定值在重新整理前保留的時間長度。重新整理間隔是使用 <ExpiryTimeInSecs> 元素設定。如果執行 GET 作業時超過到期間隔，系統會重新整理值，政策也會取得更新後的值。將這項政策新增至 API Proxy 時，預設到期時間為 300 秒。(先前的預設值為 -1，表示值永遠不會重新整理)。(EDGEUI-579)

營利

可調整的通知費率方案 (Cloud 16.04.20 UI、Cloud 16.04.13 營利)

Edge 營利功能提供新的可調整通知費率方案，API 供應商可藉此為每位應用程式開發人員調整目標交易次數。您可以設定在達到目標數量的特定百分比時 (例如 90%、100% 或 150%)，是否要傳送通知。除了管理 API (先前版本已提供) 之外，您也可以透過管理 UI 使用這項功能。詳情請參閱「指定可調整的通知方案詳細資料」。(DEVRT-2375、DEVRT-2370)

可調整通知費率方案的 Webhook 通知 (Cloud 16.04.27 營利)

如果是可調整通知費率方案，你可以建立將通知傳送至指定網址的 Webhook。您也可以控管通知的間隔 (百分比)，直到達到交易限額為止。Webhook 通知可做為現有通知範本的彈性替代方案。請參閱使用 Webhook 設定通知。(DEVRT-2393、DEVRT-2394)

可調整通知的自訂屬性費率方案 (Cloud 16.05.18 UI)

在 Edge 營利中，新的「可調整的自訂屬性通知」費率方案可讓您使用自訂屬性的值，將開發人員的交易計數加總。如果採用標準的「可調整通知率」方案，每成功呼叫一次 API，開發人員的交易次數就會增加 1 次。不過，如果使用「可調整通知和自訂屬性」費率方案，自訂屬性的值會加到開發人員的交易次數中。舉例來說，如果自訂屬性「small」在回應中的值為 0.1，交易次數就會增加 0.1；如果自訂屬性「addressTotal」的值為 50，交易次數就會增加 50。詳情請參閱「使用自訂屬性詳細資料指定費率方案」。(DEVRT-2504)

根據公司及其開發人員的交易總額設定通知 (Cloud 16.06.22 營利)

一般來說，當開發人員使用公司應用程式存取 API 時，系統會自動追蹤公司所有開發人員的交易總額。如果開發人員正使用自己的開發人員應用程式存取 API，而您需要追蹤他們的交易總額，且不希望流量中斷，該怎麼做？您可以將開發人員新增至公司，並設定通知，在公司和開發人員的交易總額達到門檻時傳送通知。詳情請參閱「根據公司及其開發人員的交易總額設定通知」。(DEVRT-2643)

查看及重新處理通知 (Cloud 16.06.08 營利)

在營利測試套件中，您可以查看及重新處理先前使用管理 API 傳送的通知。詳情請參閱「查看及重新處理通知」。(DEVRT-2643)

測試營利 (Cloud 16.05.25 營利)

Monetization 提供一組 API，可用於測試執行 Webhook，確保系統會傳送通知。詳情請參閱「測試通知設定」。 (DEVRT-2625)

將開發人員遷移至營利功能 (Cloud 16.05.11 營利)

我們提供新的 API，協助開發人員遷移至營利功能。您可以轉移交易用量，並收取自訂設定和定期費用。此外，接受已發布的費率方案時，如果已收取設定費用，可以申請免除。詳情請參閱「將開發人員遷移至營利功能」。(DEVRT-2446)

開發人員入口網站的公開和私人費率方案 (Cloud 16.04.27 營利)

你可以將費率方案設為「公開」或「私人」。公開費率方案會顯示在開發人員入口網站，私密費率方案則不會。費率方案預設為公開。詳情請參閱 http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans。(DEVRT-2445)

解除開發人員停權 (Cloud 16.06.08 營利)

透過營利 API，您可以取消先前遭停權的開發人員帳戶。如果達到設定的限制，開發人員可能會遭到停權。例如，交易次數已達上限，或是預付帳戶餘額不足。詳情請參閱「解除開發人員停權處分」。(DEVRT-2641)

查看交易狀態 (Cloud 16.06.08 營利)

在營利測試套件中，您可以使用管理 API 查看指定時間範圍內發生的交易狀態。詳情請參閱「查看交易狀態」。(DEVRT-2640)

在收益報表中加入開發人員自訂屬性 (Cloud 16.05.25 營利)

只有在收益報表中，您才能納入為開發人員定義的自訂屬性。詳情請參閱「使用 API 在收益報表中加入開發人員自訂屬性」。(DEVRT-2447)

交易記錄政策和 API 產品資源一致性 (Cloud 16.05.18 UI)

如果營利交易記錄政策中的資源路徑與 API 產品中定義的資源路徑不符 (例如變更 API 產品資源路徑)，「產品」頁面上的交易記錄政策圖示會顯示警告符號。點按圖示查看交易記錄政策時，頁面頂端會顯示警告訊息。修正交易記錄政策中的資源路徑後，警告指標就會消失。(DEVRT-2240)

修正錯誤

這個版本修正了下列錯誤。這份清單主要供使用者查看支援單是否已解決。這項功能並非為所有使用者提供詳細資訊。

Edge for Private Cloud

16.08.17

16.07.27 (UI)

16.07.20.01 (營利)

這個版本包含小幅資料庫結構定義異動，沒有其他軟體更新。

16.07.13 (UI)

16.07.06.02 (營利)

16.07.06 (營利)

16.06.29 (UI)

16.06.22 (營利)

無

16.06.15 (UI)

16.06.08 (營利)

無

16.05.25 (營利)

16.05.18 (UI)

16.05.11 (營利)

16.05.11 (UI)

16.05.04 (UI)

16.04.27 (UI)

16.04.27 (營利)

無

16.04.20 (UI)

16.04.13 (營利)

無

16.04.13 (UI)

已知問題

這個版本有下列已知問題：