共用方式為

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

  • 發行項

適用於：開發人員 |標準 |獎賞

重要

如果您在 2024 年 7 月正式發行工作區之後建立工作區，則您的工作區不應受到這些變更的影響。

在 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 中尋求社群專家的解答。 如果您具備支援計劃且需要技術協助，請提出支援要求。

其他相關資訊

相關內容

查看所有即將發生的中斷性變更和功能淘汰。