16.08.17 - Apigee Edge 公有雲版本資訊

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

2016 年 8 月 30 日星期二，我們發布了適用於公有雲的新版 Apigee Edge。

新功能與最新資訊

以下是這個版本的新功能和更新內容。

指派中的 JSON 酬載 傳達訊息並提報錯誤

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

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

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

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

強化 XML 到 JSON 政策

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

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

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

多種萬用字元位於 API 產品資源路徑

在 API 產品中定義資源路徑時，您可以在 資源路徑舉例來說，/team/*/invoices/** 允許 API 呼叫中含有任何 /team之後一個值以及任何資源路徑 在 invoices/ 之後。API 呼叫中允許的 URI 將 為 proxyBasePath/team/finance/invoices/company/a。

如果在這個版本後現有 API 產品資源路徑停止運作，請 請貴機構將下列資源還原為先前 行為：features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript 中的加密函式

我們推出了一組新的高效能 JavaScript crypto 函式 來建立、取得和更新下列項目含有物件：MD5、SHA-1、SHA256、SHA512。 crypto 物件也可讓您取得 日期。詳情請參閱「JavaScript 物件模型」一文。 (APIRT-2886)

Java 摘要 JAR 版本 檢查中

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

API Proxy 資源驗證

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

設定逾時 個別 API Proxy 的存取權

您可以將 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 秒內請求驗證碼。

您無法使用變數填入值。這項資源包含在 端點屬性參考資料。(APIRT-1778)。

訊息記錄的 TLS/SSL 政策

<KeyStore>和<TrustStore>可在以下位置設定： 訊息記錄政策的 SSLInfo 設定， 允許單向和雙向 TLS/SSL 搭配記錄服務。比照在訊息記錄政策中設定 SSLInfo 的方式， 會在 Proxy 上 TargetEndpoint，不過，訊息記錄 TLS/SSL 僅支援 TCP 通訊協定。 (APIRT-1858)。

修正錯誤

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