Udostępnij za pośrednictwem


Virtual Machine Scale Sets - Get OS Upgrade History

Pobiera listę uaktualnień systemu operacyjnego w wystąpieniu zestawu skalowania maszyn wirtualnych.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?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

VirtualMachineScaleSetListOSUpgradeHistory

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

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "value": [
    {
      "properties": {
        "runningStatus": {
          "code": "RollingForward",
          "startTime": "2021-11-30T13:05:40.442Z",
          "endTime": "2021-11-30T13:05:40.443Z"
        },
        "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"
        },
        "startedBy": "Unknown",
        "targetImageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer",
          "exactVersion": "aaaaaaa",
          "sharedGalleryImageId": "aaaaaa",
          "id": "aaaaaaaaaaaaaaaaaaa"
        },
        "rollbackInfo": {
          "successfullyRolledbackInstanceCount": 12,
          "failedRolledbackInstanceCount": 2,
          "rollbackError": {
            "details": [
              {
                "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
                "target": "aaaa",
                "message": "aa"
              }
            ],
            "innererror": {
              "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
            },
            "code": "aaaaaaa",
            "target": "aaaaaaa",
            "message": "aaaaaaaaa"
          }
        }
      },
      "type": "aaaaaaaaaaaaaaaaaaa",
      "location": "aaaaaaaaaaaaa"
    }
  ],
  "nextLink": "aaaaaaaaa"
}

VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "value": [
    {}
  ]
}

Definicje

Nazwa Opis
ApiError

Błąd interfejsu API.

ApiErrorBase

Baza błędów interfejsu API.

CloudError

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

ImageReference

Określa informacje o obrazie do użycia. Możesz określić informacje o obrazach platformy, obrazach witryny Marketplace lub obrazach maszyn wirtualnych. Ten element jest wymagany, gdy chcesz użyć obrazu platformy, obrazu witryny Marketplace lub obrazu maszyny wirtualnej, ale nie jest używany w innych operacjach tworzenia. UWAGA: Wydawca i oferta odwołania do obrazów można ustawić tylko podczas tworzenia zestawu skalowania.

InnerError

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

RollbackStatusInfo

Informacje o wycofywaniu wystąpień maszyn wirtualnych, które zakończyły się niepowodzeniem po operacji uaktualniania systemu operacyjnego.

RollingUpgradeProgressInfo

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

UpgradeOperationHistoricalStatusInfo

Odpowiedź na operację Historia uaktualniania systemu operacyjnego zestawu skalowania maszyn wirtualnych.

UpgradeOperationHistoricalStatusInfoProperties

Opisuje każde uaktualnienie systemu operacyjnego w zestawie skalowania maszyn wirtualnych.

UpgradeOperationHistoryStatus

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

UpgradeOperationInvoker

Wywołanie operacji uaktualniania

UpgradeState

Kod wskazujący bieżący stan uaktualnienia.

VirtualMachineScaleSetListOSUpgradeHistory

Lista odpowiedzi operacji historia uaktualniania systemu operacyjnego 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.

ImageReference

Określa informacje o obrazie do użycia. Możesz określić informacje o obrazach platformy, obrazach witryny Marketplace lub obrazach maszyn wirtualnych. Ten element jest wymagany, gdy chcesz użyć obrazu platformy, obrazu witryny Marketplace lub obrazu maszyny wirtualnej, ale nie jest używany w innych operacjach tworzenia. UWAGA: Wydawca i oferta odwołania do obrazów można ustawić tylko podczas tworzenia zestawu skalowania.

Nazwa Typ Opis
communityGalleryImageId

string

Określono unikatowy identyfikator obrazu galerii społeczności dla wdrożenia maszyny wirtualnej. Można to pobrać z poziomu wywołania GET obrazu galerii społeczności.

exactVersion

string

Określa w liczbach dziesiętnych, wersję obrazu platformy lub obraz witryny Marketplace używany do tworzenia maszyny wirtualnej. To pole tylko do odczytu różni się od "wersji", tylko wtedy, gdy wartość określona w polu "version" to "latest".

