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 重大變更

取代部署中的 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