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


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

Учетные данные подписки, которые однозначно определяют подписку 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-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 при создании пакетов обновления. Учитывайте домен обновления и 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

Тип ресурса