Delen via


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Hiermee haalt u de status op van de meest recente rolling upgrade van de virtuele-machineschaalset.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

vmScaleSetName
path True

string

De naam van de VM-schaalset.

api-version
query True

string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

RollingUpgradeStatusInfo

OK

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ApiError

Api-fout.

ApiErrorBase

Api-foutbasis.

CloudError

Een foutreactie van de Compute-service.

InnerError

Interne foutdetails.

RollingUpgradeActionType

De laatste actie die is uitgevoerd op de rolling upgrade.

RollingUpgradePolicy

De configuratieparameters die worden gebruikt tijdens het uitvoeren van een rolling upgrade.

RollingUpgradeProgressInfo

Informatie over het aantal exemplaren van virtuele machines in elke upgradestatus.

RollingUpgradeRunningStatus

Informatie over de huidige status van de algehele upgrade.

RollingUpgradeStatusCode

Code die de huidige status van de upgrade aangeeft.

RollingUpgradeStatusInfo

De status van de nieuwste rolling upgrade van de virtuele-machineschaalset.

ApiError

Api-fout.

Name Type Description
code

string

De foutcode.

details

ApiErrorBase[]

Details van de API-fout

innererror

InnerError

De interne API-fout

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

ApiErrorBase

Api-foutbasis.

Name Type Description
code

string

De foutcode.

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

CloudError

Een foutreactie van de Compute-service.

Name Type Description
error

ApiError

Api-fout.

InnerError

Interne foutdetails.

Name Type Description
errordetail

string

Het interne foutbericht of de uitzonderingsdump.

exceptiontype

string

Het uitzonderingstype.

RollingUpgradeActionType

De laatste actie die is uitgevoerd op de rolling upgrade.

Name Type Description
Cancel

string

Start

string

RollingUpgradePolicy

De configuratieparameters die worden gebruikt tijdens het uitvoeren van een rolling upgrade.

Name Type Description
enableCrossZoneUpgrade

boolean

Toestaan dat VMSS AZ-grenzen negeert bij het maken van upgradebatches. Neem rekening met het updatedomein en maxBatchInstancePercent om de batchgrootte te bepalen.

maxBatchInstancePercent

integer

Het maximumpercentage van het totale aantal exemplaren van virtuele machines dat tegelijkertijd wordt geüpgraded door de rolling upgrade in één batch. Omdat dit een maximum is, kunnen beschadigde exemplaren in eerdere of toekomstige batches ervoor zorgen dat het percentage exemplaren in een batch afneemt om een hogere betrouwbaarheid te garanderen. De standaardwaarde voor deze parameter is 20%.

maxSurge

boolean

Maak nieuwe virtuele machines om de schaalset bij te werken in plaats van de bestaande virtuele machines bij te werken. Bestaande virtuele machines worden verwijderd zodra de nieuwe virtuele machines voor elke batch worden gemaakt.

maxUnhealthyInstancePercent

integer

Het maximumpercentage van het totale aantal exemplaren van virtuele machines in de schaalset dat tegelijkertijd beschadigd kan zijn, hetzij als gevolg van een upgrade of door de statuscontroles van de virtuele machine te worden aangetroffen voordat de rolling upgrade wordt afgebroken. Deze beperking wordt gecontroleerd voordat u een batch start. De standaardwaarde voor deze parameter is 20%.

maxUnhealthyUpgradedInstancePercent

integer

Het maximumpercentage van bijgewerkte exemplaren van virtuele machines die kunnen worden gevonden, hebben een slechte status. Deze controle vindt plaats nadat elke batch is bijgewerkt. Als dit percentage ooit wordt overschreden, wordt de rolling update afgebroken. De standaardwaarde voor deze parameter is 20%.

pauseTimeBetweenBatches

string

De wachttijd tussen het voltooien van de update voor alle virtuele machines in één batch en het starten van de volgende batch. De tijdsduur moet worden opgegeven in ISO 8601-indeling. De standaardwaarde is 0 seconden (PT0S).

prioritizeUnhealthyInstances

boolean

Werk alle beschadigde exemplaren in een schaalset bij voordat alle exemplaren in orde zijn.

rollbackFailedInstancesOnPolicyBreach

boolean

Het terugdraaien van mislukte exemplaren naar het vorige model als het beleid voor rolling upgrades wordt geschonden.

RollingUpgradeProgressInfo

Informatie over het aantal exemplaren van virtuele machines in elke upgradestatus.

Name Type Description
failedInstanceCount

integer

Het aantal exemplaren dat niet kan worden geüpgraded.

inProgressInstanceCount

integer

Het aantal exemplaren dat momenteel wordt bijgewerkt.

pendingInstanceCount

integer

Het aantal exemplaren dat nog niet is bijgewerkt.

successfulInstanceCount

integer

Het aantal exemplaren dat is bijgewerkt.

RollingUpgradeRunningStatus

Informatie over de huidige status van de algehele upgrade.

Name Type Description
code

RollingUpgradeStatusCode

Code die de huidige status van de upgrade aangeeft.

lastAction

RollingUpgradeActionType

De laatste actie die is uitgevoerd op de rolling upgrade.

lastActionTime

string

Laatste actietijd van de upgrade.

startTime

string

Begintijd van de upgrade.

RollingUpgradeStatusCode

Code die de huidige status van de upgrade aangeeft.

Name Type Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

De status van de nieuwste rolling upgrade van de virtuele-machineschaalset.

Name Type Description
id

string

Resource-id

location

string

Resourcelocatie

name

string

Resourcenaam

properties.error

ApiError

Foutdetails voor deze upgrade, indien aanwezig.

properties.policy

RollingUpgradePolicy

Het beleid voor rolling upgrades dat is toegepast op deze upgrade.

properties.progress

RollingUpgradeProgressInfo

Informatie over het aantal exemplaren van virtuele machines in elke upgradestatus.

properties.runningStatus

RollingUpgradeRunningStatus

Informatie over de huidige status van de algehele upgrade.

tags

object

Resourcetags

type

string

Resourcetype