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-11-01

Parametry identifikátoru URI

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

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.

subscriptionId
path True

string

minLength: 1

ID cílového předplatného.

vmScaleSetName
path True

string

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

api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name Typ Description
200 OK

RollingUpgradeStatusInfo

Operace Azure byla úspěšně dokončena.

Other Status Codes

CloudError

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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-11-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-11-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

createdByType

Typ identity, která prostředek vytvořila.

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čů

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

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

createdByType

Typ identity, která prostředek vytvořila.

Hodnota Description
User
Application
ManagedIdentity
Key

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.

Hodnota Description
Start
Cancel

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 (int32)

minimum: 5
maximum: 100

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 (int32)

minimum: 5
maximum: 100

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 (int32)

maximum: 100

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 (int32)

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

inProgressInstanceCount

integer (int32)

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

pendingInstanceCount

integer (int32)

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

successfulInstanceCount

integer (int32)

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 (date-time)

Čas poslední akce upgradu

startTime

string (date-time)

Čas zahájení upgradu

RollingUpgradeStatusCode

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

Hodnota Description
RollingForward
Cancelled
Completed
Faulted

RollingUpgradeStatusInfo

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

Name Typ Description
id

string

Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Geografické umístění, ve kterém se nachází zdroj

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

systemData

systemData

Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.

tags

object

Značky prostředků

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string (date-time)

Časové razítko vytvoření prostředku (UTC).

createdBy

string

Identita, která prostředek vytvořila.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string (date-time)

Časové razítko poslední změny zdroje (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.