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

vmScaleSetName
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

VirtualMachineScaleSetListOSUpgradeHistory

OKÉ

Other Status Codes

CloudError

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

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

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
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. 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.

InnerError

Belső hiba részletei.

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.

RollingUpgradeProgressInfo

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

UpgradeOperationHistoricalStatusInfo

Virtuálisgép-méretezési csoport operációsrendszer-frissítési előzményeinek műveleti válasza.

UpgradeOperationHistoricalStatusInfoProperties

A virtuálisgép-méretezési csoport minden operációsrendszer-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ó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

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. 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

ApiError

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

UpgradeOperationHistoricalStatusInfoProperties

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

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

A frissítési művelet általános állapotával kapcsolatos információk.

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

UpgradeOperationHistoricalStatusInfo[]

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