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-07-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
vm
|
path | True |
string |
Der Name des VM-Skalierungssatzes. |
api-version
|
query | True |
string |
Client-API-Version. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OKAY |
|
Other Status Codes |
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
Virtual |
Virtual |
VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
Beispielanforderung
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
Beispiel für eine Antwort
{
"location": "aaaaaa",
"id": "aaaaaaaaaa"
}
Definitionen
Name | Beschreibung |
---|---|
Api |
API-Fehler. |
Api |
API-Fehlerbasis. |
Cloud |
Eine Fehlerantwort des Computediensts. |
Inner |
Innere Fehlerdetails. |
Rolling |
Die letzte Aktion, die für das rollierende Upgrade ausgeführt wurde. |
Rolling |
Die Konfigurationsparameter, die beim Ausführen eines rollierenden Upgrades verwendet werden. |
Rolling |
Informationen zur Anzahl der Instanzen des virtuellen Computers in jedem Upgradestatus. |
Rolling |
Informationen zum aktuellen Ausgeführten Status des gesamtupgrades. |
Rolling |
Code, der den aktuellen Status des Upgrades angibt. |
Rolling |
Der Status des neuesten Rollupgrades für virtuelle Computer. |
ApiError
API-Fehler.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Fehlercode. |
details |
Die API-Fehlerdetails |
|
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 |
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.
Wert | Beschreibung |
---|---|
Cancel | |
Start |
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 (int32) minimum: 5maximum: 100 |
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 (int32) minimum: 5maximum: 100 |
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 (int32) minimum: 0maximum: 100 |
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 (int32) |
Die Anzahl der Instanzen, die nicht erfolgreich aktualisiert werden konnten. |
inProgressInstanceCount |
integer (int32) |
Die Anzahl der Instanzen, die derzeit aktualisiert werden. |
pendingInstanceCount |
integer (int32) |
Die Anzahl der Instanzen, die noch nicht mit dem Upgrade begonnen haben. |
successfulInstanceCount |
integer (int32) |
Die Anzahl der Instanzen, die erfolgreich aktualisiert wurden. |
RollingUpgradeRunningStatus
Informationen zum aktuellen Ausgeführten Status des gesamtupgrades.
Name | Typ | Beschreibung |
---|---|---|
code |
Code, der den aktuellen Status des Upgrades angibt. |
|
lastAction |
Die letzte Aktion, die für das rollierende Upgrade ausgeführt wurde. |
|
lastActionTime |
string (date-time) |
Zeitpunkt der letzten Aktion des Upgrades. |
startTime |
string (date-time) |
Startzeit des Upgrades. |
RollingUpgradeStatusCode
Code, der den aktuellen Status des Upgrades angibt.
Wert | Beschreibung |
---|---|
Cancelled | |
Completed | |
Faulted | |
RollingForward |
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 |
Fehlerdetails für dieses Upgrade, falls vorhanden. |
|
properties.policy |
Die für dieses Upgrade angewendeten Rollupgraderichtlinien. |
|
properties.progress |
Informationen zur Anzahl der Instanzen des virtuellen Computers in jedem Upgradestatus. |
|
properties.runningStatus |
Informationen zum aktuellen Ausgeführten Status des gesamtupgrades. |
|
tags |
object |
Ressourcentags |
type |
string |
Ressourcentyp |