Dela via


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Hämtar status för den senaste löpande uppgraderingen av vm-skalningsuppsättningen.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen.

subscriptionId
path True

string

Prenumerationsautentiseringsuppgifter som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

vmScaleSetName
path True

string

Namnet på VM-skalningsuppsättningen.

api-version
query True

string

Klient-API-version.

Svar

Name Typ Description
200 OK

RollingUpgradeStatusInfo

OKEJ

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
ApiError

Api-fel.

ApiErrorBase

Api-felbas.

CloudError

Ett felsvar från Compute-tjänsten.

InnerError

Inre felinformation.

RollingUpgradeActionType

Den senaste åtgärden som utfördes vid den löpande uppgraderingen.

RollingUpgradePolicy

De konfigurationsparametrar som används vid löpande uppgradering.

RollingUpgradeProgressInfo

Information om antalet virtuella datorinstanser i varje uppgraderingstillstånd.

RollingUpgradeRunningStatus

Information om aktuellt körningstillstånd för den övergripande uppgraderingen.

RollingUpgradeStatusCode

Kod som anger uppgraderingens aktuella status.

RollingUpgradeStatusInfo

Status för den senaste löpande uppgraderingen av vm-skalningsuppsättningen.

ApiError

Api-fel.

Name Typ Description
code

string

Felkoden.

details

ApiErrorBase[]

Api-felinformationen

innererror

InnerError

Api:ets inre fel

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

ApiErrorBase

Api-felbas.

Name Typ Description
code

string

Felkoden.

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

CloudError

Ett felsvar från Compute-tjänsten.

Name Typ Description
error

ApiError

Api-fel.

InnerError

Inre felinformation.

Name Typ Description
errordetail

string

Det interna felmeddelandet eller undantagsdumpen.

exceptiontype

string

Undantagstypen.

RollingUpgradeActionType

Den senaste åtgärden som utfördes vid den löpande uppgraderingen.

Name Typ Description
Cancel

string

Start

string

RollingUpgradePolicy

De konfigurationsparametrar som används vid löpande uppgradering.

Name Typ Description
enableCrossZoneUpgrade

boolean

Tillåt ATT VMSS ignorerar AZ-gränser när du skapar uppgraderingsbatch. Ta hänsyn till uppdateringsdomänen och maxBatchInstancePercent för att fastställa batchstorleken.

maxBatchInstancePercent

integer

Den maximala procentandelen av de totala virtuella datorinstanserna som uppgraderas samtidigt av den löpande uppgraderingen i en batch. Eftersom detta är ett maximalt antal felaktiga instanser i tidigare eller framtida batchar kan procentandelen instanser i en batch minska för att säkerställa högre tillförlitlighet. Standardvärdet för den här parametern är 20%.

maxSurge

boolean

Skapa nya virtuella datorer för att uppgradera skalningsuppsättningen i stället för att uppdatera de befintliga virtuella datorerna. Befintliga virtuella datorer tas bort när de nya virtuella datorerna har skapats för varje batch.

maxUnhealthyInstancePercent

integer

Den maximala procentandelen av de totala virtuella datorinstanserna i skalningsuppsättningen som kan vara felfritt samtidigt, antingen till följd av uppgraderingen eller genom att hittas i ett feltillstånd av hälsokontrollerna för den virtuella datorn innan den löpande uppgraderingen avbryts. Den här begränsningen kontrolleras innan någon batch startas. Standardvärdet för den här parametern är 20%.

maxUnhealthyUpgradedInstancePercent

integer

Den maximala procentandelen uppgraderade virtuella datorinstanser som kan konstateras vara i ett feltillstånd. Den här kontrollen sker när varje batch har uppgraderats. Om den här procentandelen någonsin överskrids avbryts den löpande uppdateringen. Standardvärdet för den här parametern är 20%.

pauseTimeBetweenBatches

string

Väntetiden mellan att slutföra uppdateringen för alla virtuella datorer i en batch och starta nästa batch. Varaktigheten ska anges i ISO 8601-format. Standardvärdet är 0 sekunder (PT0S).

prioritizeUnhealthyInstances

boolean

Uppgradera alla instanser med feltillstånd i en skalningsuppsättning före eventuella felfria instanser.

rollbackFailedInstancesOnPolicyBreach

boolean

Återställningen misslyckades för instanser till en tidigare modell om principen för löpande uppgradering överträds.

RollingUpgradeProgressInfo

Information om antalet virtuella datorinstanser i varje uppgraderingstillstånd.

Name Typ Description
failedInstanceCount

integer

Antalet instanser som inte har uppgraderats.

inProgressInstanceCount

integer

Antalet instanser som för närvarande uppgraderas.

pendingInstanceCount

integer

Antalet instanser som ännu inte har börjat uppgraderas.

successfulInstanceCount

integer

Antalet instanser som har uppgraderats.

RollingUpgradeRunningStatus

Information om aktuellt körningstillstånd för den övergripande uppgraderingen.

Name Typ Description
code

RollingUpgradeStatusCode

Kod som anger uppgraderingens aktuella status.

lastAction

RollingUpgradeActionType

Den senaste åtgärden som utfördes vid den löpande uppgraderingen.

lastActionTime

string

Senaste åtgärdstid för uppgraderingen.

startTime

string

Starttid för uppgraderingen.

RollingUpgradeStatusCode

Kod som anger uppgraderingens aktuella status.

Name Typ Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

Status för den senaste löpande uppgraderingen av vm-skalningsuppsättningen.

Name Typ Description
id

string

Resurs-ID

location

string

Resursplats

name

string

Resursnamn

properties.error

ApiError

Felinformation för den här uppgraderingen, om det finns några.

properties.policy

RollingUpgradePolicy

De principer för löpande uppgradering som tillämpas för den här uppgraderingen.

properties.progress

RollingUpgradeProgressInfo

Information om antalet virtuella datorinstanser i varje uppgraderingstillstånd.

properties.runningStatus

RollingUpgradeRunningStatus

Information om aktuellt körningstillstånd för den övergripande uppgraderingen.

tags

object

Resurstaggar

type

string

Resurstyp