Azure Spring Apps API 重大變更

發行項
11/20/2024

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container 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 重大變更

取代部署中的 CPU 和 MemoryInGB 數值

取代欄位 properties.deploymentSettings.cpu ，並在 properties.deploymentSettings.memoryInGB 資源中 Spring/Apps/Deployments 。請改用 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。

共用方式為