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-11-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
Образец запроса
Пример ответа
{
"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
Образец запроса
Пример ответа
{
"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 |
Издатель образа. |
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 | |
Cancelled | |
Completed | |
Faulted |
VirtualMachineScaleSetListOSUpgradeHistory
Список ответов на операцию обновления ОС масштабируемого набора виртуальных машин.
Имя | Тип | Описание |
---|---|---|
nextLink |
string (uri) |
URI для получения следующей страницы журнала обновления ОС. Вызовите ListNext() с этим, чтобы получить следующую страницу журнала обновлений. |
value |
Список обновлений ОС, выполненных в масштабируемом наборе виртуальных машин. |