15.05.27 - Apigee Edge 雲端版本資訊

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

2015 年 6 月 2 日星期二,我們發布了全新雲端版本的 Apigee Edge。

如有任何問題,請前往 Apigee 客戶服務頁面。

如需所有 Apigee Edge 版本資訊的清單,請參閱 Apigee 版本資訊

新功能和強化項目

這個版本包含的新功能和強化項目。

SmartDocs 正式發布

SmartDocs 已從 Beta 版升級為正式發布。更新和新功能包括:

  • 支援 Swagger 2.0,包括依檔案或網址匯入,包括支援自訂命名的安全性物件。
  • 改善產生 SmartDocs 的範本的視覺設計。
  • 開發人員入口網站的可用性和工作流程強化功能 (位於 Drupal 的「內容」>「SmartDocs」) 選單中。
  • 「自訂權杖」驗證方式現在更名為「API 金鑰」。
  • 在修訂版本層級定義的「安全性」物件。
  • 在範本層級設定用戶端驗證。新的修訂版本不會再重設任何預先設定的 SmartDocs 用戶端憑證。

如要進一步瞭解功能說明,請參閱這篇 網誌文章

如需 SmartDocs 說明文件,請參閱「使用 SmartDocs 記錄 API」。

新增 API Proxy 編輯器 Beta 版

API Proxy 編輯器已推出新的 Beta 版。如要使用這項功能,請在編輯現有 API Proxy 時,按一下「存取 Beta 版」連結。您可以在「傳統版」和「Beta 版」編輯器之間切換。

新增 OAuthV2 政策

新的 DeleteOAuthV2Info 政策可讓您刪除授權碼和存取權杖。詳情請參閱「刪除 OAuthV2 資訊政策」。

存取實體政策中的新實體政策

存取實體政策提供以下新實體的存取權:consumerkey-scopes、Authorizationcode、requesttoken 和 verifier。詳情請參閱存取實體政策

目前顯示即將到期的 SSL 憑證

管理使用者介面中的「SSL 憑證」頁面 (依序點選「管理員」>「SSL 憑證」) 會顯示 SSL 憑證在 10、15、30 或 90 天內的到期時間,取決於您在新到期日下拉式選單中的選擇。

管理 UI 中顯示的開發人員應用程式名稱

Edge 中的開發人員應用程式都有不會變更的內部名稱,以及可變更的顯示名稱。在管理使用者介面 (「發布」>「開發人員應用程式」>「應用程式名稱」) 的「開發人員應用程式」頁面上,應用程式的內部「名稱」和「顯示名稱」會同時顯示,方便使用者根據內部名稱辨別應用程式,進行疑難排解及管理 API。

傳統版自訂報表即將從管理使用者介面中移除

管理 UI 中不再提供選用的傳統版自訂數據分析報表。


SmartDocs 升級程序

如果您在 Beta 版試用期間已使用過 SmartDocs,只有一般可用性版本的 SmartDocs。

先前發布到開發人員入口網站的 SmartDocs 頁面仍可繼續運作,但您必須先按照更新程序操作,才能編輯或發布現有或新頁面的任何變更。

請注意,雖然您可以在開發人員入口網站中轉譯及發布 SmartDocs,但 SmartDocs 是根據 Apigee Edge API 管理服務內的 API 模型產生。您在 Edge 中對 API 模型所做的任何變更,都會在所有 Pantheon 環境中保持一致 (與開發人員在 Pantheon 環境中的方式類似)。

從 SmartDocs Beta 版升級至正式發布版

  1. 在 Pantheon 的 devtest 環境中更新並測試 15.05.27 版本。
  2. 建立新模型,取代已使用的任何現有 API 模型。
    • 如果您已匯入 Swagger 或 WADL 文件,請將這些文件再次匯入新的修訂版本。
    • 如果您一直透過 SmartDocs 模組維護 API 模型,請以 SmartDocs JSON 格式匯出,並使用檔案附件匯入新模型。
  3. 設定模型修訂版本的安全性屬性。在「內容」>「SmartDocs」>「模型」頁面上選取「安全性設定」
  4. 按一下「作業」資料欄中的「設定」,在模型設定頁面 (依序點選「Content」>「SmartDocs」) 中檢查任何預先設定的驗證。
  5. 更新所有自訂範本,使其使用 CSS 和 JS 資產第 6 版,並進行變更,反映任何新的物件名稱,例如 authSchemes 和 apiSchema。如要瞭解如何更新 SmartDocs 範本,請參閱使用 SmartDocs 的文件 API
  6. 重新轉譯並發布模型修訂版本。
  7. 驗證新說明文件後,請將 Production 入口網站更新至 15.05.27 版本。

如果您是 Edge 企業客戶,且對升級程序有問題或疑慮,請傳送電子郵件至 marsh@apigee.com 和 cnovak@apigee.com。否則,請使用 Apigee 社群獲得最好的回應。

修正錯誤

本次更新修正了下列錯誤。

問題 ID 說明
TBD-72 訊息記錄政策問題
MGMT-2124 系統會在 UI 中儲存權限時重設客戶角色權限
MGMT-2048 具備自訂角色的使用者只能部署某個環境的部署權限,可以在其他環境中部署
MGMT-2041 移除預設附件範本中的 FaultRules 元素
建立 API Proxy 或新增政策時,系統不會再自動新增未在政策或 API Proxy 步驟中使用的 FaultRules 元素。
MGMT-2034 擷取 WSDL 傳回失敗:「擷取 WSDL 錯誤:處理 WSDL 時發生錯誤。」
MGMT-1812 在匯入期間新增 TargetEndpoint 驗證
與 ProxyEndpoint 類似,系統會驗證 TargetEndpoint,在 API Proxy 匯入期間針對條件中使用的適當結構定義和運算式。
MGMT-1345 匯入含有多個命名空間的 WSDL 會導致建構 SOAP 步驟不正確
MGMT-800 建立名稱為「default」的資源會導致 UI 毀損
MGMT-602 API Proxy 開發檢視畫面:在端點沒有 PreFlow/PostFlow 導致錯誤時新增回應快取政策
MGMT-460 重新命名政策會導致行為異常和重複政策,但無法移除
DEVRT-1565 CHARGES 間隔 15 分鐘
AXAPP-1728 忽略數據分析中的營利變數
AXAPP-1690 自訂報表中的「API 錯誤無效」
AXAPP-1533 Analytics (分析) 地理區域對應擲回無效的 API 呼叫錯誤
APIRT-52 自訂報表:多個 API 的回應狀態碼為空值