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


Virtual Machine Scale Sets - Get OS Upgrade History

Возвращает список обновлений ОС в экземпляре масштабируемого набора виртуальных машин.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?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

VirtualMachineScaleSetListOSUpgradeHistory

ХОРОШО

Other Status Codes

CloudError

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

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

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Образец запроса

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

Пример ответа

{
  "value": [
    {
      "properties": {
        "runningStatus": {
          "code": "RollingForward",
          "startTime": "2021-11-30T13:05:40.442Z",
          "endTime": "2021-11-30T13:05:40.443Z"
        },
        "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"
        },
        "startedBy": "Unknown",
        "targetImageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer",
          "exactVersion": "aaaaaaa",
          "sharedGalleryImageId": "aaaaaa",
          "id": "aaaaaaaaaaaaaaaaaaa"
        },
        "rollbackInfo": {
          "successfullyRolledbackInstanceCount": 12,
          "failedRolledbackInstanceCount": 2,
          "rollbackError": {
            "details": [
              {
                "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
                "target": "aaaa",
                "message": "aa"
              }
            ],
            "innererror": {
              "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
            },
            "code": "aaaaaaa",
            "target": "aaaaaaa",
            "message": "aaaaaaaaa"
          }
        }
      },
      "type": "aaaaaaaaaaaaaaaaaaa",
      "location": "aaaaaaaaaaaaa"
    }
  ],
  "nextLink": "aaaaaaaaa"
}

VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

Образец запроса

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

Пример ответа

{
  "value": [
    {}
  ]
}

Определения

Имя Описание
ApiError

Ошибка API.

ApiErrorBase

База ошибок API.

CloudError

Ответ на ошибку из службы вычислений.

ImageReference

Указывает сведения об используемом изображении. Вы можете указать сведения о образах платформы, образах Marketplace или образах виртуальных машин. Этот элемент необходим, если вы хотите использовать образ платформы, образ Marketplace или образ виртуальной машины, но не используется в других операциях создания. ПРИМЕЧАНИЕ. Издатель ссылок на изображения и предложение можно задать только при создании масштабируемого набора.

InnerError

Сведения о внутренней ошибке.

RollbackStatusInfo

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

RollingUpgradeProgressInfo

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

UpgradeOperationHistoricalStatusInfo

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

UpgradeOperationHistoricalStatusInfoProperties

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

UpgradeOperationHistoryStatus

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

UpgradeOperationInvoker

Вызов операции обновления

UpgradeState

Код, указывающий текущее состояние обновления.

VirtualMachineScaleSetListOSUpgradeHistory

Список ответов на операцию обновления ОС масштабируемого набора виртуальных машин.

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.

ImageReference

Указывает сведения об используемом изображении. Вы можете указать сведения о образах платформы, образах Marketplace или образах виртуальных машин. Этот элемент необходим, если вы хотите использовать образ платформы, образ Marketplace или образ виртуальной машины, но не используется в других операциях создания. ПРИМЕЧАНИЕ. Издатель ссылок на изображения и предложение можно задать только при создании масштабируемого набора.

Имя Тип Описание
communityGalleryImageId

string

Укажите уникальный идентификатор образа коллекции сообщества для развертывания виртуальной машины. Это можно получить из вызова GET изображения коллекции сообщества.

exactVersion

string

Указывает в десятичных числах версию образа платформы или образа Marketplace, используемого для создания виртуальной машины. Это поле чтения отличается от "version", только если значение, указанное в поле "версия", имеет значение "latest".

id

string

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

offer

string

Указывает предложение образа платформы или образа Marketplace, используемого для создания виртуальной машины.

publisher

string

Издатель образа.

sharedGalleryImageId

string

Укажите уникальный идентификатор образа общей коллекции для развертывания виртуальной машины. Это можно получить из вызова GET образа общей коллекции.

sku

string

Номер SKU изображения.

version

string

Указывает версию образа платформы или образа Marketplace, используемого для создания виртуальной машины. Допустимые форматы: Major.Minor.Build или latest. Основные, незначительные и сборки — это десятичные числа. Укажите "последняя", чтобы использовать последнюю версию образа, доступного во время развертывания. Даже если вы используете "последнюю версию", образ виртуальной машины не будет автоматически обновляться после развертывания, даже если новая версия станет доступной. Не используйте поле "версия" для развертывания образа коллекции, образ коллекции всегда должен использовать поле "id" для развертывания, чтобы использовать последнюю версию образа коллекции, просто установить "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}" в поле "id" без ввода версии.

InnerError

Сведения о внутренней ошибке.

Имя Тип Описание
errordetail

string

Внутреннее сообщение об ошибке или дамп исключений.

exceptiontype

string

Тип исключения.

RollbackStatusInfo

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

Имя Тип Описание
failedRolledbackInstanceCount

integer

Количество экземпляров, которые не удалось выполнить откат.

rollbackError

ApiError

Сведения об ошибке, если сбой отката ОС.

successfullyRolledbackInstanceCount

integer

Количество экземпляров, которые успешно откатились.

RollingUpgradeProgressInfo

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

Имя Тип Описание
failedInstanceCount

integer

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

inProgressInstanceCount

integer

Количество обновляемых экземпляров.

pendingInstanceCount

integer

Число экземпляров, которые еще не начали обновляться.

successfulInstanceCount

integer

Количество экземпляров, которые были успешно обновлены.

UpgradeOperationHistoricalStatusInfo

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

Имя Тип Описание
location

string

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

properties

UpgradeOperationHistoricalStatusInfoProperties

Сведения о свойствах операции обновления.

type

string

Тип ресурса

UpgradeOperationHistoricalStatusInfoProperties

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

Имя Тип Описание
error

ApiError

Сведения об ошибке для этого обновления, если есть какие-либо.

progress

RollingUpgradeProgressInfo

Количество виртуальных машин в каждом состоянии.

rollbackInfo

RollbackStatusInfo

Сведения о откате ОС при выполнении

runningStatus

UpgradeOperationHistoryStatus

Сведения о общем состоянии операции обновления.

startedBy

UpgradeOperationInvoker

Вызов операции обновления

targetImageReference

ImageReference

Сведения о справочнике по изображениям

UpgradeOperationHistoryStatus

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

Имя Тип Описание
code

UpgradeState

Код, указывающий текущее состояние обновления.

endTime

string

Время окончания обновления.

startTime

string

Время начала обновления.

UpgradeOperationInvoker

Вызов операции обновления

Имя Тип Описание
Platform

string

Unknown

string

User

string

UpgradeState

Код, указывающий текущее состояние обновления.

Имя Тип Описание
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Список ответов на операцию обновления ОС масштабируемого набора виртуальных машин.

Имя Тип Описание
nextLink

string

URI для получения следующей страницы журнала обновления ОС. Вызовите ListNext() с этим, чтобы получить следующую страницу журнала обновлений.

value

UpgradeOperationHistoricalStatusInfo[]

Список обновлений ОС, выполненных в масштабируемом наборе виртуальных машин.