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

工作区 - 中断性变更(2024 年 6 月)

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

重要

如果在 2024 年 7 月工作区正式发布后创建了工作区,则工作区不应受到这些更改的影响。

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

在 2024 年 6 月 14 日之后,如果工作区及其中托管的 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 中的社区专家那里获取解答。 如有支持计划并需要技术帮助,请创建支持请求

详细信息

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