4.16.09 - Edge for Private Cloud 版本資訊

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

我們在 2016 年 9 月 19 日星期一發布了新版 Apigee Edge for Private Cloud。

自舊版 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 酬載的處理方式 改善資源驗證功能，可以在個別 API Proxy 上設定逾時，已更新 API Proxy 精靈中產生 SOAP Proxy，並為 JavaScript。

營利強化功能包括新的通知功能，以及通知費率方案、 將開發人員遷移至營利的 API，以及公開費率方案或 私人。

本主題的其餘部分包含所有新功能、更新和錯誤修正的詳細資訊 特定授權。

已淘汰

API 服務

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

我們現在支援新版的 API Proxy 編輯器。傳統版 「存取傳統版 Proxy 編輯器」連結已經 已移除如果您使用的是傳統版，系統會在以下時間點自動載入您的 API Proxy： 新的編輯器(EDGEUI-498)

營利

以下已淘汰的功能已經移除，不再提供支援：

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

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

• 設定事件 通知
• 建立 費率方案的限制通知

(DEVRT-2742)

新功能與最新資訊

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

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

私有雲

Postres 升級至 9.4 版

此版本包含升級至 Postgres 9.4 的版本。如需更新系統的操作說明， 請參閱將 Apigee Edge 更新為 4.16.09.

Edge UI 中的地理區域地圖支援

地理區域匯總功能可讓您依據地理位置收集 API 呼叫的數據分析資料 例如區域、洲別、國家/地區和城市您可以透過這些分析資料 Edge UI 中的地理區域圖，顯示 API 要求的位置。

詳情請參閱啟用地理區域匯總和 地理區域地圖。

API BaaS

新增以下主題的說明文件：

• 如何設定 API BaaS 使用傳輸層安全標準 (TLS)。詳情請參閱為 API BaaS 設定 TLS。
• 如何將所有 API BaaS 堆疊節點設為使用共用儲存空間，以便將所有資產 適用於所有 API BaaS 堆疊節點。詳情請參閱上傳資產。
• 如何在設定 BaaS Stack 節點時加密 Cassandra 密碼。如要 詳情請參閱重設邊緣 密碼：

監控工具和資訊主頁 Beta 版

這個版本是 Edge 新監控工具和資訊主頁的 Beta 版。 這項工具可協助您瞭解各種元件 (路由器、訊息處理器、 ZooKeeper、Cassandra)，以及帳戶中各種機構和環境適用的 http 錯誤代碼 可能面臨擴充性、監控、持續整合 和部署等方面的挑戰您也可以擷取資訊主頁資料的快照，並與 Apigee 分享這些資料， 解決支援事件的問題

Edge 4.16.09 文件內含說明文件 (包括安裝指示) 版本 4.18.01。

不過，您必須先完成 Apigee 評估，才能安裝及使用資訊主頁 該協議亦載於 4.18.01 版，並在下列日期前將其交回 Apigee 並透過電子郵件傳送至 orders@apigee.com。

數據分析收集工具工具 Beta 版

所有 Edge for Private Cloud 客戶都必須向 Apigee 提交 API 相關統計資料 以及 Proxy 流量Apigee 建議客戶每天上傳該資訊一次， 建立 Cron 工作。

為協助您上傳這類資料，Apigee 提供 apigee-analytics-collector 指令列 Beta 版 公用程式這個公用程式會將 API 呼叫量報表傳回 Apigee。各種邊緣 私有雲安裝作業可以使用這個公用程式擷取流量資料，並回報給 Apigee。

詳情請參閱 Uploading API 傳送至 Apigee - Beta 版的流量資料。

API 服務

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

透過這項強化功能，您不需要替代方案來確保 JSON 訊息格式正確。 您可以使用大括號指定變數，而不建立無效的 JSON。舉例來說， 下列指令會在 JSON 訊息中插入 message.content 的值：

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

選擇變通方法後，您的程式碼會繼續照常運作。您也可以使用 varPrefix 和 variableSuffix 表示變數，而非大括號。

請參閱<Set><Payload>「指派訊息」政策的部分元素與 提報錯誤政策 參考文件(APIRT-1160)。

從 XML 到 JSON 政策強化項目 (Cloud 16.08.17)

系統已強化 XML 到 JSON 政策，並具備下列功能。您可以設定 政策的用途：

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

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

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

