Virtual Machine Scale Sets - Get OS Upgrade History

Hämtar en lista över OS-uppgraderingar på en vm-skalningsuppsättningsinstans.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2024-03-01

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen.

subscriptionId
path True

string

Prenumerationsautentiseringsuppgifter som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

vmScaleSetName
path True

string

Namnet på VM-skalningsuppsättningen.

api-version
query True

string

Klient-API-version.

Svar

Name Typ Description
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

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 personifiera ditt användarkonto

Exempel

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": [
    {}
  ]
}

Definitioner

Name Description
ApiError

API-fel.

ApiErrorBase

Api-felbas.

CloudError

Ett felsvar från Beräkningstjänsten.

ImageReference

Anger information om avbildningen som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder. Obs! Bildreferensutgivare och -erbjudande kan bara anges när du skapar skalningsuppsättningen.

InnerError

Inre felinformation.

RollbackStatusInfo

Information om återställning på misslyckade VM-instanser efter en operativsystemuppgraderingsåtgärd.

RollingUpgradeProgressInfo

Information om antalet virtuella datorinstanser i varje uppgraderingstillstånd.

UpgradeOperationHistoricalStatusInfo

Åtgärdssvar för vm-skalningsuppsättningens historik för operativsystemuppgradering.

UpgradeOperationHistoricalStatusInfoProperties

Beskriver varje os-uppgradering på VM-skalningsuppsättningen.

UpgradeOperationHistoryStatus

Information om aktuellt körningstillstånd för den övergripande uppgraderingen.

UpgradeOperationInvoker

Anropare för uppgraderingsåtgärden

UpgradeState

Kod som anger uppgraderingens aktuella status.

VirtualMachineScaleSetListOSUpgradeHistory

Lista över åtgärdssvar för historik för vm-skalningsuppsättningens historik för operativsystemuppgradering.

ApiError

API-fel.

Name Typ Description
code

string

Felkoden.

details

ApiErrorBase[]

Api-felinformationen

innererror

InnerError

Api:ets inre fel

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

ApiErrorBase

Api-felbas.

Name Typ Description
code

string

Felkoden.

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

CloudError

Ett felsvar från Beräkningstjänsten.

Name Typ Description
error

ApiError

API-fel.

ImageReference

Anger information om avbildningen som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder. Obs! Bildreferensutgivare och -erbjudande kan bara anges när du skapar skalningsuppsättningen.

Name Typ Description
communityGalleryImageId

string

Angav communitygalleriets unika ID för vm-distribution. Detta kan hämtas från communitygalleriet bild GET-anrop.

exactVersion

string

Anger i decimaltal, version av plattformsbild eller Marketplace-avbildning som används för att skapa den virtuella datorn. Det här skrivskyddade fältet skiljer sig från "version", endast om värdet som anges i "versionsfältet" är "senaste".

id

string

Resurs-ID

offer

string

Anger erbjudandet för plattformsbilden eller marketplace-avbildningen som används för att skapa den virtuella datorn.

publisher

string

Bildutgivaren.

sharedGalleryImageId

string

Angav det unika ID:t för den delade galleriavbildningen för vm-distribution. Detta kan hämtas från get-anropet för den delade galleribilden.

sku

string

Avbildnings-SKU:n.

version

string

Anger versionen av plattformsbilden eller marketplace-avbildningen som används för att skapa den virtuella datorn. De tillåtna formaten är Major.Minor.Build eller "senaste". Major, Minor och Build är decimaltal. Ange "senaste" för att använda den senaste versionen av en avbildning som är tillgänglig vid distributionstillfället. Även om du använder "senaste" uppdateras inte vm-avbildningen automatiskt efter distributionstiden, även om en ny version blir tillgänglig. Använd inte fältet "version" för distribution av galleribilder. Galleribild bör alltid använda id-fältet för distribution, för att använda den senaste versionen av galleribilden. Ange bara "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}" i fältet "id" utan indata från versionen.

InnerError

Inre felinformation.

Name Typ Description
errordetail

string

Det interna felmeddelandet eller undantagsdumpen.

exceptiontype

string

Undantagstypen.

RollbackStatusInfo

Information om återställning på misslyckade VM-instanser efter en operativsystemuppgraderingsåtgärd.

Name Typ Description
failedRolledbackInstanceCount

integer

Antalet instanser som inte kunde återställas.

rollbackError

ApiError

Felinformation om återställningen av operativsystemet misslyckades.

successfullyRolledbackInstanceCount

integer

Antalet instanser som har återställts.

RollingUpgradeProgressInfo

Information om antalet virtuella datorinstanser i varje uppgraderingstillstånd.

Name Typ Description
failedInstanceCount

integer

Antalet instanser som inte har uppgraderats.

inProgressInstanceCount

integer

Antalet instanser som för närvarande uppgraderas.

pendingInstanceCount

integer

Antalet instanser som ännu inte har börjat uppgraderas.

successfulInstanceCount

integer

Antalet instanser som har uppgraderats.

UpgradeOperationHistoricalStatusInfo

Åtgärdssvar för vm-skalningsuppsättningens historik för operativsystemuppgradering.

Name Typ Description
location

string

Resursplats

properties

UpgradeOperationHistoricalStatusInfoProperties

Information om egenskaperna för uppgraderingsåtgärden.

type

string

Resurstyp

UpgradeOperationHistoricalStatusInfoProperties

Beskriver varje os-uppgradering på VM-skalningsuppsättningen.

Name Typ Description
error

ApiError

Felinformation för den här uppgraderingen om det finns några.

progress

RollingUpgradeProgressInfo

Antal virtuella datorer i varje tillstånd.

rollbackInfo

RollbackStatusInfo

Information om återställning av operativsystem om det utförs

runningStatus

UpgradeOperationHistoryStatus

Information om uppgraderingsåtgärdens övergripande status.

startedBy

UpgradeOperationInvoker

Anropare för uppgraderingsåtgärden

targetImageReference

ImageReference

Information om bildreferens

UpgradeOperationHistoryStatus

Information om aktuellt körningstillstånd för den övergripande uppgraderingen.

Name Typ Description
code

UpgradeState

Kod som anger uppgraderingens aktuella status.

endTime

string

Sluttid för uppgraderingen.

startTime

string

Starttid för uppgraderingen.

UpgradeOperationInvoker

Anropare för uppgraderingsåtgärden

Name Typ Description
Platform

string

Unknown

string

User

string

UpgradeState

Kod som anger uppgraderingens aktuella status.

Name Typ Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Lista över åtgärdssvar för historik för vm-skalningsuppsättningens historik för operativsystemuppgradering.

Name Typ Description
nextLink

string

URI:n för att hämta nästa sida i historiken för operativsystemuppgradering. Anropa ListNext() med detta för att hämta nästa sida med historik för uppgraderingar.

value

UpgradeOperationHistoricalStatusInfo[]

Listan över OS-uppgraderingar som utförs på vm-skalningsuppsättningen.