15.05.27 - Apigee Edge 雲端版本資訊

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

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

如有任何疑問,請前往 Apigee 客戶服務團隊

如需查看所有 Apigee Edge 版本資訊的清單,請參閱「Apigee 版本資訊」。

新功能和強化功能

以下是本版本的新功能和強化功能。

SmartDocs 一般供應情形

SmartDocs 已從測試版畢業並全面上線。更新和新功能包括:

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

如需更多功能說明,請參閱這篇 網誌文章

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

全新 API Proxy 編輯器 Beta 版

API Proxy 編輯器的新 Beta 版現已推出。如要存取,請在編輯現有 API 代理程式時,按一下「存取 Beta 版」連結。您可以來回切換「傳統」和「Beta」編輯器。

新的 OAuthV2 政策

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

存取實體政策中的新實體

存取實體政策可提供下列新實體的存取權:消費者金鑰範圍、授權碼、要求權杖和驗證器。詳情請參閱「存取實體政策」。

顯示即將到期的 SSL 憑證

管理使用者介面 (「管理」>「SSL 憑證」) 中的「SSL 憑證」頁面會顯示 SSL 憑證的到期日,時間範圍為 10、15、30 或 90 天,具體取決於您在「新到期日」下拉式欄位中所做的選擇。

管理使用者介面中顯示的開發人員應用程式名稱

Edge 中的開發人員應用程式有內部名稱 (不會變更) 和顯示名稱 (可變更)。在管理使用者介面 (「發布」>「開發人員應用程式」>「應用程式名稱」) 中的「開發人員應用程式」頁面上,應用程式內部「名稱」會與「顯示名稱」一併顯示,方便您透過視覺化方式辨識應用程式的內部名稱,以利排解問題和管理 API。

管理 UI 中將移除傳統版自訂報表

管理員使用者介面中已不再提供選用的傳統版自訂 Analytics 報表。


SmartDocs 升級程序

如果您在 Beta 版期間已開始使用 SmartDocs,則必須在開發人員入口網站中升級 SmartDocs,才能使用正式版的全新功能。

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

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

如何從 SmartDocs Beta 版升級至正式版

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

如果您是 Edge 企業客戶,並對升級程序有任何疑問或疑慮,請傳送電子郵件至 marsh@apigee.com 和 cnovak@apigee.com。如果沒有,請使用 Apigee 社群尋求最佳回覆。

修正的錯誤

這個版本修正了下列錯誤。

問題 ID 說明
TBD-72 訊息記錄政策問題
MGMT-2124 在 UI 中儲存權限時,客戶角色的權限會重設
MGMT-2048 使用者具有自訂角色,該角色會將部署權限限制在一個環境,但使用者可以在其他環境中部署
MGMT-2041 從預設附件範本中移除 FaultRules 元素
在建立 API Proxy 或新增政策時,系統不再自動新增 FaultRules 元素 (這類元素不會用於政策或 API Proxy 步驟)。
MGMT-2034 擷取 WSDL 傳回失敗:"Fetch WSDL Error: Error processing WSDL."
MGMT-1812 在匯入期間新增 TargetEndpoint 驗證
與 ProxyEndpoint 類似,TargetEndpoint 會驗證在 API 代理程式匯入期間,條件中使用的適當結構定義和運算式。
MGMT-1345 匯入含有多個命名空間的 WSDL 會導致建構 SOAP 步驟不正確
MGMT-800 建立名稱為「default」的資源會導致 UI 中斷
MGMT-602 API Proxy Develop 檢視畫面:如果端點沒有 PreFlow/PostFlow 導致錯誤,請新增回應快取政策
MGMT-460 重新命名政策會導致行為異常,且無法移除重複的政策
DEVRT-1565 「CHARGES」的 15 分鐘間隔
AXAPP-1728 在數據分析中略過營利變數
AXAPP-1690 自訂報表出現「Invalid API Error」錯誤
AXAPP-1533 Analytics 地圖功能擲回「Invalid API Call」錯誤
APIRT-52 自訂報表:許多 API 的回應狀態碼為空值