Sdílet prostřednictvím


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Získá stav nejnovějšího postupného upgradu škálovací sady virtuálních počítačů.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
path True

string

Název skupiny prostředků.

subscriptionId
path True

string

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.

vmScaleSetName
path True

string

Název škálovací sady virtuálních počítačů

api-version
query True

string

Verze rozhraní API klienta.

Odpovědi

Name Typ Description
200 OK

RollingUpgradeStatusInfo

OK

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
ApiError

Chyba rozhraní API

ApiErrorBase

Základ chyb rozhraní API.

CloudError

Odpověď na chybu z výpočetní služby

InnerError

Podrobnosti vnitřní chyby.

RollingUpgradeActionType

Poslední akce provedená při postupném upgradu.

RollingUpgradePolicy

Parametry konfigurace použité při postupném upgradu.

RollingUpgradeProgressInfo

Informace o počtu instancí virtuálních počítačů v jednotlivých stavech upgradu

RollingUpgradeRunningStatus

Informace o aktuálním spuštěném stavu celkového upgradu

RollingUpgradeStatusCode

Kód označující aktuální stav upgradu.

RollingUpgradeStatusInfo

Stav nejnovějšího postupného upgradu škálovací sady virtuálních počítačů

ApiError

Chyba rozhraní API

Name Typ Description
code

string

Kód chyby.

details

ApiErrorBase[]

Podrobnosti o chybě rozhraní API

innererror

InnerError

Vnitřní chyba rozhraní API

message

string

Chybová zpráva.

target

string

Cíl konkrétní chyby.

ApiErrorBase

Základ chyb rozhraní API.

Name Typ Description
code

string

Kód chyby.

message

string

Chybová zpráva.

target

string

Cíl konkrétní chyby.

CloudError

Odpověď na chybu z výpočetní služby

Name Typ Description
error

ApiError

Chyba rozhraní API

InnerError

Podrobnosti vnitřní chyby.

Name Typ Description
errordetail

string

Vnitřní chybová zpráva nebo výpis výjimky.

exceptiontype

string

Typ výjimky.

RollingUpgradeActionType

Poslední akce provedená při postupném upgradu.

Name Typ Description
Cancel

string

Start

string

RollingUpgradePolicy

Parametry konfigurace použité při postupném upgradu.

Name Typ Description
enableCrossZoneUpgrade

boolean

Povolte VMSS ignorovat hranice AZ při vytváření dávek upgradu. Zvažte aktualizaci domény a maxBatchInstancePercent k určení velikosti dávky.

maxBatchInstancePercent

integer

Maximální procento celkových instancí virtuálních počítačů, které budou upgradovány současně postupným upgradem v jedné dávce. Vzhledem k tomu, že se jedná o maximum, instance, které nejsou v pořádku v předchozích nebo budoucích dávkách, můžou způsobit snížení procenta instancí v dávce, aby se zajistila vyšší spolehlivost. Výchozí hodnota pro tento parametr je 20%.

maxSurge

boolean

Vytvořte nové virtuální počítače pro upgrade škálovací sady místo aktualizace existujících virtuálních počítačů. Existující virtuální počítače budou odstraněny po vytvoření nových virtuálních počítačů pro každou dávku.

maxUnhealthyInstancePercent

integer

Maximální procento celkových instancí virtuálních počítačů ve škálovací sadě, které může být současně v pořádku, buď v důsledku upgradu, nebo zjištěním stavu, který není v pořádku, kontroluje stav virtuálního počítače před přerušením postupného upgradu. Toto omezení se zkontroluje před spuštěním jakékoli dávky. Výchozí hodnota pro tento parametr je 20%.

maxUnhealthyUpgradedInstancePercent

integer

Maximální procento upgradovanýchinstancích Tato kontrola proběhne po upgradu každé dávky. Pokud se toto procento někdy překročí, průběžná aktualizace se přeruší. Výchozí hodnota pro tento parametr je 20%.

pauseTimeBetweenBatches

string

Doba čekání mezi dokončením aktualizace pro všechny virtuální počítače v jedné dávce a spuštěním další dávky. Doba trvání by měla být zadána ve formátu ISO 8601. Výchozí hodnota je 0 sekund (PT0S).

prioritizeUnhealthyInstances

boolean

Upgradujte všechny instance, které nejsou v pořádku, ve škálovací sadě před všemi instancemi, které jsou v pořádku.

rollbackFailedInstancesOnPolicyBreach

boolean

Vrácení neúspěšných instancí do předchozího modelu v případě porušení zásad postupného upgradu

RollingUpgradeProgressInfo

Informace o počtu instancí virtuálních počítačů v jednotlivých stavech upgradu

Name Typ Description
failedInstanceCount

integer

Počet instancí, které se nepodařilo úspěšně upgradovat.

inProgressInstanceCount

integer

Počet instancí, které se aktuálně upgradují.

pendingInstanceCount

integer

Počet instancí, které ještě nebyly upgradovány.

successfulInstanceCount

integer

Počet instancí, které byly úspěšně upgradovány.

RollingUpgradeRunningStatus

Informace o aktuálním spuštěném stavu celkového upgradu

Name Typ Description
code

RollingUpgradeStatusCode

Kód označující aktuální stav upgradu.

lastAction

RollingUpgradeActionType

Poslední akce provedená při postupném upgradu.

lastActionTime

string

Čas poslední akce upgradu

startTime

string

Čas zahájení upgradu

RollingUpgradeStatusCode

Kód označující aktuální stav upgradu.

Name Typ Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

Stav nejnovějšího postupného upgradu škálovací sady virtuálních počítačů

Name Typ Description
id

string

ID prostředku

location

string

Umístění prostředku

name

string

Název prostředku

properties.error

ApiError

Podrobnosti o chybě pro tento upgrade, pokud nějaké existují.

properties.policy

RollingUpgradePolicy

Zásady postupného upgradu použité pro tento upgrade.

properties.progress

RollingUpgradeProgressInfo

Informace o počtu instancí virtuálních počítačů v jednotlivých stavech upgradu

properties.runningStatus

RollingUpgradeRunningStatus

Informace o aktuálním spuštěném stavu celkového upgradu

tags

object

Značky prostředků

type

string

Typ prostředku