id

string

Identyfikator zasobu

offer

string

Określa ofertę obrazu platformy lub obrazu platformy handlowej użytego do utworzenia maszyny wirtualnej.

publisher

string

Wydawca obrazów.

sharedGalleryImageId

string

Określono unikatowy identyfikator obrazu galerii udostępnionej dla wdrożenia maszyny wirtualnej. Można to pobrać z udostępnionego wywołania GET obrazu galerii.

sku

string

Jednostka SKU obrazu.

version

string

Określa wersję obrazu platformy lub obrazu platformy handlowej użytego do utworzenia maszyny wirtualnej. Dozwolone formaty to Major.Minor.Build lub 'latest'. Główne, pomocnicze i kompilacje to liczby dziesiętne. Określ wartość "latest", aby użyć najnowszej wersji obrazu dostępnego w czasie wdrażania. Nawet jeśli używasz polecenia "latest", obraz maszyny wirtualnej nie zostanie automatycznie zaktualizowany po czasie wdrażania, nawet jeśli nowa wersja stanie się dostępna. Nie należy używać pola "version" dla wdrożenia obrazu galerii, obraz galerii powinien zawsze używać pola "id" do wdrożenia, aby użyć "latest" wersji obrazu galerii, po prostu ustaw wartość "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}" w polu "id" bez danych wejściowych wersji.

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.

RollbackStatusInfo

Informacje o wycofywaniu wystąpień maszyn wirtualnych, które zakończyły się niepowodzeniem po operacji uaktualniania systemu operacyjnego.

Nazwa Typ Opis
failedRolledbackInstanceCount

integer

Liczba wystąpień, których wycofanie nie powiodło się.

rollbackError

ApiError

Szczegóły błędu, jeśli wycofanie systemu operacyjnego nie powiodło się.

successfullyRolledbackInstanceCount

integer

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

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.

UpgradeOperationHistoricalStatusInfo

Odpowiedź na operację Historia uaktualniania systemu operacyjnego zestawu skalowania maszyn wirtualnych.

Nazwa Typ Opis
location

string

Lokalizacja zasobu

properties

UpgradeOperationHistoricalStatusInfoProperties

Informacje o właściwościach operacji uaktualniania.

type

string

Typ zasobu

UpgradeOperationHistoricalStatusInfoProperties

Opisuje każde uaktualnienie systemu operacyjnego w zestawie skalowania maszyn wirtualnych.

Nazwa Typ Opis
error

ApiError

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

progress

RollingUpgradeProgressInfo

Liczba maszyn wirtualnych w każdym stanie.

rollbackInfo

RollbackStatusInfo

Informacje o wycofywaniu systemu operacyjnego w przypadku wykonania

runningStatus

UpgradeOperationHistoryStatus

Informacje o ogólnym stanie operacji uaktualniania.

startedBy

UpgradeOperationInvoker

Wywołanie operacji uaktualniania

targetImageReference

ImageReference

Szczegóły odwołania do obrazu

UpgradeOperationHistoryStatus

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

Nazwa Typ Opis
code

UpgradeState

Kod wskazujący bieżący stan uaktualnienia.

endTime

string

Godzina zakończenia uaktualnienia.

startTime

string

Godzina rozpoczęcia uaktualniania.

UpgradeOperationInvoker

Wywołanie operacji uaktualniania

Nazwa Typ Opis
Platform

string

Unknown

string

User

string

UpgradeState

Kod wskazujący bieżący stan uaktualnienia.

Nazwa Typ Opis
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Lista odpowiedzi operacji historia uaktualniania systemu operacyjnego zestawu skalowania maszyn wirtualnych.

Nazwa Typ Opis
nextLink

string

Identyfikator URI do pobrania następnej strony historii uaktualniania systemu operacyjnego. Wywołaj metodę ListNext(), aby pobrać następną stronę historii uaktualnień.

value

UpgradeOperationHistoricalStatusInfo[]

Lista uaktualnień systemu operacyjnego wykonanych w zestawie skalowania maszyn wirtualnych.