Sdílet prostřednictvím


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
resourceGroupName
path True

string

Název skupiny prostředků.

subscriptionId
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.

vmScaleSetName
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

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

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

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

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
ApiError

Chyba rozhraní API

ApiErrorBase

Základ chyb rozhraní API.

CloudError

Chybová odpověď ze služby Compute.

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.

InnerError

Podrobnosti o vnitřní chybě.

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

RollingUpgradeProgressInfo

Informace o počtu instancí virtuálních počítačů v jednotlivých stavech upgradu

UpgradeOperationHistoricalStatusInfo

Odpověď operace historie upgradu operačního systému škálovací sady virtuálních počítačů

UpgradeOperationHistoricalStatusInfoProperties

Popisuje každý upgrade operačního systému ve škálovací sadě virtuálních počítačů.

UpgradeOperationHistoryStatus

Informace o aktuálním stavu spuštění celkového upgradu.

UpgradeOperationInvoker

Vyvolání operace upgradu

UpgradeState

Kód označující aktuální stav upgradu.

VirtualMachineScaleSetListOSUpgradeHistory

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

ApiErrorBase[]

Podrobnosti o chybě rozhraní API

innererror

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

ApiError

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

ApiError

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

UpgradeOperationHistoricalStatusInfoProperties

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

ApiError

Podrobnosti o chybě pro tento upgrade, pokud existují.

progress

RollingUpgradeProgressInfo

Počty virtuálních počítačů v každém stavu

rollbackInfo

RollbackStatusInfo

Informace o vrácení operačního systému, pokud je provedeno

runningStatus

UpgradeOperationHistoryStatus

Informace o celkovém stavu operace upgradu

startedBy

UpgradeOperationInvoker

Vyvolání operace upgradu

targetImageReference

ImageReference

Podrobnosti reference k obrázku

UpgradeOperationHistoryStatus

Informace o aktuálním stavu spuštění celkového upgradu.

Name Typ Description
code

UpgradeState

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

UpgradeOperationHistoricalStatusInfo[]

Seznam upgradů operačního systému provedených ve škálovací sadě virtuálních počítačů