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-03-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
resource
|
path | True |
string |
Nazwa grupy zasobów. |
subscription
|
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. |
vm
|
path | True |
string |
Nazwa zestawu skalowania maszyn wirtualnych. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Virtual |
Virtual |
VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
Sample Request
Sample Response
{
"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
Sample Request
Sample Response
{
"value": [
{}
]
}
Definicje
Nazwa | Opis |
---|---|
Api |
Błąd interfejsu API. |
Api |
Baza błędów interfejsu API. |
Cloud |
Odpowiedź na błąd z usługi Compute. |
Image |
Określa informacje o obrazie do użycia. Można określić informacje o obrazach platformy, obrazach witryny Marketplace lub obrazach maszyn wirtualnych. Ten element jest wymagany, gdy chcesz użyć obrazu platformy, obrazu z 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. |
Inner |
Szczegóły błędu wewnętrznego. |
Rollback |
Informacje o wycofywaniu wystąpień maszyn wirtualnych, które zakończyły się niepowodzeniem po operacji uaktualniania systemu operacyjnego. |
Rolling |
Informacje o liczbie wystąpień maszyn wirtualnych w każdym stanie uaktualniania. |
Upgrade |
Odpowiedź na operację Historia uaktualniania systemu operacyjnego zestawu skalowania maszyn wirtualnych. |
Upgrade |
Opisuje każde uaktualnienie systemu operacyjnego w zestawie skalowania maszyn wirtualnych. |
Upgrade |
Informacje o bieżącym stanie działania ogólnego uaktualnienia. |
Upgrade |
Wywołanie operacji uaktualniania |
Upgrade |
Kod wskazujący bieżący stan uaktualnienia. |
Virtual |
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 |
Szczegóły błędu interfejsu API |
|
innererror |
Wewnętrzny błąd 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 Compute.
Nazwa | Typ | Opis |
---|---|---|
error |
Błąd interfejsu API. |
ImageReference
Określa informacje o obrazie do użycia. Można określić informacje o obrazach platformy, obrazach witryny Marketplace lub obrazach maszyn wirtualnych. Ten element jest wymagany, gdy chcesz użyć obrazu platformy, obrazu z 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 galerii społeczności— wywołanie GET obrazu. |
exactVersion |
string |
Określa liczbę dziesiętną, wersję obrazu platformy lub obraz platformy handlowej użyty do utworzenia maszyny wirtualnej. To pole tylko do odczytu różni się od "wersji", tylko jeśli 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 obrazu galerii WYWOŁAnie GET. |
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 kompilacja to liczby dziesiętne. Określ wartość "latest", aby użyć najnowszej wersji obrazu dostępnej w czasie wdrażania. Nawet jeśli używasz wartości "latest", obraz maszyny wirtualnej nie zostanie automatycznie zaktualizowany po czasie wdrażania, nawet jeśli nowa wersja stanie się dostępna. Nie używaj pola "version" do wdrożenia obrazu galerii. Obraz galerii powinien zawsze używać pola "id" do wdrożenia, aby użyć najnowszej wersji obrazu galerii, wystarczy ustawić wartość "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{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 |
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 |
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 |
Szczegóły błędu dotyczące tego uaktualnienia, jeśli istnieją. |
|
progress |
Liczba maszyn wirtualnych w każdym stanie. |
|
rollbackInfo |
Informacje o wycofywaniu systemu operacyjnego w przypadku wykonania |
|
runningStatus |
Informacje o ogólnym stanie operacji uaktualniania. |
|
startedBy |
Wywołanie operacji uaktualniania |
|
targetImageReference |
Szczegóły odwołania do obrazu |
UpgradeOperationHistoryStatus
Informacje o bieżącym stanie działania ogólnego uaktualnienia.
Nazwa | Typ | Opis |
---|---|---|
code |
Kod wskazujący bieżący stan uaktualnienia. |
|
endTime |
string |
Godzina zakończenia uaktualniania. |
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 umożliwiający pobranie następnej strony historii uaktualniania systemu operacyjnego. Wywołaj metodę ListNext(), aby pobrać następną stronę historii uaktualnień. |
value |
Lista uaktualnień systemu operacyjnego wykonanych w zestawie skalowania maszyn wirtualnych. |