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

使用多個版本

上次更新:2026/10/20

API 合約可讓您維護同一個 API 合約的多個版本,讓您在準備新版本變更的同時,能維持已發佈版本的穩定。

  • 在生產環境中維護現有 API 版本,同時在新版本中引入破壞性變更。
  • 從單一位置追蹤和管理已發布的版本。
  • 在不影響現有版本的情況下進行 API 變更。

當您建立新版本時,所有內容都會複製到新版本。最新版本隨後即可獨立更新,而不會影響先前的版本。

僅最新版本可編輯,且您只能從該版本建立新版本。較舊版本為唯讀。

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

建立新的 API 版本

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

資訊備註

備註:

您只能從最新版本建立新版本。較舊的版本為唯讀,無法編輯或用來建立新版本。

您是此 API 的擁有者,或是此 API 至少一個版本的編輯者。
  1. 在首頁上,前往您要建立新版本的 API。
    如有需要,您可以依名稱或擁有者篩選清單。
  2. 開啟最新版本以檢視預覽,然後按一下建立新版本。
    Contacts API 與「建立新版本」按鈕的檢視畫面。
  3. 輸入新版本。
  4. 按一下建立。
已建立您 API 的新版本,內容與最新版本相同。模擬與說明文件預設為停用。

將 API 版本發布至 Qlik Catalog

將 API 合約的版本發布至 Qlik 空間,讓協作者可以在 Qlik Catalog 中找到它。

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

當您發布版本時,合約版本在 API 合約中會變為不可變且唯讀。若要進行變更,請從最新版本建立新版本,並繼續在新版本上作業。

  1. 在首頁上,按一下您要發佈的版本以開啟預覽,然後按一下 發佈。
    Contacts API 與「發布」按鈕的檢視畫面。
  2. 在發布對話方塊中,選取您要發布該版本的 Qlik 空間。
  3. 檢視版本預覽並輸入發布備註。
  4. 按一下發布。

所選版本會發佈至選取的 Qlik 空間,並在 API 合約中成為唯讀。如果您需要再次編輯合約,請先建立新版本。

刪除 API 版本

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

匯入版本內容

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

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

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

這不同於匯入定義,這會在 API Contracts 中建立新的 API。

  1. 針對您要更新的版本,開啟匯入版本內容。

    此操作不適用於唯讀版本。

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

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

版本編輯器隨即開啟,並已套用更新後的內容。

此頁面是否對您有幫助?

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