Freigeben über


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Ruft die status des neuesten parallelen Upgrades der VM-Skalierungsgruppe 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 der VM-Skalierungsgruppe.

api-version
query True

string

Client-API-Version.

Antworten

Name Typ Beschreibung
200 OK

RollingUpgradeStatusInfo

OK

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Details zu inneren Fehlern.

RollingUpgradeActionType

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

RollingUpgradePolicy

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

RollingUpgradeProgressInfo

Informationen zur Anzahl der VM-Instanzen in jedem Upgradestatus.

RollingUpgradeRunningStatus

Informationen zum aktuellen Ausführungsstatus des gesamten Upgrades.

RollingUpgradeStatusCode

Code, der die aktuelle status des Upgrades angibt.

RollingUpgradeStatusInfo

Die status des neuesten parallelen Upgrades der VM-Skalierungsgruppe.

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Details zu API-Fehlern

innererror

InnerError

Innerer 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

Details zu inneren Fehlern.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.

exceptiontype

string

Der Ausnahmetyp.

RollingUpgradeActionType

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

Name Typ Beschreibung
Cancel

string

Start

string

RollingUpgradePolicy

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

Name Typ Beschreibung
enableCrossZoneUpgrade

boolean

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

maxBatchInstancePercent

integer

Der maximale Prozentsatz der gesamten VM-Instanzen, die gleichzeitig durch das parallele Upgrade in einem Batch aktualisiert werden. Da dies ein Maximum ist, können fehlerhafte Instanzen in vorherigen oder zukünftigen Batches dazu führen, dass der Prozentsatz der Instanzen in einem Batch abnimmt, um eine höhere Zuverlässigkeit sicherzustellen. Der Standardwert für diesen Parameter ist 20 %.

maxSurge

boolean

Erstellen Sie neue virtuelle Computer, um die Skalierungsgruppe 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 gesamten VM-Instanzen in der Skalierungsgruppe, die gleichzeitig fehlerhaft sein können, entweder aufgrund eines Upgrades oder durch die Integritätsüberprüfungen des virtuellen Computers in einem fehlerhaften Zustand, bevor das parallele Upgrade abgebrochen wird. Diese Einschränkung wird überprüft, bevor ein Batch gestartet wird. Der Standardwert für diesen Parameter ist 20 %.

maxUnhealthyUpgradedInstancePercent

integer

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

pauseTimeBetweenBatches

string

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

prioritizeUnhealthyInstances

boolean

Führen Sie ein Upgrade aller fehlerhaften Instanzen in einer Skalierungsgruppe vor fehlerfreien Instanzen durch.

rollbackFailedInstancesOnPolicyBreach

boolean

Rollback fehlgeschlagener Instanzen auf das vorherige Modell, wenn die Richtlinie für das parallele Upgrade verletzt wird.

RollingUpgradeProgressInfo

Informationen zur Anzahl der VM-Instanzen 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 gerade 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 Ausführungsstatus des gesamten Upgrades.

Name Typ Beschreibung
code

RollingUpgradeStatusCode

Code, der die aktuelle status des Upgrades angibt.

lastAction

RollingUpgradeActionType

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

lastActionTime

string

Zeitpunkt der letzten Aktion des Upgrades.

startTime

string

Startzeit des Upgrades.

RollingUpgradeStatusCode

Code, der die aktuelle status des Upgrades angibt.

Name Typ Beschreibung
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

Die status des neuesten parallelen Upgrades der VM-Skalierungsgruppe.

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 parallelen Upgraderichtlinien.

properties.progress

RollingUpgradeProgressInfo

Informationen zur Anzahl der VM-Instanzen in jedem Upgradestatus.

properties.runningStatus

RollingUpgradeRunningStatus

Informationen zum aktuellen Ausführungsstatus des gesamten Upgrades.

tags

object

Ressourcentags

type

string

Ressourcentyp