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=2024-03-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Název skupiny prostředků. |
subscription
|
path | True |
string |
Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby. |
vm
|
path | True |
string |
Název škálovací sady virtuálních počítačů. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
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=2024-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": "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=2024-03-01
Ukázková odpověď
{
"value": [
{}
]
}
Definice
Name | Description |
---|---|
Api |
Chyba rozhraní API |
Api |
Základ chyb rozhraní API. |
Cloud |
Chybová odpověď ze služby Compute. |
Image |
Určuje informace o obrázku, který se má použít. Můžete zadat informace o imagích platforem, imagích marketplace nebo imagích virtuálních počítačů. Tento prvek se vyžaduje, pokud chcete použít image platformy, image z Marketplace nebo image virtuálního počítače, ale nepoužívá se v jiných operacích vytváření. POZNÁMKA: Vydavatele a nabídku odkazu na image lze nastavit pouze při vytváření škálovací sady. |
Inner |
Podrobnosti o vnitřní chybě. |
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 stavu spuštění celkového upgradu. |
Upgrade |
Vyvolání operace upgradu |
Upgrade |
Kód označující aktuální stav upgradu. |
Virtual |
Seznam odezvy operace historie upgradu operačního systému ve škálovací sadě 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
Chybová odpověď ze služby Compute.
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 platforem, imagích marketplace nebo imagích virtuálních počítačů. Tento prvek se vyžaduje, pokud chcete použít image platformy, image z Marketplace nebo image virtuálního počítače, ale nepoužívá se v jiných operacích vytváření. POZNÁMKA: Vydavatele a nabídku odkazu na image lze nastavit pouze při vytváření škálovací sady.
Name | Typ | Description |
---|---|---|
communityGalleryImageId |
string |
Zadali jste jedinečné ID image galerie komunity pro nasazení virtuálního počítače. Můžete ho načíst z obrázku GET v galerii komunity. |
exactVersion |
string |
Určuje v desetinných číslech verzi image platformy nebo image z Marketplace, která se použije k vytvoření virtuálního počítače. Toto pole jen pro čtení se liší od pole version pouze v případě, že hodnota zadaná v poli version je "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 |
Vydavatel image. |
sharedGalleryImageId |
string |
Zadali jste jedinečné ID image sdílené galerie pro nasazení virtuálního počítače. Můžete ho načíst ze sdílené galerie image volání GET. |
sku |
string |
SKU image. |
version |
string |
Určuje verzi image platformy nebo image z Marketplace, která se použije k vytvoření virtuálního počítače. Povolené formáty jsou Major.Minor.Build nebo "latest". Hlavní číslo, Podverze a Sestavení jsou desetinná čísla. Pokud chcete použít nejnovější verzi image dostupnou v době nasazení, zadejte nejnovější verzi. 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 version pro nasazení image galerie, image galerie by měla vždy používat pole id pro nasazení. Pokud chcete použít nejnovější verzi image galerie, stačí v poli id nastavit /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}v poli id bez zadání verze. |
InnerError
Podrobnosti o vnitřní chybě.
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 |
Počet instancí, které se nepodařilo vrátit zpět. |
rollbackError |
Podrobnosti o chybě v případě selhání vrácení zpět operačního systému |
|
successfullyRolledbackInstanceCount |
integer |
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 |
Počet instancí, které se nepodařilo úspěšně upgradovat. |
inProgressInstanceCount |
integer |
Počet instancí, které se právě upgradují. |
pendingInstanceCount |
integer |
Počet instancí, které ještě nezačalo být upgradovány. |
successfulInstanceCount |
integer |
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 prostředku |
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čty virtuálních počítačů v každém stavu |
|
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 reference k obrázku |
UpgradeOperationHistoryStatus
Informace o aktuálním stavu spuštění celkového upgradu.
Name | Typ | Description |
---|---|---|
code |
Kód označující aktuální stav upgradu. |
|
endTime |
string |
Čas ukončení upgradu. |
startTime |
string |
Čas zahájení upgradu. |
UpgradeOperationInvoker
Vyvolání operace upgradu
Name | Typ | Description |
---|---|---|
Platform |
string |
|
Unknown |
string |
|
User |
string |
UpgradeState
Kód označující aktuální stav upgradu.
Name | Typ | Description |
---|---|---|
Cancelled |
string |
|
Completed |
string |
|
Faulted |
string |
|
RollingForward |
string |
VirtualMachineScaleSetListOSUpgradeHistory
Seznam odezvy operace historie upgradu operačního systému ve škálovací sadě virtuálních počítačů
Name | Typ | Description |
---|---|---|
nextLink |
string |
Identifikátor URI pro načtení další stránky historie upgradu operačního systému Volejte metodu ListNext() s tímto příkazem a načtě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čů |