你当前正在访问 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 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。 |
vm
|
path | True |
string |
VM 规模集的名称。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
还行 |
|
Other Status Codes |
描述操作失败的原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Virtual |
Virtual |
VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
示例请求
示例响应
{
"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
示例请求
示例响应
{
"location": "aaaaaa",
"id": "aaaaaaaaaa"
}
定义
名称 | 说明 |
---|---|
Api |
Api 错误。 |
Api |
Api 错误基数。 |
Cloud |
来自计算服务的错误响应。 |
Inner |
内部错误详细信息。 |
Rolling |
对滚动升级执行的最后一个操作。 |
Rolling |
执行滚动升级时使用的配置参数。 |
Rolling |
有关每个升级状态中的虚拟机实例数的信息。 |
Rolling |
有关总体升级的当前运行状态的信息。 |
Rolling |
指示升级的当前状态的代码。 |
Rolling |
最新虚拟机规模集滚动升级的状态。 |
ApiError
Api 错误。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
details |
API 错误详细信息 |
|
innererror |
Api 内部错误 |
|
message |
string |
错误消息。 |
target |
string |
特定错误的目标。 |
ApiErrorBase
Api 错误基数。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
message |
string |
错误消息。 |
target |
string |
特定错误的目标。 |
CloudError
来自计算服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
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 |
指示升级的当前状态的代码。 |
|
lastAction |
对滚动升级执行的最后一个操作。 |
|
lastActionTime |
string |
升级的最后一次操作时间。 |
startTime |
string |
升级的开始时间。 |
RollingUpgradeStatusCode
指示升级的当前状态的代码。
名称 | 类型 | 说明 |
---|---|---|
Cancelled |
string |
|
Completed |
string |
|
Faulted |
string |
|
RollingForward |
string |
RollingUpgradeStatusInfo
最新虚拟机规模集滚动升级的状态。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID |
location |
string |
资源位置 |
name |
string |
资源名称 |
properties.error |
此升级的错误详细信息(如果有)。 |
|
properties.policy |
适用于此升级的滚动升级策略。 |
|
properties.progress |
有关每个升级状态中的虚拟机实例数的信息。 |
|
properties.runningStatus |
有关总体升级的当前运行状态的信息。 |
|
tags |
object |
资源标记 |
type |
string |
资源类型 |