你当前正在访问 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 管道。 使用此方法时,在跨环境管理配置时可能会遇到问题或冲突。
如果当前正在开发人员层实例中使用工作区,则可以将工作区配置迁移到无工作区的开发人员层实例:
- 从 API 管理实例导出资源管理器模板。 可以从Azure 门户或通过使用其他工具导出模板。
- 删除资源 ID 值的以下子字符串:
/workspaces/[^/]+
- 部署模板。 有关详细信息,请参阅快速入门:使用 Azure 门户创建和部署 ARM 模板。
根据用例,可能需要在 API 管理实例中执行其他配置更改。
分配工作区级实体
如果已将工作区级实体分配到工作区预览版中的服务级实体,请参阅下表了解迁移指南。
不再支持分配 | 推荐的迁移步骤 |
---|---|
将工作区 API 分配到服务级别产品 | 使用工作区级产品 |
将工作区 API 或产品分配到服务级别标记 | 使用工作区级标记 |
帮助和支持
如果有疑问,请从 Microsoft Q&A 中的社区专家那里获取解答。 如有支持计划并需要技术帮助,请创建支持请求。
详细信息
相关内容
查看所有即将推出的中断性变更和功能停用。