通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

  • 项目

适用于：开发人员|标准|高级

2024 年 6 月 14 日之后，作为 Azure API 管理工作区（预览版）开发的一部分，我们引入了多项重大更改。

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

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

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

中断性变更

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

支持的服务层级的更改

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

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

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

分配工作区级实体

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

不再支持分配 建议的迁移步骤
将工作区 API 分配到服务级别产品 使用工作区级产品
将工作区 API 或产品分配到服务级别标记 使用工作区级标记

帮助和支持

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

详细信息

相关内容

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