Udostępnij za pośrednictwem


Virtual Machine Scale Set Rolling Upgrades - Get Latest

Pobiera stan najnowszego uaktualnienia stopniowego zestawu skalowania maszyn wirtualnych.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów.

subscriptionId
path True

string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

vmScaleSetName
path True

string

Nazwa zestawu skalowania maszyn wirtualnych.

api-version
query True

string

Wersja interfejsu API klienta.

Odpowiedzi

Nazwa Typ Opis
200 OK

RollingUpgradeStatusInfo

OK

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen
VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
ApiError

Błąd interfejsu API.

ApiErrorBase

Baza błędów interfejsu API.

CloudError

Odpowiedź na błąd z usługi Obliczeniowej.

InnerError

Szczegóły błędu wewnętrznego.

RollingUpgradeActionType

Ostatnia akcja wykonywana podczas uaktualniania stopniowego.

RollingUpgradePolicy

Parametry konfiguracji używane podczas uaktualniania stopniowego.

RollingUpgradeProgressInfo

Informacje o liczbie wystąpień maszyn wirtualnych w każdym stanie uaktualniania.

RollingUpgradeRunningStatus

Informacje o bieżącym stanie uruchomienia ogólnego uaktualnienia.

RollingUpgradeStatusCode

Kod wskazujący bieżący stan uaktualnienia.

RollingUpgradeStatusInfo

Stan najnowszego uaktualnienia stopniowego zestawu skalowania maszyn wirtualnych.

ApiError

Błąd interfejsu API.

Nazwa Typ Opis
code

string

Kod błędu.

details

ApiErrorBase[]

Szczegóły błędu interfejsu API

innererror

InnerError

Błąd wewnętrzny interfejsu API

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

ApiErrorBase

Baza błędów interfejsu API.

Nazwa Typ Opis
code

string

Kod błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

CloudError

Odpowiedź na błąd z usługi Obliczeniowej.

Nazwa Typ Opis
error

ApiError

Błąd interfejsu API.

InnerError

Szczegóły błędu wewnętrznego.

Nazwa Typ Opis
errordetail

string

Wewnętrzny komunikat o błędzie lub zrzut wyjątku.

exceptiontype

string

Typ wyjątku.

RollingUpgradeActionType

Ostatnia akcja wykonywana podczas uaktualniania stopniowego.

Nazwa Typ Opis
Cancel

string

Start

string

RollingUpgradePolicy

Parametry konfiguracji używane podczas uaktualniania stopniowego.

Nazwa Typ Opis
enableCrossZoneUpgrade

boolean

Zezwalaj usłudze VMSS na ignorowanie granic az podczas konstruowania partii uaktualniania. Weź pod uwagę domenę aktualizacji i parametr maxBatchInstancePercent w celu określenia rozmiaru partii.

maxBatchInstancePercent

integer

Maksymalny procent łącznych wystąpień maszyn wirtualnych, które zostaną uaktualnione jednocześnie przez uaktualnienie stopniowe w jednej partii. Ponieważ jest to maksimum, wystąpienia w złej kondycji w poprzednich lub przyszłych partiach mogą spowodować spadek procentu wystąpień w partii w celu zapewnienia większej niezawodności. Wartość domyślna tego parametru to 20%.

maxSurge

boolean

Utwórz nowe maszyny wirtualne, aby uaktualnić zestaw skalowania, zamiast aktualizować istniejące maszyny wirtualne. Istniejące maszyny wirtualne zostaną usunięte po utworzeniu nowych maszyn wirtualnych dla każdej partii.

maxUnhealthyInstancePercent

integer

Maksymalny procent łącznej liczby wystąpień maszyn wirtualnych w zestawie skalowania, które mogą być jednocześnie w złej kondycji, w wyniku uaktualnienia lub przez odnalezienie w stanie złej kondycji przez kontrolę kondycji maszyny wirtualnej przed przerwaniem uaktualnienia stopniowego. To ograniczenie zostanie sprawdzone przed uruchomieniem dowolnej partii. Wartość domyślna tego parametru to 20%.

maxUnhealthyUpgradedInstancePercent

integer

Maksymalny procent uaktualnionych wystąpień maszyn wirtualnych, które można znaleźć w złej kondycji. Ta kontrola będzie miała miejsce po uaktualnieniu każdej partii. Jeśli ta wartość procentowa zostanie kiedykolwiek przekroczona, przerywa się aktualizacja stopniowa. Wartość domyślna tego parametru to 20%.

pauseTimeBetweenBatches

string

Czas oczekiwania między ukończeniem aktualizacji dla wszystkich maszyn wirtualnych w jednej partii a uruchomieniem następnej partii. Czas trwania należy określić w formacie ISO 8601. Wartość domyślna to 0 sekund (PT0S).

prioritizeUnhealthyInstances

boolean

Uaktualnij wszystkie wystąpienia w złej kondycji w zestawie skalowania przed wszelkimi wystąpieniami w dobrej kondycji.

rollbackFailedInstancesOnPolicyBreach

boolean

Wycofywanie nie powiodło się wystąpienia do poprzedniego modelu, jeśli zasady uaktualniania stopniowego zostały naruszone.

RollingUpgradeProgressInfo

Informacje o liczbie wystąpień maszyn wirtualnych w każdym stanie uaktualniania.

Nazwa Typ Opis
failedInstanceCount

integer

Liczba wystąpień, których nie można pomyślnie uaktualnić.

inProgressInstanceCount

integer

Liczba wystąpień, które są obecnie uaktualniane.

pendingInstanceCount

integer

Liczba wystąpień, które nie zostały jeszcze uaktualnione.

successfulInstanceCount

integer

Liczba wystąpień, które zostały pomyślnie uaktualnione.

RollingUpgradeRunningStatus

Informacje o bieżącym stanie uruchomienia ogólnego uaktualnienia.

Nazwa Typ Opis
code

RollingUpgradeStatusCode

Kod wskazujący bieżący stan uaktualnienia.

lastAction

RollingUpgradeActionType

Ostatnia akcja wykonywana podczas uaktualniania stopniowego.

lastActionTime

string

Czas ostatniej akcji uaktualnienia.

startTime

string

Godzina rozpoczęcia uaktualniania.

RollingUpgradeStatusCode

Kod wskazujący bieżący stan uaktualnienia.

Nazwa Typ Opis
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

RollingUpgradeStatusInfo

Stan najnowszego uaktualnienia stopniowego zestawu skalowania maszyn wirtualnych.

Nazwa Typ Opis
id

string

Identyfikator zasobu

location

string

Lokalizacja zasobu

name

string

Nazwa zasobu

properties.error

ApiError

Szczegóły błędu dotyczące tego uaktualnienia, jeśli istnieją.

properties.policy

RollingUpgradePolicy

Zasady uaktualniania stopniowego stosowane do tego uaktualnienia.

properties.progress

RollingUpgradeProgressInfo

Informacje o liczbie wystąpień maszyn wirtualnych w każdym stanie uaktualniania.

properties.runningStatus

RollingUpgradeRunningStatus

Informacje o bieżącym stanie uruchomienia ogólnego uaktualnienia.

tags

object

Tagi zasobów

type

string

Typ zasobu