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=2026-03-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя нечувствительно к регистру. |
|
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
|
vm
|
path | True |
string |
Имя масштабируемого набора виртуальных машин. |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция Azure успешно завершена. |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | выдать себя за учетную запись пользователя |
Примеры
|
Virtual |
|
Virtual |
VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
Образец запроса
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2026-03-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": "a://example.com/aaaaaaaaa"
}
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen
Образец запроса
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2026-03-01
Пример ответа
{
"value": [
{}
]
}
Определения
| Имя | Описание |
|---|---|
|
Api |
Ошибка API. |
|
Api |
База ошибок API. |
|
Cloud |
Ответ на ошибку из службы вычислений. |
|
Image |
Указывает сведения об используемом изображении. Вы можете указать сведения о образах платформы, образах Marketplace или образах виртуальных машин. Этот элемент необходим, если вы хотите использовать образ платформы, образ Marketplace или образ виртуальной машины, но не используется в других операциях создания. ПРИМЕЧАНИЕ. Издатель ссылок на изображения и предложение можно задать только при создании масштабируемого набора. |
|
Inner |
Сведения о внутренней ошибке. |
|
Rollback |
Сведения о откате экземпляров неработоемой виртуальной машины после операции обновления ОС. |
|
Rolling |
Сведения о количестве экземпляров виртуальных машин в каждом состоянии обновления. |
|
Upgrade |
Ответ журнала обновления ОС масштабируемого набора виртуальных машин. |
|
Upgrade |
Описывает каждое обновление ОС в масштабируемом наборе виртуальных машин. |
|
Upgrade |
Сведения о текущем состоянии выполнения общего обновления. |
|
Upgrade |
Инициатор операции обновления |
|
Upgrade |
Код, указывающий на текущий статус обновления. |
|
Virtual |
Список ответов на операцию обновления ОС масштабируемого набора виртуальных машин. |
ApiError
Ошибка API.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке API |
|
| innererror |
Внутренняя ошибка API |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект конкретной ошибки. |
ApiErrorBase
База ошибок API.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект конкретной ошибки. |
CloudError
Ответ на ошибку из службы вычислений.
| Имя | Тип | Описание |
|---|---|---|
| error |
Ошибка API. |
ImageReference
Указывает сведения об используемом изображении. Вы можете указать сведения о образах платформы, образах Marketplace или образах виртуальных машин. Этот элемент необходим, если вы хотите использовать образ платформы, образ Marketplace или образ виртуальной машины, но не используется в других операциях создания. ПРИМЕЧАНИЕ. Издатель ссылок на изображения и предложение можно задать только при создании масштабируемого набора.
| Имя | Тип | Описание |
|---|---|---|
| communityGalleryImageId |
string |
Укажите уникальный идентификатор образа коллекции сообщества для развертывания виртуальной машины. Это можно получить из вызова GET изображения коллекции сообщества. |
| exactVersion |
string |
Указывает в десятичных числах версию образа платформы или образа Marketplace, используемого для создания виртуальной машины. Это поле чтения отличается от "version", только если значение, указанное в поле "версия", имеет значение "latest". |
| id |
string |
Идентификатор ресурса |
| offer |
string |
Указывает предложение образа платформы или образа Marketplace, используемого для создания виртуальной машины. |
| publisher |
string |
Image publisher. |
| 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 (int32) |
Количество экземпляров, которые не удалось выполнить откат. |
| rollbackError |
Сведения об ошибке, если сбой отката ОС. |
|
| successfullyRolledbackInstanceCount |
integer (int32) |
Количество экземпляров, которые успешно откатились. |
RollingUpgradeProgressInfo
Сведения о количестве экземпляров виртуальных машин в каждом состоянии обновления.
| Имя | Тип | Описание |
|---|---|---|
| failedInstanceCount |
integer (int32) |
Количество экземпляров, которые не удалось обновить успешно. |
| inProgressInstanceCount |
integer (int32) |
Количество обновляемых экземпляров. |
| pendingInstanceCount |
integer (int32) |
Число экземпляров, которые еще не начали обновляться. |
| successfulInstanceCount |
integer (int32) |
Количество экземпляров, которые были успешно обновлены. |
UpgradeOperationHistoricalStatusInfo
Ответ журнала обновления ОС масштабируемого набора виртуальных машин.
| Имя | Тип | Описание |
|---|---|---|
| location |
string |
Расположение ресурса |
| properties |
Сведения о свойствах операции обновления. |
|
| type |
string |
Тип ресурса |
UpgradeOperationHistoricalStatusInfoProperties
Описывает каждое обновление ОС в масштабируемом наборе виртуальных машин.
| Имя | Тип | Описание |
|---|---|---|
| error |
Сведения об ошибке для этого обновления, если есть какие-либо. |
|
| progress |
Количество виртуальных машин в каждом состоянии. |
|
| rollbackInfo |
Информация об откате ОС, если он выполнен |
|
| runningStatus |
Сведения о общем состоянии операции обновления. |
|
| startedBy |
Инициатор операции обновления |
|
| targetImageReference |
Справочная информация об изображении |
UpgradeOperationHistoryStatus
Сведения о текущем состоянии выполнения общего обновления.
| Имя | Тип | Описание |
|---|---|---|
| code |
Код, указывающий на текущий статус обновления. |
|
| endTime |
string (date-time) |
Время окончания обновления. |
| startTime |
string (date-time) |
Время начала обновления. |
UpgradeOperationInvoker
Инициатор операции обновления
| Значение | Описание |
|---|---|
| Unknown | |
| User | |
| Platform |
UpgradeState
Код, указывающий на текущий статус обновления.
| Значение | Описание |
|---|---|
| RollingForward | |
| RollingBack | |
| Cancelled | |
| Completed | |
| Faulted |
VirtualMachineScaleSetListOSUpgradeHistory
Список ответов на операцию обновления ОС масштабируемого набора виртуальных машин.
| Имя | Тип | Описание |
|---|---|---|
| nextLink |
string (uri) |
URI для получения следующей страницы журнала обновлений ОС. Вызовите ListNext() с этим параметром, чтобы получить следующую страницу истории обновлений. |
| value |
Список обновлений ОС, выполненных в масштабируемом наборе виртуальных машин. |