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

Virtual Machine Scale Set Rolling Upgrades - Get Latest

获取最新虚拟机规模集滚动升级的状态。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/rollingUpgrades/latest?api-version=2024-07-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

唯一标识 azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。

vmScaleSetName
path True

string

VM 规模集的名称。

api-version
query True

string

客户端 API 版本。

响应

名称 类型 说明
200 OK

RollingUpgradeStatusInfo

还行

Other Status Codes

CloudError

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

示例请求

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaa/rollingUpgrades/latest?api-version=2024-07-01

示例响应

{
  "properties": {
    "policy": {
      "maxBatchInstancePercent": 49,
      "maxUnhealthyInstancePercent": 81,
      "maxUnhealthyUpgradedInstancePercent": 98,
      "pauseTimeBetweenBatches": "aaaaaaaaaaaaaaa",
      "enableCrossZoneUpgrade": true,
      "prioritizeUnhealthyInstances": true,
      "rollbackFailedInstancesOnPolicyBreach": true,
      "maxSurge": true
    },
    "runningStatus": {
      "code": "RollingForward",
      "startTime": "2021-11-30T13:06:23.362Z",
      "lastAction": "Start",
      "lastActionTime": "2021-11-30T13:06:23.362Z"
    },
    "progress": {
      "successfulInstanceCount": 6,
      "failedInstanceCount": 25,
      "inProgressInstanceCount": 20,
      "pendingInstanceCount": 27
    },
    "error": {
      "details": [
        {
          "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
          "target": "aaaa",
          "message": "aa"
        }
      ],
      "innererror": {
        "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
      },
      "code": "aaaaaaa",
      "target": "aaaaaaa",
      "message": "aaaaaaaaa"
    }
  },
  "id": "aaaaaaaaaa",
  "name": "aaaaaaaaaaaaaaaaaaa",
  "type": "aaaaaaaaaaaaaaaaaaaaa",
  "location": "aaaaaa",
  "tags": {
    "key8533": "aaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

示例请求

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaa/rollingUpgrades/latest?api-version=2024-07-01

示例响应

{
  "location": "aaaaaa",
  "id": "aaaaaaaaaa"
}

定义

名称 说明
ApiError

Api 错误。

ApiErrorBase

Api 错误基数。

CloudError

来自计算服务的错误响应。

InnerError

内部错误详细信息。

RollingUpgradeActionType

对滚动升级执行的最后一个操作。

RollingUpgradePolicy

执行滚动升级时使用的配置参数。

RollingUpgradeProgressInfo

有关每个升级状态中的虚拟机实例数的信息。

RollingUpgradeRunningStatus

有关总体升级的当前运行状态的信息。

RollingUpgradeStatusCode

指示升级的当前状态的代码。

RollingUpgradeStatusInfo

最新虚拟机规模集滚动升级的状态。

ApiError

Api 错误。

名称 类型 说明
code

string

错误代码。

details

ApiErrorBase[]

API 错误详细信息

innererror

InnerError

Api 内部错误

message

string

错误消息。

target

string

特定错误的目标。

ApiErrorBase

Api 错误基数。

名称 类型 说明
code

string

错误代码。

message

string

错误消息。

target

string

特定错误的目标。

CloudError

来自计算服务的错误响应。

名称 类型 说明
error

ApiError

Api 错误。

InnerError

内部错误详细信息。

名称 类型 说明
errordetail

string

内部错误消息或异常转储。

exceptiontype

string

异常类型。

RollingUpgradeActionType

对滚动升级执行的最后一个操作。

名称 类型 说明
Cancel

string

Start

string

RollingUpgradePolicy

执行滚动升级时使用的配置参数。

名称 类型 说明
enableCrossZoneUpgrade

boolean

允许 VMSS 在构造升级批处理时忽略 AZ 边界。 考虑 Update 域和 maxBatchInstancePercent 以确定批大小。

maxBatchInstancePercent

integer

一批滚动升级同时升级的总虚拟机实例的最大百分比。 由于这是一个最大值,因此以前的或将来的批中的不正常实例可能会导致批处理中的实例百分比降低,以确保更高的可靠性。 此参数的默认值为 20%。

maxSurge

boolean

创建新的虚拟机来升级规模集,而不是更新现有虚拟机。 为每个批创建新虚拟机后,将删除现有虚拟机。

maxUnhealthyInstancePercent

integer

规模集中可能同时运行不正常的虚拟机实例的最大百分比,无论是由于升级,还是虚拟机运行状况检查在滚动升级中止之前处于不正常状态。 在启动任何批处理之前,将检查此约束。 此参数的默认值为 20%。

maxUnhealthyUpgradedInstancePercent

integer

可发现处于不正常状态的已升级虚拟机实例的最大百分比。 升级每个批处理后,将进行此检查。 如果超过此百分比,滚动更新将中止。 此参数的默认值为 20%。

pauseTimeBetweenBatches

string

完成一批中所有虚拟机的更新和开始下一批之间的等待时间。 持续时间应采用 ISO 8601 格式指定。 默认值为 0 秒(PT0S)。

prioritizeUnhealthyInstances

boolean

在任何正常运行的实例之前,升级规模集中的所有不正常实例。

rollbackFailedInstancesOnPolicyBreach

boolean

如果违反滚动升级策略,回滚失败实例到以前的模型。

RollingUpgradeProgressInfo

有关每个升级状态中的虚拟机实例数的信息。

名称 类型 说明
failedInstanceCount

integer

未能成功升级的实例数。

inProgressInstanceCount

integer

当前正在升级的实例数。

pendingInstanceCount

integer

尚未开始升级的实例数。

successfulInstanceCount

integer

已成功升级的实例数。

RollingUpgradeRunningStatus

有关总体升级的当前运行状态的信息。

名称 类型 说明
code

RollingUpgradeStatusCode

指示升级的当前状态的代码。

lastAction

RollingUpgradeActionType

对滚动升级执行的最后一个操作。

lastActionTime

string

升级的最后一次操作时间。

startTime

string

升级的开始时间。

RollingUpgradeStatusCode

指示升级的当前状态的代码。

名称 类型 说明
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

最新虚拟机规模集滚动升级的状态。

名称 类型 说明
id

string

资源 ID

location

string

资源位置

name

string

资源名称

properties.error

ApiError

此升级的错误详细信息(如果有)。

properties.policy

RollingUpgradePolicy

适用于此升级的滚动升级策略。

properties.progress

RollingUpgradeProgressInfo

有关每个升级状态中的虚拟机实例数的信息。

properties.runningStatus

RollingUpgradeRunningStatus

有关总体升级的当前运行状态的信息。

tags

object

资源标记

type

string

资源类型