工作区 - 中断性变更（2024 年 6 月）

可用性

在 2024 年 6 月 14 日之后，作为 Azure API 管理中的工作区（预览版）开发工作的一部分，我们会引入几项中断性变更。

在 2024 年 6 月 14 日之后，如果工作区及其中托管的 API 仍依赖于要更改的功能，则它们可能会停止工作。 在工作区外部托管的 API 和资源不受此更改的影响。

我的服务是否受这些更改的影响？

如果在 API 管理实例中配置了工作区（预览版），服务可能会受到这些更改的影响。 此功能在“高级”、“标准”和“开发人员”层级中引入。

中断性变更

查看以下中断性变更，以确定是否需要采取措施：

支持的服务层级的更改

以下服务层级不再支持工作区：“标准”和“开发人员”。 工作区仅在“高级”层级中使用。

对在工作区中分配服务级别实体的支持的更改

不再支持以下将工作区实体分配到服务级别实体的操作：

• 将工作区 API 分配到服务级别产品

• 将工作区 API 分配到服务级别标记

• 将工作区产品分配到服务级别标记

• 将服务级别组分配给工作区产品，以实现可见性控制

  注意

  内置来宾和开发人员组继续在工作区中可用。

对支持的上下文对象的更改

工作区策略或服务级别的所有 API 策略中不再支持以下 context 对象：

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

可以改用 context.Workspace 对象。

此更改的截止时间是什么？

中断性变更将在 2024 年 6 月 14 日之后引入。 强烈建议在该日期之前对工作区配置进行所有必要的更改。

我需要做些什么？

如果工作区受这些更改的影响，则需要更新工作区配置，使其与新功能保持一致。

标准层客户

如果正在使用标准层中的工作区，请升级到高级层以继续使用工作区。

开发人员层客户

开发人员层专为单用户或单团队用例而设计。 由于计算资源有限、缺少 SLA 且没有基础结构冗余，因此无法促进与工作区的多团队协作。 如果正在开发人员层中使用工作区预览版，可以选择以下选项之一：

• 在高级层实例中聚合

  将每个开发人员层实例升级到高级层是一个选项，但请考虑在单个高级层实例中聚合多个非生产环境。 在高级层中使用工作区隔离不同的环境。

• 使用开发人员层实例进行开发，迁移到高级层中以进行生产

  可以将开发人员层实例用于开发环境。 对于更高环境，可以将每个开发人员层服务的配置迁移到高级层服务的工作区，例如，使用 CI/CD 管道。 使用此方法时，在跨环境管理配置时可能会遇到问题或冲突。

  如果当前正在开发人员层实例中使用工作区，则可以将工作区配置迁移到无工作区的开发人员层实例：

  1. 从 API 管理实例导出资源管理器模板。 可以从Azure 门户或通过使用其他工具导出模板。
  2. 删除资源 ID 值的以下子字符串：/workspaces/[^/]+
  3. 部署模板。 有关详细信息，请参阅快速入门：使用 Azure 门户创建和部署 ARM 模板。

  根据用例，可能需要在 API 管理实例中执行其他配置更改。

分配工作区级实体

如果已将工作区级实体分配到工作区预览版中的服务级实体，请参阅下表了解迁移指南。

帮助和支持

如果有疑问，请从 Microsoft Q&A 中的社区专家那里获取解答。 如有支持计划并需要技术帮助，请创建支持请求。

详细信息

• 工作区概述

相关内容

查看所有即将推出的中断性变更和功能停用。