Share via

工作區 - 重大變更 （2024 年 6 月）

  • 發行項

適用於：開發人員 |標準 |進階版

在 2024 年 6 月 14 日之後，在 Azure API 管理 開發工作區（預覽版）之後，我們引進了數項重大變更。

2024 年 6 月 14 日之後，如果工作區和 API 仍依賴設定為變更的功能，您的工作區和 API 可能會停止運作。 此變更不會影響在工作區外部管理的 API 和資源。

我的服務是否受到這些變更的影響？

如果您在 API 管理 實例中設定工作區（預覽），您的服務可能會受到這些變更的影響。 這項功能是在 進階版、標準和開發人員層中引進的。

重大變更

檢閱下列重大變更，以判斷您是否需要採取動作：

變更為支持的服務層級

下列服務層級將不再支援工作區： Standard 和 Developer。 工作區將在 進階版 層中提供。

如需 v2 層的可用性，請參閱 Azure API 管理 v2 層。

變更，以支援在工作區中指派服務層級實體

不再支援將工作區實體指派給服務層級實體：

  • 將工作區 API 指派給服務等級產品

  • 將工作區 API 指派給服務層級標籤

  • 將工作區產品指派給服務層級標籤

  • 將服務層級群組指派給工作區產品以取得可見度控件

    注意

    內建的來賓和開發人員群組將繼續在工作區中提供。

對支援的內容對象的變更

工作區原則或服務層級上所有 API 原則將不再支援下列 context 物件：

  • context.Api.Workspace
  • context.Product.Workspace

context.Workspace您可以改用物件。

注意

您可以繼續參考工作區層級原則中 對象中 context 服務層級的使用者。

變更的最後期限為何？

重大變更將在 2024 年 6 月 14 日之後推出。 強烈建議您在該日期之前對工作區的設定進行所有必要的變更。

我需要做什麼事嗎？

如果您的工作區受到這些變更的影響，您必須更新工作區設定，以配合新功能。

標準層客戶

如果您使用標準層中的工作區，請升級至 進階版 層以繼續使用工作區。

開發人員層客戶

開發人員層是針對單一使用者或單一小組使用案例所設計。 由於運算資源有限、SLA 不足，且沒有基礎結構備援，因此無法協助與工作區進行多小組共同作業。 如果您在開發人員層中使用工作區預覽，您可以選擇下列其中一個選項：

  • 進階版 層實例中的匯總

    將每個開發人員層實例升級至 進階版 層是一個選項，請考慮在單一 進階版 層實例中匯總多個非生產環境。 使用 進階版 層中的工作區來隔離不同的環境。

  • 使用開發人員層實例進行開發，遷移至生產 進階版 層中的工作區

    您可以針對開發環境使用開發人員層實例。 針對較高環境，您可以使用 CI/CD 管線，將每個開發人員層服務的組態移轉至 進階版 層服務的工作區。 使用這種方法，您可能會在跨環境管理設定時遇到問題或衝突。

    如果您目前在開發人員層實例中使用工作區，您可以將工作區設定移轉至沒有工作區的開發人員層實例：

    1. 從 API 管理 實例匯出 Resource Manager 範本。 您可以從 Azure 入口網站 或使用其他工具匯出範本。
    2. 移除資源識別碼值的下列子字串： /workspaces/[^/]+
    3. 部署範本。 如需詳細資訊，請參閱快速入門：使用 Azure 入口網站 建立和部署ARM範本。

    根據您的使用案例，您可能需要在 API 管理 實例中執行其他組態變更。

工作區層級實體的指派

如果您在工作區預覽版中將工作區層級實體指派給服務層級實體，請參閱下表以取得移轉指引。

不再支援指派 建議的移轉步驟
將工作區 API 指派給服務等級產品 使用工作區層級產品
將工作區 API 或產品指派給服務層級標籤 使用工作區層級標籤

說明與支援 

如有疑問，請在 Microsoft Q&A 中尋求社群專家的解答。 如果您具備支援計劃且需要技術協助，請提出支援要求。

其他相關資訊

相關內容

查看所有即將推出的重大變更和功能淘汰。