在 API 產品中定義資源路徑時，您可以在 資源路徑舉例來說，/team/*/invoices/** 允許 API 呼叫中含有任何 /team之後一個值以及任何資源路徑 在 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 呼叫 JAR 版本檢查 (Cloud 16.08.17)

將 Java JAR 資源上傳至 API Proxy 時，系統會傳回 HTTP 400 狀態碼 (而非 500) 如果 Java 資源的版本與支援 Edge 不相容，則會傳回 500。 更新程式版本，列於支援的軟體和 支援的版本。(MGMT-3420)

API Proxy 資源驗證 (Cloud 16.08.17)

將 API Proxy 資源檔案 (例如 JavaScript 或 Java JAR) 儲存在 環境或機構範圍，使用驗證架構就不再需要 將位於 API Proxy 層級的這些資源納入 Proxy 組合中，以便匯入並通過驗證。 資源驗證現在會在部署時進行，而非匯入時。(MGMT-1430)

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

您可以將 API Proxy 設為在超過指定時間後逾時 (設為 504 閘道逾時) 狀態)。主要用途是為擁有 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>

無法修改 Edge 逾時的雲端客戶也能設定 API Proxy 逾時 只要逾時時間短於標準 Edge 訊息處理器逾時為 57 秒內請求驗證碼。

您無法使用變數填入值。這項屬性會在 Endpoint 屬性說明 參考資料。(APIRT-1778)。

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

使用 Proxy 精靈從 WSDL 建立 SOAP 型 Proxy 時， Proxy 建立作業：

• 傳遞 SOAP，其中 Proxy 會直接通過 SOAP 請求 酬載
• 從 REST 到 SOAP，Proxy 會轉換傳入的酬載，例如 將 JSON 轉換為 SOAP 酬載，然後將 SOAP 回應轉換回呼叫端格式 符合預期

這個版本包含下列更新，說明這些選項的運作方式。差別 新行為與新行為之間的關聯 產生的 YAML 設定檔

傳遞 SOAP

• 所有 WSDL 作業現在都會傳送至 Proxy 基本路徑「/」而非透過 Proxy 資源 (例如「/cityforecastbyzip」)。作業名稱會傳送到目標 SOAP 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務這個行為與 SOAP 規格相符。

• 產生的 Proxy 不再支援要求中的 JSON。僅支援 XML。Proxy 會確保 SOAP 請求具有信封、內文和命名空間。

從 REST 到 SOAP

• 不支援 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 中的抽象層，並正確辨識以抽象概念為基礎的任何執行個體類型 。

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

Apigee 也提供開放原始碼指令列公用程式 WSDL 的 REST 和 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%。這項功能除了 Management API 外，也可透過管理 UI 使用 (適用於先前的版本)。如需瞭解更多資訊，請參閱指定 可調整的通知方案詳細資料。(DEVRT-2375、DEVRT-2370)

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

針對可調整的通知率方案，您可以建立 Webhook 來傳送通知到 您指定的網址。也可以設定系統以特定時間間隔 (百分比) 發出通知 直到交易達到限額為止Webhook 通知能為您提供靈活的 除了使用現有的通知範本外，請參閱使用以下應用程式設定通知： Webhook。(DEVRT-2393、DEVRT-2394)

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

在邊緣營利中，系統會新增「具有自訂屬性的可調整通知」房價方案可讓你 使用自訂屬性的值，將 加入開發人員的交易計數中。符合標準的 可調整的通知費率方案，每次成功呼叫 API 都會增加開發人員交易 1 的值 數量。但透過含有自訂屬性費率方案的可調整通知， 自訂屬性就會加入開發人員的交易筆數中。舉例來說，如果自訂屬性 「小」回應中的值為 0.1，交易計數就會遞增 0.1；或 自訂屬性「addressTotal」的值為 50，則計數將遞增 50。如要 資訊，請參閱指定費率方案 例如自訂屬性詳細資料(DEVRT-2504)

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

系統通常會自動追蹤公司所有開發人員的交易總額， 但開發人員使用公司應用程式存取 API如果有開發人員積極投入心力，該怎麼辦？ 使用自家開發人員應用程式存取 API，而您需要追蹤開發人員的合併交易 在不影響任何流量的情況下，取出的總和？您可以將開發人員新增至公司並進行設定 達到閾值 (以合併交易為依據) 時傳送的通知 總算是該公司及其開發人員的總和詳情請參閱設定 根據公司及其開發人員的合併交易總額來傳送通知。 (DEVRT-2643)

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

透過營利測試套件，您可以先查看及重新處理通知 透過 Management API 傳送詳情請參閱檢視和 重新處理通知。(DEVRT-2643)

測試營利 (Cloud 16.05.25 營利)

營利服務提供一組 API，可用來測試 Webhook 的執行作業， 確保系統可正常傳送通知詳情請參閱「測試通知設定」。 (DEVRT-2625)

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

我們推出了新的 API，協助開發人員改用營利工具。你可以 轉移交易用量，並收取自訂設定與週期性費用。此外，如果 接受已發布的費率方案，即可免除設定費用，以免已支付費用。 詳情請參閱將開發人員遷移至 營利。(DEVRT-2446)

開發人員入口網站的公開與不公開費率方案 (Cloud 16.04.27 收益)

你可以將費率方案設為「公開」或「私人」開發人員會顯示公開費率方案 portal;不支援不公開費率方案。費率方案的預設值為「公開」。如需更多資訊 請參閱 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 營利服務)

透過營利測試套件，您可以查看具有狀態的交易狀態 發生狀態。如需更多資訊 請參閱查看 交易。(DEVRT-2640)

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

就收益報表而言，假設為自訂屬性，您能夠在報表中加入自訂屬性 屬性是針對開發人員定義而成。詳情請參閱包含開發人員自訂項目 屬性。(DEVRT-2447)

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

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

修正錯誤

這個版本修正了下列錯誤。這份清單主要適用對象 來解決他們的支援單問題它無法針對 所有使用者。

私有雲適用的 Edge

16.08.17

16.07.27 (使用者介面)

16.07.20.01 (營利)

這個版本包含次要的資料庫結構定義變更，這沒有其他軟體更新 版本。

16.07.13 (使用者介面)

16.07.06.02 (營利)

16.07.06 (營利)

16.06.29 (使用者介面)

16.06.22 (營利)

無

16.06.15 (使用者介面)

16.06.08 (營利)

無

16.05.25 (營利)

16.05.18 (使用者介面)

16.05.11 (營利)

16.05.11 (使用者介面)

16.05.04 (使用者介面)

16.04.27 (使用者介面)

16.04.27 (營利)

無

16.04.20 (使用者介面)

16.04.13 (營利)

無

16.04.13 (使用者介面)

已知問題

此版本有以下已知問題：