使用多個版本 | Qlik Cloud 說明
跳到主要內容 跳至補充內容

使用多個版本

API Designer 允許您使用相同 API 定義的數個版本,以協助您管理 API 生命週期。您可以:

  • 在生產環境中維護現有的 API 版本,同時在新的版本中引入重大或破壞性的變更。
  • 獲得對已發佈版本的可見性與控制權。
  • 在設計 API 變更時獲得彈性。

當您建立 API 的新版本時,所有內容都會複製到新版本中,然後可以獨立修改每個版本,而不會影響其他版本。

API Designer 首頁會顯示您擁有的所有 API 以及與您共用的所有 API 版本。
API Designer 首頁。

建立新的 API 版本

建立現有 API 定義的新版本。

您是 API 的擁有者,或是至少一個 API 版本的編輯者。
  1. 在首頁上,前往您要為其建立新版本的 API。
    如有需要,您可以依名稱或擁有者篩選清單。
  2. 按一下您要複製的版本旁邊的 選單 按鈕,然後按一下 <version> 建立新版本
    Movie catalog API 的檢視,以及針對 1.1.0 版本展開的選單圖示。
  3. 輸入新版本。
  4. 按一下 建立
將建立與來源版本內容相同的新 API 版本。模擬和文件預設為停用。

刪除 API 版本

您是 API 的擁有者。
  1. 在首頁上,按一下您要刪除的版本旁邊的 選單 按鈕,然後按一下 刪除
  2. 按一下 刪除 以確認。
選取的版本已刪除。如果您要刪除整個 API,則需要刪除每個版本。

匯入版本內容

從現有合約將內容匯入 API 版本,取代或合併其目前的內容。

您是 API 的擁有者或 API 版本的編輯者。

使用此功能從外部合約檔案更新版本,而無需建立新版本。在整個匯入過程中會保留版本識別碼。

這與匯入定義不同,後者會在 API Designer 中建立新的 API。

  1. 開啟您要更新之版本的 匯入版本內容

    您可以從下列位置存取此動作:

    • 在首頁上,按一下版本旁邊的選單按鈕,然後按一下 匯入版本內容
      選單按鈕中的匯入版本內容選項。
    • 在首頁上,選取版本以開啟詳細資料窗格,然後按一下 匯入版本內容
      版本首頁中的匯入版本內容選項。
    • 在版本編輯器中,按一下 編輯 > 匯入版本內容
      版本編輯器中的匯入版本內容選項。
  2. 選取要匯入之合約的格式與來源。
    您可以從本機檔案、URL 或直接貼到對話方塊中的文字進行匯入。
  3. 行為 下,選取套用匯入內容的方式。
    • 取代:以匯入的合約覆寫所有目前的內容。會保留 API 名稱、版本識別碼和規格版本。
    • 合併:將匯入的內容與現有版本內容結合。會保留 API 名稱和版本識別碼。如果匯入的元素與現有元素同名,則匯入的元素會重新命名並加上 _merge 尾碼 (例如,User_merge)。會略過重複的基礎 URL 和媒體類型。
    匯入版本內容對話方塊。
  4. 按一下 匯入

版本編輯器會開啟並套用更新的內容。

此頁面是否對您有幫助?

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們!