Azure Spring Apps API 中断性变更

注意

基本计划和标准计划于 2025 年 3 月 17 日进入退休期。有关详细信息，请参阅 Azure Spring Apps 停用公告。

本文介绍 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

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

蓝绿部署的 RBAC 角色更改

在 properties.activeDeploymentName 资源中弃用字段 Spring/Apps。将 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。

Last updated on 2025-09-05

通过