Condividi tramite


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Ottiene lo stato dell'aggiornamento in sequenza del set di scalabilità di macchine virtuali più recente.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/rollingUpgrades/latest?api-version=2024-07-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 al servizio.

vmScaleSetName
path True

string

Nome del set di scalabilità di macchine virtuali.

api-version
query True

string

Versione dell'API client.

Risposte

Nome Tipo Descrizione
200 OK

RollingUpgradeStatusInfo

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

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Esempio di richiesta

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaa/rollingUpgrades/latest?api-version=2024-07-01

Risposta di esempio

{
  "properties": {
    "policy": {
      "maxBatchInstancePercent": 49,
      "maxUnhealthyInstancePercent": 81,
      "maxUnhealthyUpgradedInstancePercent": 98,
      "pauseTimeBetweenBatches": "aaaaaaaaaaaaaaa",
      "enableCrossZoneUpgrade": true,
      "prioritizeUnhealthyInstances": true,
      "rollbackFailedInstancesOnPolicyBreach": true,
      "maxSurge": true
    },
    "runningStatus": {
      "code": "RollingForward",
      "startTime": "2021-11-30T13:06:23.362Z",
      "lastAction": "Start",
      "lastActionTime": "2021-11-30T13:06:23.362Z"
    },
    "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"
    }
  },
  "id": "aaaaaaaaaa",
  "name": "aaaaaaaaaaaaaaaaaaa",
  "type": "aaaaaaaaaaaaaaaaaaaaa",
  "location": "aaaaaa",
  "tags": {
    "key8533": "aaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

Esempio di richiesta

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaa/rollingUpgrades/latest?api-version=2024-07-01

Risposta di esempio

{
  "location": "aaaaaa",
  "id": "aaaaaaaaaa"
}

Definizioni

Nome Descrizione
ApiError

Errore dell'API.

ApiErrorBase

Base degli errori api.

CloudError

Risposta di errore dal servizio di calcolo.

InnerError

Dettagli dell'errore interno.

RollingUpgradeActionType

Ultima azione eseguita sull'aggiornamento in sequenza.

RollingUpgradePolicy

Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.

RollingUpgradeProgressInfo

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

RollingUpgradeRunningStatus

Informazioni sullo stato di esecuzione corrente dell'aggiornamento complessivo.

RollingUpgradeStatusCode

Codice che indica lo stato corrente dell'aggiornamento.

RollingUpgradeStatusInfo

Stato dell'aggiornamento in sequenza più recente 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.

InnerError

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump delle eccezioni.

exceptiontype

string

Tipo di eccezione.

RollingUpgradeActionType

Ultima azione eseguita sull'aggiornamento in sequenza.

Nome Tipo Descrizione
Cancel

string

Start

string

RollingUpgradePolicy

Parametri di configurazione usati durante l'esecuzione di un aggiornamento in sequenza.

Nome Tipo Descrizione
enableCrossZoneUpgrade

boolean

Consentire al set di scalabilità di macchine virtuali di ignorare i limiti az durante la creazione di batch di aggiornamento. Prendere in considerazione il dominio di aggiornamento e maxBatchInstancePercent per determinare le dimensioni del batch.

maxBatchInstancePercent

integer

Percentuale massima delle istanze totali di macchine virtuali che verranno aggiornate contemporaneamente dall'aggiornamento in sequenza in un unico batch. Poiché si tratta di un valore massimo, le istanze non integre nei batch precedenti o futuri possono causare la diminuzione della percentuale di istanze in un batch per garantire una maggiore affidabilità. Il valore predefinito per questo parametro è 20%.

maxSurge

boolean

Creare nuove macchine virtuali per aggiornare il set di scalabilità anziché aggiornare le macchine virtuali esistenti. Le macchine virtuali esistenti verranno eliminate dopo la creazione delle nuove macchine virtuali per ogni batch.

maxUnhealthyInstancePercent

integer

Percentuale massima delle istanze totali della macchina virtuale nel set di scalabilità che possono essere contemporaneamente non integre, in seguito all'aggiornamento o rilevate in uno stato non integro dai controlli di integrità della macchina virtuale prima dell'interruzione dell'aggiornamento in sequenza. Questo vincolo verrà controllato prima di avviare qualsiasi batch. Il valore predefinito per questo parametro è 20%.

maxUnhealthyUpgradedInstancePercent

integer

Percentuale massima di istanze di macchina virtuale aggiornate che possono essere trovate in uno stato non integro. Questo controllo verrà eseguito dopo l'aggiornamento di ogni batch. Se questa percentuale viene mai superata, l'aggiornamento in sequenza viene interrotto. Il valore predefinito per questo parametro è 20%.

pauseTimeBetweenBatches

string

Tempo di attesa tra il completamento dell'aggiornamento per tutte le macchine virtuali in un batch e l'avvio del batch successivo. La durata dell'ora deve essere specificata nel formato ISO 8601. Il valore predefinito è 0 secondi (PT0S).

prioritizeUnhealthyInstances

boolean

Aggiornare tutte le istanze non integre in un set di scalabilità prima di qualsiasi istanza integra.

rollbackFailedInstancesOnPolicyBreach

boolean

Il rollback delle istanze non riuscite nel modello precedente se i criteri di aggiornamento in sequenza vengono violati.

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 corso di aggiornamento.

pendingInstanceCount

integer

Numero di istanze che non sono ancora state aggiornate.

successfulInstanceCount

integer

Numero di istanze che sono state aggiornate correttamente.

RollingUpgradeRunningStatus

Informazioni sullo stato di esecuzione corrente dell'aggiornamento complessivo.

Nome Tipo Descrizione
code

RollingUpgradeStatusCode

Codice che indica lo stato corrente dell'aggiornamento.

lastAction

RollingUpgradeActionType

Ultima azione eseguita sull'aggiornamento in sequenza.

lastActionTime

string

Ora dell'ultima azione dell'aggiornamento.

startTime

string

Ora di inizio dell'aggiornamento.

RollingUpgradeStatusCode

Codice che indica lo stato corrente dell'aggiornamento.

Nome Tipo Descrizione
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

Stato dell'aggiornamento in sequenza più recente del set di scalabilità di macchine virtuali.

Nome Tipo Descrizione
id

string

ID risorsa

location

string

Percorso risorsa

name

string

Nome risorsa

properties.error

ApiError

Dettagli dell'errore per questo aggiornamento, se presenti.

properties.policy

RollingUpgradePolicy

Criteri di aggiornamento in sequenza applicati per questo aggiornamento.

properties.progress

RollingUpgradeProgressInfo

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

properties.runningStatus

RollingUpgradeRunningStatus

Informazioni sullo stato di esecuzione corrente dell'aggiornamento complessivo.

tags

object

Tag delle risorse

type

string

Tipo di risorsa