Virtual Machine Scale Sets - Get OS Upgrade History
Lekéri a virtuálisgép-méretezési csoport példány operációsrendszer-frissítéseinek listáját.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2024-03-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Az erőforráscsoport neve. |
subscription
|
path | True |
string |
Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi. |
vm
|
path | True |
string |
A virtuálisgép-méretezési csoport neve. |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OKÉ |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy miért nem sikerült a művelet. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
Virtual |
Virtual |
VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
Mintakérelem
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2024-03-01
Mintaválasz
{
"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
Mintakérelem
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2024-03-01
Mintaválasz
{
"value": [
{}
]
}
Definíciók
Name | Description |
---|---|
Api |
Api-hiba. |
Api |
Api-hibabázis. |
Cloud |
Hibaválasz a Compute szolgáltatástól. |
Image |
Megadja a használni kívánt kép adatait. Megadhatja a platformrendszerképekről, a marketplace-rendszerképekről vagy a virtuálisgép-rendszerképekről szóló információkat. Ez az elem akkor szükséges, ha platformrendszerképet, piactéri rendszerképet vagy virtuálisgép-lemezképet szeretne használni, de más létrehozási műveletekben nem használja. MEGJEGYZÉS: A képhivatkozás közzétevője és ajánlata csak a méretezési csoport létrehozásakor állítható be. |
Inner |
Belső hiba részletei. |
Rollback |
Információk a sikertelen virtuálisgép-példányok operációsrendszer-frissítési művelet utáni visszaállításáról. |
Rolling |
Információ az egyes frissítési állapotokban lévő virtuálisgép-példányok számáról. |
Upgrade |
Virtuálisgép-méretezési csoport operációsrendszer-frissítési előzményeinek műveleti válasza. |
Upgrade |
A virtuálisgép-méretezési csoport minden operációsrendszer-frissítését ismerteti. |
Upgrade |
Információk a teljes frissítés aktuális futó állapotáról. |
Upgrade |
A frissítési művelet meghívója |
Upgrade |
A frissítés aktuális állapotát jelző kód. |
Virtual |
A virtuálisgép-méretezési csoport operációsrendszer-frissítési előzményeinek műveleti válaszának listája. |
ApiError
Api-hiba.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
details |
Az API-hiba részletei |
|
innererror |
Az Api belső hibája |
|
message |
string |
A hibaüzenet. |
target |
string |
Az adott hiba célja. |
ApiErrorBase
Api-hibabázis.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
message |
string |
A hibaüzenet. |
target |
string |
Az adott hiba célja. |
CloudError
Hibaválasz a Compute szolgáltatástól.
Name | Típus | Description |
---|---|---|
error |
Api-hiba. |
ImageReference
Megadja a használni kívánt kép adatait. Megadhatja a platformrendszerképekről, a marketplace-rendszerképekről vagy a virtuálisgép-rendszerképekről szóló információkat. Ez az elem akkor szükséges, ha platformrendszerképet, piactéri rendszerképet vagy virtuálisgép-lemezképet szeretne használni, de más létrehozási műveletekben nem használja. MEGJEGYZÉS: A képhivatkozás közzétevője és ajánlata csak a méretezési csoport létrehozásakor állítható be.
Name | Típus | Description |
---|---|---|
communityGalleryImageId |
string |
A virtuális gép üzembe helyezéséhez a közösségi katalógus rendszerképének egyedi azonosítóját adta meg. Ez lekérhető a közösségi galéria rendszerképének GET hívásából. |
exactVersion |
string |
Decimális számokban adja meg a virtuális gép létrehozásához használt platformrendszerkép vagy marketplace-rendszerkép verzióját. Ez az olvasható mező eltér a verziótól, csak akkor, ha a "verzió" mezőben megadott érték a "legújabb". |
id |
string |
Erőforrás-azonosító |
offer |
string |
Megadja a virtuális gép létrehozásához használt platformrendszerkép vagy marketplace-rendszerkép ajánlatát. |
publisher |
string |
A kép közzétevője. |
sharedGalleryImageId |
string |
A megosztott katalógus lemezképének egyedi azonosítóját adta meg a virtuális gép üzembe helyezéséhez. Ez lekérhető a megosztott katalógus képének GET hívásából. |
sku |
string |
A kép termékváltozata. |
version |
string |
A virtuális gép létrehozásához használt platformrendszerkép vagy marketplace-rendszerkép verzióját adja meg. Az engedélyezett formátumok a Major.Minor.Build vagy a "legújabb". A fő, a kisebb és a build tizedes tört. Adja meg a "legújabb" értéket a rendszerkép üzembe helyezéskor elérhető legújabb verziójának használatához. Még ha a legújabb verziót is használja, a virtuálisgép-rendszerkép nem frissül automatikusan az üzembe helyezés után, még akkor sem, ha egy új verzió elérhetővé válik. Ne használja a "verzió" mezőt a katalógus lemezképének üzembe helyezéséhez, a katalógus lemezképének "id" mezője mindig az "id" mezőt használja a katalóguskép "legújabb" verziójának használatához, csak állítsa be a "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}" mezőt az "id" mezőben verzióbemenet nélkül. |
InnerError
Belső hiba részletei.
Name | Típus | Description |
---|---|---|
errordetail |
string |
A belső hibaüzenet vagy kivételkép. |
exceptiontype |
string |
A kivétel típusa. |
RollbackStatusInfo
Információk a sikertelen virtuálisgép-példányok operációsrendszer-frissítési művelet utáni visszaállításáról.
Name | Típus | Description |
---|---|---|
failedRolledbackInstanceCount |
integer |
Azon példányok száma, amelyek visszaállítása sikertelen volt. |
rollbackError |
Hiba részletei, ha az operációs rendszer visszaállítása sikertelen volt. |
|
successfullyRolledbackInstanceCount |
integer |
A sikeresen visszagördített példányok száma. |
RollingUpgradeProgressInfo
Információ az egyes frissítési állapotokban lévő virtuálisgép-példányok számáról.
Name | Típus | Description |
---|---|---|
failedInstanceCount |
integer |
Azon példányok száma, amelyek frissítése sikertelen volt. |
inProgressInstanceCount |
integer |
A jelenleg frissített példányok száma. |
pendingInstanceCount |
integer |
Azoknak a példányoknak a száma, amelyek még nem kezdődtek el a frissítéssel. |
successfulInstanceCount |
integer |
A sikeresen frissített példányok száma. |
UpgradeOperationHistoricalStatusInfo
Virtuálisgép-méretezési csoport operációsrendszer-frissítési előzményeinek műveleti válasza.
Name | Típus | Description |
---|---|---|
location |
string |
Erőforrás helye |
properties |
A frissítési művelet tulajdonságaival kapcsolatos információk. |
|
type |
string |
Erőforrás típusa |
UpgradeOperationHistoricalStatusInfoProperties
A virtuálisgép-méretezési csoport minden operációsrendszer-frissítését ismerteti.
Name | Típus | Description |
---|---|---|
error |
Hiba részletei a frissítéshez, ha vannak ilyenek. |
|
progress |
Az egyes állapotokban lévő virtuális gépek száma. |
|
rollbackInfo |
Információ az operációs rendszer visszaállításáról, ha végrehajtják |
|
runningStatus |
A frissítési művelet általános állapotával kapcsolatos információk. |
|
startedBy |
A frissítési művelet meghívója |
|
targetImageReference |
Képhivatkozás részletei |
UpgradeOperationHistoryStatus
Információk a teljes frissítés aktuális futó állapotáról.
Name | Típus | Description |
---|---|---|
code |
A frissítés aktuális állapotát jelző kód. |
|
endTime |
string |
A frissítés befejezési ideje. |
startTime |
string |
A frissítés kezdési időpontja. |
UpgradeOperationInvoker
A frissítési művelet meghívója
Name | Típus | Description |
---|---|---|
Platform |
string |
|
Unknown |
string |
|
User |
string |
UpgradeState
A frissítés aktuális állapotát jelző kód.
Name | Típus | Description |
---|---|---|
Cancelled |
string |
|
Completed |
string |
|
Faulted |
string |
|
RollingForward |
string |
VirtualMachineScaleSetListOSUpgradeHistory
A virtuálisgép-méretezési csoport operációsrendszer-frissítési előzményeinek műveleti válaszának listája.
Name | Típus | Description |
---|---|---|
nextLink |
string |
Az operációs rendszer frissítési előzményeinek következő oldalának lekéréséhez tartozó uri. Ezzel hívja meg a ListNext() parancsot a frissítések előzményeinek következő oldalának lekéréséhez. |
value |
A virtuálisgép-méretezési csoportban végrehajtott operációsrendszer-frissítések listája. |