Share via


Azure Spring Apps API 重大變更

注意

Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。 雖然服務有新的名稱,但在我們努力更新資產,例如螢幕快照、影片和圖表時,您會在某些地方看到舊名稱一段時間。

本文適用於: ✔️基本/標準✔️企業

本文說明 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.cpuproperties.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