Поделиться через


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-03-01

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

Имя группы ресурсов.

subscriptionId
path True

string

Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.

vmScaleSetName
path True

string

Имя масштабируемого набора виртуальных машин.

api-version
query True

string

Версия API клиента.

Ответы

Имя Тип Описание
200 OK

RollingUpgradeStatusInfo

ОК

Other Status Codes

CloudError

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: 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-03-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-03-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 при создании пакетов обновления. Чтобы определить размер пакета, примите во внимание домен обновления и 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

Идентификатор ресурса

location

string

Расположение ресурса

name

string

Имя ресурса

properties.error

ApiError

Сведения об ошибке для этого обновления, если таковые имеются.

properties.policy

RollingUpgradePolicy

Политики последовательного обновления, применяемые для этого обновления.

properties.progress

RollingUpgradeProgressInfo

Сведения о количестве экземпляров виртуальных машин в каждом состоянии обновления.

properties.runningStatus

RollingUpgradeRunningStatus

Сведения о текущем состоянии выполнения общего обновления.

tags

object

Теги ресурсов

type

string

Тип ресурса