Megosztás a következőn keresztül:


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
resourceGroupName
path True

string

Az erőforráscsoport neve.

subscriptionId
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ó az URI részét képezi minden szolgáltatáshíváshoz.

vmScaleSetName
path True

string

A virtuálisgép-méretezési csoport neve.

api-version
query True

string

Client API-verzió.

Válaszok

Name Típus Description
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Sample Request

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

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

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

Sample Response

{
  "value": [
    {}
  ]
}

Definíciók

Name Description
ApiError

API-hiba.

ApiErrorBase

API-hibabázis.

CloudError

Hibaválasz a Compute szolgáltatástól.

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. Erre az elemre akkor van szükség, ha platformrendszerképet, piactéri rendszerképet vagy virtuálisgép-rendszerképet szeretne használni, más létrehozási műveletekben azonban nem. 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.

InnerError

Belső hiba részletei.

RollbackStatusInfo

Információk a sikertelen virtuálisgép-példányok rendszerfrissítési művelet utáni visszaállításáról.

RollingUpgradeProgressInfo

Információ az egyes frissítési állapotban lévő virtuálisgép-példányok számáról.

UpgradeOperationHistoricalStatusInfo

A Virtuálisgép-méretezési csoport operációs rendszer frissítési előzményei művelet válasza.

UpgradeOperationHistoricalStatusInfoProperties

A virtuálisgép-méretezési csoport operációs rendszereinek frissítését ismerteti.

UpgradeOperationHistoryStatus

Információk a teljes frissítés aktuális futó állapotáról.

UpgradeOperationInvoker

A frissítési művelet meghívója

UpgradeState

A frissítés aktuális állapotát jelző kód.

VirtualMachineScaleSetListOSUpgradeHistory

A Virtuálisgép-méretezési csoport operációs rendszer frissítési előzményei művelet válaszának listája.

ApiError

API-hiba.

Name Típus Description
code

string

A hibakód.

details

ApiErrorBase[]

Az API-hiba részletei

innererror

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

ApiError

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. Erre az elemre akkor van szükség, ha platformrendszerképet, piactéri rendszerképet vagy virtuálisgép-rendszerképet szeretne használni, más létrehozási műveletekben azonban nem. 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 piactéri rendszerkép verzióját. Ez az olvasható mező eltér a "verzió" mező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 piactéri rendszerkép ajánlatát.

publisher

string

A kép közzétevője.

sharedGalleryImageId

string

Megadva a virtuális gép üzembe helyezéséhez a megosztott katalógus rendszerképének egyedi azonosítóját. Ez lekérhető a megosztott katalógus képének GET hívásából.

sku

string

A rendszerkép termékváltozata.

version

string

A virtuális gép létrehozásához használt platformrendszerkép vagy piactéri rendszerkép verzióját adja meg. Az engedélyezett formátumok a Major.Minor.Build vagy a "latest". A Fő, az Alverzió és a Build tizedes tört. Adja meg a "latest" (legújabb) értéket a rendszerkép központi telepítéskor elérhető legújabb verziójának használatához. Még akkor sem frissül automatikusan a virtuálisgép-rendszerkép az üzembe helyezés után, ha a legújabb verziót használja. Ne használja a "version" mezőt a katalógus rendszerképének központi telepítéséhez, a katalógus rendszerképének mindig az "id" mezőt kell használnia az üzembe helyezéshez, 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}" értéket 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 rendszerfrissí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

ApiError

Hiba részletei, ha az operációs rendszer visszaállítása sikertelen volt.

successfullyRolledbackInstanceCount

integer

A sikeresen visszaállított példányok száma.

RollingUpgradeProgressInfo

Információ az egyes frissítési állapotban 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 meg a frissítéssel.

successfulInstanceCount

integer

A sikeresen frissített példányok száma.

UpgradeOperationHistoricalStatusInfo

A Virtuálisgép-méretezési csoport operációs rendszer frissítési előzményei művelet válasza.

Name Típus Description
location

string

Erőforrás helye

properties

UpgradeOperationHistoricalStatusInfoProperties

Információ a frissítési művelet tulajdonságairól.

type

string

Erőforrás típusa

UpgradeOperationHistoricalStatusInfoProperties

A virtuálisgép-méretezési csoport operációs rendszereinek frissítését ismerteti.

Name Típus Description
error

ApiError

Hiba részletei a frissítéshez, ha vannak ilyenek.

progress

RollingUpgradeProgressInfo

Az egyes állapotokban lévő virtuális gépek száma.

rollbackInfo

RollbackStatusInfo

Információ az operációs rendszer visszaállításáról, ha végrehajtják

runningStatus

UpgradeOperationHistoryStatus

Információ a frissítési művelet általános állapotáról.

startedBy

UpgradeOperationInvoker

A frissítési művelet meghívója

targetImageReference

ImageReference

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

UpgradeState

A frissítés aktuális állapotát jelző kód.

endTime

string

A frissítés befejezési időpontja.

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ós rendszer frissítési előzményei művelet 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ési előzmények következő oldalának lekéréséhez.

value

UpgradeOperationHistoricalStatusInfo[]

A virtuálisgép-méretezési csoportban végrehajtott operációsrendszer-frissítések listája.