16.08.17 - Apigee Edge 公有雲版本資訊

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

我們已於 2016 年 8 月 30 日 (星期二) 發布新版 Apigee Edge Public Cloud。

新功能與最新消息

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

指派訊息和引發錯誤中的 JSON 酬載

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

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

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

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

XML 轉 JSON 政策的強化功能

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

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

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

API 產品資源路徑中的多個萬用字元

在 API 產品中定義資源路徑時，您可以在資源路徑的多個位置加入萬用字元。舉例來說，/team/*/invoices/** 允許在 /team 後方使用任何值發出 API 呼叫，並在 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 時，如果 Java 資源版本與 Edge 支援的 Java 版本不相容 (如「支援的軟體和支援的版本」一文所述)，系統會傳回 HTTP 400 狀態碼 (而非 500)。(MGMT-3420)

驗證 API Proxy 資源

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

為個別 API Proxy 設定逾時

您可以設定 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)

訊息記錄的 TLS/SSL 政策

<KeyStore> 和 <TrustStore> 可在SSLInfo設定中設定，訊息記錄政策允許與記錄服務進行單向和雙向 TLS/SSL。您可以在訊息記錄政策中設定 SSLInfo，方式與在 Proxy TargetEndpoint 中設定相同。不過，訊息記錄 TLS/SSL 僅支援 TCP 通訊協定。 (APIRT-1858)

修正錯誤

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