Freigeben über


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Ruft den Status des neuesten skalierungsset-Rollupgrades für virtuelle Computer ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

vmScaleSetName
path True

string

Der Name des VM-Skalierungssatzes.

api-version
query True

string

Client-API-Version.

Antworten

Name Typ Beschreibung
200 OK

RollingUpgradeStatusInfo

OKAY

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Beispielanforderung

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

Beispiel für eine Antwort

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

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

CloudError

Eine Fehlerantwort des Computediensts.

InnerError

Innere Fehlerdetails.

RollingUpgradeActionType

Die letzte Aktion, die für das rollierende Upgrade ausgeführt wurde.

RollingUpgradePolicy

Die Konfigurationsparameter, die beim Ausführen eines rollierenden Upgrades verwendet werden.

RollingUpgradeProgressInfo

Informationen zur Anzahl der Instanzen des virtuellen Computers in jedem Upgradestatus.

RollingUpgradeRunningStatus

Informationen zum aktuellen Ausgeführten Status des gesamtupgrades.

RollingUpgradeStatusCode

Code, der den aktuellen Status des Upgrades angibt.

RollingUpgradeStatusInfo

Der Status des neuesten Rollupgrades für virtuelle Computer.

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Die API-Fehlerdetails

innererror

InnerError

Interner API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

CloudError

Eine Fehlerantwort des Computediensts.

Name Typ Beschreibung
error

ApiError

API-Fehler.

InnerError

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.

exceptiontype

string

Der Ausnahmetyp.

RollingUpgradeActionType

Die letzte Aktion, die für das rollierende Upgrade ausgeführt wurde.

Name Typ Beschreibung
Cancel

string

Start

string

RollingUpgradePolicy

Die Konfigurationsparameter, die beim Ausführen eines rollierenden Upgrades verwendet werden.

Name Typ Beschreibung
enableCrossZoneUpgrade

boolean

Zulassen, dass VMSS AZ-Grenzen beim Erstellen von Upgradebatches ignoriert. Berücksichtigen Sie die Updatedomäne und maxBatchInstancePercent, um die Batchgröße zu ermitteln.

maxBatchInstancePercent

integer

Der maximale Prozentsatz der gesamten Instanzen des virtuellen Computers, die gleichzeitig durch das rollierende Upgrade in einem Batch aktualisiert werden. Da dies ein Maximum ist, können fehlerhafte Instanzen in früheren oder zukünftigen Batches dazu führen, dass der Prozentsatz der Instanzen in einem Batch verringert wird, um eine höhere Zuverlässigkeit sicherzustellen. Der Standardwert für diesen Parameter ist 20%.

maxSurge

boolean

Erstellen Sie neue virtuelle Computer, um den Skalierungssatz zu aktualisieren, anstatt die vorhandenen virtuellen Computer zu aktualisieren. Vorhandene virtuelle Computer werden gelöscht, sobald die neuen virtuellen Computer für jeden Batch erstellt wurden.

maxUnhealthyInstancePercent

integer

Der maximale Prozentsatz der Instanzen des virtuellen Computers im Skalierungssatz, der gleichzeitig fehlerhaft sein kann, entweder aufgrund eines Upgrades oder durch die Integritätsprüfungen des virtuellen Computers in einem fehlerhaften Zustand gefunden wird, bevor das Rollupgrade abgebrochen wird. Diese Einschränkung wird vor dem Starten eines Batches überprüft. Der Standardwert für diesen Parameter ist 20%.

maxUnhealthyUpgradedInstancePercent

integer

Der maximale Prozentsatz der aktualisierten Virtuellen Computerinstanzen, die sich in einem fehlerhaften Zustand befinden. Diese Überprüfung erfolgt, nachdem jeder Batch aktualisiert wurde. Wenn dieser Prozentsatz jemals überschritten wird, wird das rollierende Update abgebrochen. Der Standardwert für diesen Parameter ist 20%.

pauseTimeBetweenBatches

string

Die Wartezeit zwischen Abschluss des Updates für alle virtuellen Computer in einem Batch und starten den nächsten Batch. Die Zeitdauer sollte im ISO 8601-Format angegeben werden. Der Standardwert ist 0 Sekunden (PT0S).

prioritizeUnhealthyInstances

boolean

Aktualisieren Sie alle fehlerhaften Instanzen in einem Skalierungssatz, bevor alle fehlerfreien Instanzen auftreten.

rollbackFailedInstancesOnPolicyBreach

boolean

Fehler bei Rollbackinstanzen beim vorherigen Modell, wenn die Richtlinie für das Rollupgrade verletzt wird.

RollingUpgradeProgressInfo

Informationen zur Anzahl der Instanzen des virtuellen Computers in jedem Upgradestatus.

Name Typ Beschreibung
failedInstanceCount

integer

Die Anzahl der Instanzen, die nicht erfolgreich aktualisiert werden konnten.

inProgressInstanceCount

integer

Die Anzahl der Instanzen, die derzeit aktualisiert werden.

pendingInstanceCount

integer

Die Anzahl der Instanzen, die noch nicht mit dem Upgrade begonnen haben.

successfulInstanceCount

integer

Die Anzahl der Instanzen, die erfolgreich aktualisiert wurden.

RollingUpgradeRunningStatus

Informationen zum aktuellen Ausgeführten Status des gesamtupgrades.

Name Typ Beschreibung
code

RollingUpgradeStatusCode

Code, der den aktuellen Status des Upgrades angibt.

lastAction

RollingUpgradeActionType

Die letzte Aktion, die für das rollierende Upgrade ausgeführt wurde.

lastActionTime

string

Zeitpunkt der letzten Aktion des Upgrades.

startTime

string

Startzeit des Upgrades.

RollingUpgradeStatusCode

Code, der den aktuellen Status des Upgrades angibt.

Name Typ Beschreibung
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

Der Status des neuesten Rollupgrades für virtuelle Computer.

Name Typ Beschreibung
id

string

Ressourcen-ID

location

string

Ressourcenspeicherort

name

string

Ressourcenname

properties.error

ApiError

Fehlerdetails für dieses Upgrade, falls vorhanden.

properties.policy

RollingUpgradePolicy

Die für dieses Upgrade angewendeten Rollupgraderichtlinien.

properties.progress

RollingUpgradeProgressInfo

Informationen zur Anzahl der Instanzen des virtuellen Computers in jedem Upgradestatus.

properties.runningStatus

RollingUpgradeRunningStatus

Informationen zum aktuellen Ausgeführten Status des gesamtupgrades.

tags

object

Ressourcentags

type

string

Ressourcentyp