Share via


Virtual Machine Scale Sets - Get OS Upgrade History

Ottiene l'elenco degli aggiornamenti del sistema operativo in un'istanza del set di scalabilità di macchine virtuali.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2024-03-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
path True

string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

vmScaleSetName
path True

string

Nome del set di scalabilità di macchine virtuali.

api-version
query True

string

Versione api client.

Risposte

Nome Tipo Descrizione
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2024-03-01

Sample Response

{
  "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

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2024-03-01

Sample Response

{
  "value": [
    {}
  ]
}

Definizioni

Nome Descrizione
ApiError

Errore dell'API.

ApiErrorBase

Base degli errori api.

CloudError

Risposta di errore dal servizio di calcolo.

ImageReference

Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione. NOTA: l'autore e l'offerta di riferimento alle immagini possono essere impostati solo quando si crea il set di scalabilità.

InnerError

Dettagli dell'errore interno.

RollbackStatusInfo

Informazioni sul rollback nelle istanze di macchina virtuale non riuscite dopo un'operazione di aggiornamento del sistema operativo.

RollingUpgradeProgressInfo

Informazioni sul numero di istanze di macchina virtuale in ogni stato di aggiornamento.

UpgradeOperationHistoricalStatusInfo

Risposta dell'operazione cronologia aggiornamento del set di scalabilità di macchine virtuali.

UpgradeOperationHistoricalStatusInfoProperties

Descrive ogni aggiornamento del sistema operativo nel set di scalabilità di macchine virtuali.

UpgradeOperationHistoryStatus

Informazioni sullo stato di esecuzione corrente dell'aggiornamento complessivo.

UpgradeOperationInvoker

Invoker dell'operazione di aggiornamento

UpgradeState

Codice che indica lo stato corrente dell'aggiornamento.

VirtualMachineScaleSetListOSUpgradeHistory

Elenco della risposta dell'operazione cronologia aggiornamento del sistema operativo del set di scalabilità di macchine virtuali.

ApiError

Errore dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

details

ApiErrorBase[]

Dettagli dell'errore dell'API

innererror

InnerError

Errore interno dell'API

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

CloudError

Risposta di errore dal servizio di calcolo.

Nome Tipo Descrizione
error

ApiError

Errore dell'API.

ImageReference

Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione. NOTA: l'autore e l'offerta di riferimento alle immagini possono essere impostati solo quando si crea il set di scalabilità.

Nome Tipo Descrizione
communityGalleryImageId

string

Specifica l'ID univoco dell'immagine della raccolta della community per la distribuzione di macchine virtuali. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta della community.

exactVersion

string

Specifica i numeri decimali, la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. Questo campo di sola lettura è diverso da 'version', solo se il valore specificato nel campo 'version' è 'latest'.

id

string

ID risorsa

offer

string

Specifica l'offerta dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale.

publisher

string

Autore dell'immagine.

sharedGalleryImageId

string

Specifica l'ID univoco dell'immagine della raccolta condivisa per la distribuzione della macchina virtuale. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta condivisa.

sku

string

SKU dell'immagine.

version

string

Specifica la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. I formati consentiti sono Major.Minor.Build o 'latest'. Major, Minor e Build sono numeri decimali. Specificare "latest" per usare la versione più recente di un'immagine disponibile in fase di distribuzione. Anche se si usa 'latest', l'immagine della macchina virtuale non verrà aggiornata automaticamente dopo la distribuzione anche se una nuova versione diventa disponibile. Non usare il campo 'version' per la distribuzione di immagini della raccolta, l'immagine della raccolta deve sempre usare il campo 'id' per la distribuzione, per usare la versione più recente dell'immagine della raccolta, è sufficiente impostare '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' nel campo 'id' senza input della versione.

InnerError

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump delle eccezioni.

exceptiontype

string

Tipo di eccezione.

RollbackStatusInfo

Informazioni sul rollback nelle istanze di macchina virtuale non riuscite dopo un'operazione di aggiornamento del sistema operativo.

Nome Tipo Descrizione
failedRolledbackInstanceCount

integer

Numero di istanze di cui non è stato possibile eseguire il rollback.

rollbackError

ApiError

Dettagli errore se il rollback del sistema operativo non è riuscito.

successfullyRolledbackInstanceCount

integer

Numero di istanze di cui è stato eseguito il rollback.

RollingUpgradeProgressInfo

Informazioni sul numero di istanze di macchina virtuale in ogni stato di aggiornamento.

Nome Tipo Descrizione
failedInstanceCount

integer

Numero di istanze che non sono state aggiornate correttamente.

inProgressInstanceCount

integer

Numero di istanze attualmente in fase di aggiornamento.

pendingInstanceCount

integer

Numero di istanze che non sono ancora state aggiornate.

successfulInstanceCount

integer

Numero di istanze aggiornate correttamente.

UpgradeOperationHistoricalStatusInfo

Risposta dell'operazione cronologia aggiornamento del set di scalabilità di macchine virtuali.

Nome Tipo Descrizione
location

string

Posizione risorsa

properties

UpgradeOperationHistoricalStatusInfoProperties

Informazioni sulle proprietà dell'operazione di aggiornamento.

type

string

Tipo di risorsa

UpgradeOperationHistoricalStatusInfoProperties

Descrive ogni aggiornamento del sistema operativo nel set di scalabilità di macchine virtuali.

Nome Tipo Descrizione
error

ApiError

Dettagli errore per questo aggiornamento, se presenti.

progress

RollingUpgradeProgressInfo

Conteggio delle macchine virtuali in ogni stato.

rollbackInfo

RollbackStatusInfo

Informazioni sul rollback del sistema operativo se eseguito

runningStatus

UpgradeOperationHistoryStatus

Informazioni sullo stato complessivo dell'operazione di aggiornamento.

startedBy

UpgradeOperationInvoker

Invoker dell'operazione di aggiornamento

targetImageReference

ImageReference

Dettagli di riferimento sulle immagini

UpgradeOperationHistoryStatus

Informazioni sullo stato di esecuzione corrente dell'aggiornamento complessivo.

Nome Tipo Descrizione
code

UpgradeState

Codice che indica lo stato corrente dell'aggiornamento.

endTime

string

Ora di fine dell'aggiornamento.

startTime

string

Ora di inizio dell'aggiornamento.

UpgradeOperationInvoker

Invoker dell'operazione di aggiornamento

Nome Tipo Descrizione
Platform

string

Unknown

string

User

string

UpgradeState

Codice che indica lo stato corrente dell'aggiornamento.

Nome Tipo Descrizione
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Elenco della risposta dell'operazione cronologia aggiornamento del sistema operativo del set di scalabilità di macchine virtuali.

Nome Tipo Descrizione
nextLink

string

URI per recuperare la pagina successiva della cronologia di aggiornamento del sistema operativo. Chiamare ListNext() per recuperare la pagina successiva della cronologia degli aggiornamenti.

value

UpgradeOperationHistoricalStatusInfo[]

Elenco degli aggiornamenti del sistema operativo eseguiti nel set di scalabilità di macchine virtuali.