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

Azure Spring Apps API 中断性变更

项目
11/20/2024

注意

基本、标准和企业计划将从 2025 年 3 月中旬开始弃用，停用期为 3 年。建议转换到 Azure 容器应用。有关详细信息，请参阅 Azure Spring Apps 停用公告。

标准消耗和专用计划将于 2024 年 9 月 30 日开始弃用，并在六个月后完全关闭。建议转换到 Azure 容器应用。有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于：✔️ 基本版/标准版 ✔️ 企业版

本文介绍 Azure Spring Apps API 中引入的中断性变更。

Azure Spring Apps 服务发布了新的稳定 API 版本 2022-04-01。新的 API 版本在以前的稳定 API 版本 2020-07-01 的基础上引入了中断性变更。我们建议将 API 调用更新为新的 API 版本。

以前的 API 弃用日期

自 2025 年 4 月起，不支持以前的 API 版本 2020-07-01。

从 2020-07-01 到 2022-04-01 的 API 中断性变更

在 Deployments 中弃用数字值 CPU 和 MemoryInGB

在 Spring/Apps/Deployments 资源中弃用字段 properties.deploymentSettings.cpu 和 properties.deploymentSettings.memoryInGB。请改用 properties.deploymentSettings.resourceRequests.cpu 和 properties.deploymentSettings.resourceRequests.memory。

蓝绿部署的 RBAC 角色更改

在 Spring/Apps 资源中弃用字段 properties.activeDeploymentName。将 POST/SUBSCRIPTIONS/RESOURCEGROUPS/PROVIDERS/MICROSOFT.APPPLATFORM/SPRING/APPS/SETACTIVEDEPLOYMENTS 用于蓝绿部署。此操作需要单独的 RBAC 角色 spring/apps/setActiveDeployments/action 才能执行。

从 Spring/Apps/Deployments 资源的不同属性包移动选项

弃用 properties.createdTime。请使用 systemData.createdAt。
弃用 properties.deploymentSettings.jvmOptions。请使用 properties.source.jvmOptions。
弃用 properties.deploymentSettings.jvmOptions。请使用 properties.source.runtimeVersion。
弃用 properties.deploymentSettings.netCoreMainEntryPath。请使用 properties.source.netCoreMainEntryPath。
弃用 properties.appName，可从 id 中提取它。

Azure CLI 扩展中的更新

为蓝绿部署添加新的 RBAC 角色

需要添加 RBAC 角色 spring/apps/setActiveDeployments/action 才能执行以下 Azure CLI 命令：

az spring app set-deployment \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <app-name> \
    --deployment <deployment-name>
az spring app unset-deployment \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <app-name>

输出更新

如果使用版本低于 3.0.0 的 Azure CLI spring-cloud 扩展，但想要升级扩展版本或迁移到 spring 扩展，则应注意以下输出更新。

az spring app 命令输出：删除 properties.activeDeploymentName。请改用 properties.activeDeployment.name。
az spring app 命令输出：删除 properties.createdTime。请改用 systemData.createdAt。
az spring app 命令输出：删除 properties.activeDeployment.properties.deploymentSettings.cpu。请改用 properties.activeDeployment.properties.deploymentSettings.resourceRequests.cpu。
az spring app 命令输出：删除 properties.activeDeployment.properties.deploymentSettings.memoryInGB。请改用 properties.activeDeployment.properties.deploymentSettings.resourceRequests.memory。
az spring app 命令输出：删除 properties.activeDeployment.properties.deploymentSettings.jvmOptions。请改用 properties.activeDeployment.properties.source.jvmOptions。
az spring app 命令输出：删除 properties.activeDeployment.properties.deploymentSettings.runtimeVersion。请改用 properties.activeDeployment.properties.source.runtimeVersion。
az spring app 命令输出：删除 properties.activeDeployment.properties.deploymentSettings.netCoreMainEntryPath。请改用 properties.activeDeployment.properties.source.netCoreMainEntryPath。

通过