Virtual Machine Scale Sets - Get OS Upgrade History
Získá seznam upgradů operačního systému v instanci škálovací sady virtuálních počítačů.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2026-03-01
Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Název skupiny zdrojů. Název nerozlišuje malá a velká písmena. |
|
subscription
|
path | True |
string minLength: 1 |
ID cílového předplatného. |
|
vm
|
path | True |
string |
Název škálovací sady virtuálních počítačů |
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Operace Azure byla úspěšně dokončena. |
|
| Other Status Codes |
Neočekávaná chybová odpověď |
Zabezpečení
azure_auth
Tok OAuth2 služby Azure Active Directory.
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Name | Description |
|---|---|
| user_impersonation | vydávat se za svůj uživatelský účet |
Příklady
|
Virtual |
|
Virtual |
VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
Ukázkový požadavek
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2026-03-01
Ukázková odpověď
{
"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
Ukázkový požadavek
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2026-03-01
Ukázková odpověď
{
"value": [
{}
]
}
Definice
| Name | Description |
|---|---|
|
Api |
Chyba rozhraní API |
|
Api |
Základ chyb rozhraní API. |
|
Cloud |
Odpověď na chybu z výpočetní služby |
|
Image |
Určuje informace o obrázku, který se má použít. Můžete zadat informace o imagích platformy, imagích marketplace nebo imagích virtuálních počítačů. Tento prvek se vyžaduje, pokud chcete použít image platformy, image marketplace nebo image virtuálního počítače, ale nepoužívá se v jiných operacích vytváření. POZNÁMKA: Odkaz na image a nabídka lze nastavit pouze při vytváření škálovací sady. |
|
Inner |
Podrobnosti vnitřní chyby. |
|
Rollback |
Informace o vrácení zpět u neúspěšných instancí virtuálních počítačů po operaci upgradu operačního systému |
|
Rolling |
Informace o počtu instancí virtuálních počítačů v jednotlivých stavech upgradu |
|
Upgrade |
Odpověď operace historie upgradu operačního systému škálovací sady virtuálních počítačů |
|
Upgrade |
Popisuje každý upgrade operačního systému ve škálovací sadě virtuálních počítačů. |
|
Upgrade |
Informace o aktuálním spuštěném stavu celkového upgradu |
|
Upgrade |
Vyvolání operace upgradu |
|
Upgrade |
Kód označující aktuální stav aktualizace. |
|
Virtual |
Seznam odpovědí operace operace upgradu operačního systému škálovací sady virtuálních počítačů |
ApiError
Chyba rozhraní API
| Name | Typ | Description |
|---|---|---|
| code |
string |
Kód chyby. |
| details |
Podrobnosti o chybě rozhraní API |
|
| innererror |
Vnitřní chyba rozhraní API |
|
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl konkrétní chyby. |
ApiErrorBase
Základ chyb rozhraní API.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Kód chyby. |
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl konkrétní chyby. |
CloudError
Odpověď na chybu z výpočetní služby
| Name | Typ | Description |
|---|---|---|
| error |
Chyba rozhraní API |
ImageReference
Určuje informace o obrázku, který se má použít. Můžete zadat informace o imagích platformy, imagích marketplace nebo imagích virtuálních počítačů. Tento prvek se vyžaduje, pokud chcete použít image platformy, image marketplace nebo image virtuálního počítače, ale nepoužívá se v jiných operacích vytváření. POZNÁMKA: Odkaz na image a nabídka lze nastavit pouze při vytváření škálovací sady.
| Name | Typ | Description |
|---|---|---|
| communityGalleryImageId |
string |
Zadali jsme jedinečné ID image galerie komunity pro nasazení virtuálního počítače. To se dá načíst z volání GET galerie komunity. |
| exactVersion |
string |
Určuje desetinná čísla, verzi image platformy nebo image marketplace použitou k vytvoření virtuálního počítače. Toto pole jen pro čtení se liší od "verze", pouze pokud je hodnota zadaná v poli verze "latest". |
| id |
string |
ID prostředku |
| offer |
string |
Určuje nabídku image platformy nebo image marketplace použité k vytvoření virtuálního počítače. |
| publisher |
string |
Image publisher. |
| sharedGalleryImageId |
string |
Zadali jste jedinečné ID image sdílené galerie pro nasazení virtuálního počítače. To se dá načíst z volání GET sdíleného obrázku galerie. |
| sku |
string |
Skladová položka image. |
| version |
string |
Určuje verzi image platformy nebo image marketplace, která se používá k vytvoření virtuálního počítače. Povolené formáty jsou Major.Minor.Build nebo Latest. Hlavní, Vedlejší a Build jsou desetinná čísla. Zadejte nejnovější verzi image, která je k dispozici v době nasazení. I když použijete nejnovější verzi, image virtuálního počítače se po nasazení automaticky neaktualizuje, i když bude k dispozici nová verze. Nepoužívejte pole Verze pro nasazení imagí galerie, image galerie by pro nasazení měla vždy používat pole ID, pokud chcete použít nejnovější verzi image galerie, stačí nastavit /subscriptions/{subscriptionId}/resourceGroups/{resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName} v poli ID bez zadání verze. |
InnerError
Podrobnosti vnitřní chyby.
| Name | Typ | Description |
|---|---|---|
| errordetail |
string |
Vnitřní chybová zpráva nebo výpis výjimky. |
| exceptiontype |
string |
Typ výjimky. |
RollbackStatusInfo
Informace o vrácení zpět u neúspěšných instancí virtuálních počítačů po operaci upgradu operačního systému
| Name | Typ | Description |
|---|---|---|
| failedRolledbackInstanceCount |
integer (int32) |
Počet instancí, které se nepodařilo vrátit zpět |
| rollbackError |
Podrobnosti o chybě, pokud se vrácení operačního systému nezdařilo. |
|
| successfullyRolledbackInstanceCount |
integer (int32) |
Počet instancí, které byly úspěšně vráceny zpět. |
RollingUpgradeProgressInfo
Informace o počtu instancí virtuálních počítačů v jednotlivých stavech upgradu
| Name | Typ | Description |
|---|---|---|
| failedInstanceCount |
integer (int32) |
Počet instancí, které se nepodařilo úspěšně upgradovat. |
| inProgressInstanceCount |
integer (int32) |
Počet instancí, které se aktuálně upgradují. |
| pendingInstanceCount |
integer (int32) |
Počet instancí, které ještě nebyly upgradovány. |
| successfulInstanceCount |
integer (int32) |
Počet instancí, které byly úspěšně upgradovány. |
UpgradeOperationHistoricalStatusInfo
Odpověď operace historie upgradu operačního systému škálovací sady virtuálních počítačů
| Name | Typ | Description |
|---|---|---|
| location |
string |
Umístění prostředku |
| properties |
Informace o vlastnostech operace upgradu |
|
| type |
string |
Typ zdroje |
UpgradeOperationHistoricalStatusInfoProperties
Popisuje každý upgrade operačního systému ve škálovací sadě virtuálních počítačů.
| Name | Typ | Description |
|---|---|---|
| error |
Podrobnosti o chybě pro tento upgrade, pokud existují. |
|
| progress |
Počítá virtuální počítače v jednotlivých stavech. |
|
| rollbackInfo |
Informace o vrácení operačního systému, pokud je provedeno |
|
| runningStatus |
Informace o celkovém stavu operace upgradu |
|
| startedBy |
Vyvolání operace upgradu |
|
| targetImageReference |
Podrobnosti odkazu na obrázek |
UpgradeOperationHistoryStatus
Informace o aktuálním spuštěném stavu celkového upgradu
| Name | Typ | Description |
|---|---|---|
| code |
Kód označující aktuální stav aktualizace. |
|
| endTime |
string (date-time) |
Koncový čas upgradu. |
| startTime |
string (date-time) |
Čas zahájení upgradu |
UpgradeOperationInvoker
Vyvolání operace upgradu
| Hodnota | Description |
|---|---|
| Unknown | |
| User | |
| Platform |
UpgradeState
Kód označující aktuální stav aktualizace.
| Hodnota | Description |
|---|---|
| RollingForward | |
| RollingBack | |
| Cancelled | |
| Completed | |
| Faulted |
VirtualMachineScaleSetListOSUpgradeHistory
Seznam odpovědí operace operace upgradu operačního systému škálovací sady virtuálních počítačů
| Name | Typ | Description |
|---|---|---|
| nextLink |
string (uri) |
Identifikátor URI pro načtení další stránky historie upgradu operačního systému. Call ListNext() s tímto načte další stránku historie upgradů. |
| value |
Seznam upgradů operačního systému provedených ve škálovací sadě virtuálních počítačů. |