Delen via


Virtual Machine Scale Sets - Get OS Upgrade History

Hiermee haalt u een lijst met besturingssysteemupgrades op voor een VM-schaalsetexemplaren.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

vmScaleSetName
path True

string

De naam van de VM-schaalset.

api-version
query True

string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "value": [
    {}
  ]
}

Definities

Name Description
ApiError

Api-fout.

ApiErrorBase

Api-foutbasis.

CloudError

Een foutreactie van de Compute-service.

ImageReference

Hiermee geeft u informatie over de te gebruiken afbeelding. U kunt informatie opgeven over platforminstallatiekopieën, marketplace-installatiekopieën of installatiekopieën van virtuele machines. Dit element is vereist wanneer u een platforminstallatiekopie, marketplace-installatiekopie of installatiekopie van virtuele machines wilt gebruiken, maar niet wordt gebruikt in andere bewerkingen voor het maken. OPMERKING: De uitgever en aanbieding van afbeeldingsreferentie kunnen alleen worden ingesteld wanneer u de schaalset maakt.

InnerError

Interne foutdetails.

RollbackStatusInfo

Informatie over het terugdraaien van mislukte VM-exemplaren na een upgradebewerking van het besturingssysteem.

RollingUpgradeProgressInfo

Informatie over het aantal exemplaren van virtuele machines in elke upgradestatus.

UpgradeOperationHistoricalStatusInfo

Antwoord van bewerking voor upgradegeschiedenis van virtuele-machineschaalset.

UpgradeOperationHistoricalStatusInfoProperties

Beschrijft elke upgrade van het besturingssysteem in de virtuele-machineschaalset.

UpgradeOperationHistoryStatus

Informatie over de huidige status van de algehele upgrade.

UpgradeOperationInvoker

Aanroeper van de upgradebewerking

UpgradeState

Code die de huidige status van de upgrade aangeeft.

VirtualMachineScaleSetListOSUpgradeHistory

Lijst met bewerkingsreacties voor upgradegeschiedenis van virtuele-machineschaalset.

ApiError

Api-fout.

Name Type Description
code

string

De foutcode.

details

ApiErrorBase[]

Details van de API-fout

innererror

InnerError

De interne API-fout

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

ApiErrorBase

Api-foutbasis.

Name Type Description
code

string

De foutcode.

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

CloudError

Een foutreactie van de Compute-service.

Name Type Description
error

ApiError

Api-fout.

ImageReference

Hiermee geeft u informatie over de te gebruiken afbeelding. U kunt informatie opgeven over platforminstallatiekopieën, marketplace-installatiekopieën of installatiekopieën van virtuele machines. Dit element is vereist wanneer u een platforminstallatiekopie, marketplace-installatiekopie of installatiekopie van virtuele machines wilt gebruiken, maar niet wordt gebruikt in andere bewerkingen voor het maken. OPMERKING: De uitgever en aanbieding van afbeeldingsreferentie kunnen alleen worden ingesteld wanneer u de schaalset maakt.

Name Type Description
communityGalleryImageId

string

De unieke id van de communitygalerie opgegeven voor vm-implementatie. Dit kan worden opgehaald uit de get-aanroep van de communitygalerieafbeelding.

exactVersion

string

Hiermee geeft u de decimale getallen op, de versie van de platforminstallatiekopieën of marketplace-installatiekopieën die worden gebruikt om de virtuele machine te maken. Dit alleen-lezen veld verschilt van 'version', alleen als de waarde die is opgegeven in het veld 'version' 'latest' is.

id

string

Resource-id

offer

string

Hiermee geeft u de aanbieding op van de platforminstallatiekopieën of marketplace-installatiekopieën die worden gebruikt om de virtuele machine te maken.

publisher

string

De uitgever van de installatiekopieën.

sharedGalleryImageId

string

De unieke id van de gedeelde galerie-installatiekopieën opgegeven voor vm-implementatie. Dit kan worden opgehaald uit de get-aanroep van de installatiekopieën in de gedeelde galerie.

sku

string

De installatiekopieën-SKU.

version

string

Hiermee geeft u de versie van de platforminstallatiekopieën of marketplace-installatiekopieën op die worden gebruikt om de virtuele machine te maken. De toegestane indelingen zijn Major.Minor.Build of 'latest'. Primaire, secundaire en build zijn decimale getallen. Geef 'nieuwste' op om de nieuwste versie van een installatiekopieën te gebruiken die beschikbaar is tijdens de implementatie. Zelfs als u 'nieuwste' gebruikt, wordt de VM-installatiekopie niet automatisch bijgewerkt na de implementatietijd, zelfs niet als er een nieuwe versie beschikbaar is. Gebruik het veld 'version' niet voor de implementatie van galerieafbeeldingen, de galerie-installatiekopieën moeten altijd het veld Id gebruiken voor implementatie, als u de meest recente versie van de galerie-installatiekopieën wilt gebruiken, stelt u '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' in het veld Id in zonder versie-invoer.

InnerError

Interne foutdetails.

Name Type Description
errordetail

string

Het interne foutbericht of de uitzonderingsdump.

exceptiontype

string

Het uitzonderingstype.

RollbackStatusInfo

Informatie over het terugdraaien van mislukte VM-exemplaren na een upgradebewerking van het besturingssysteem.

Name Type Description
failedRolledbackInstanceCount

integer

Het aantal exemplaren dat niet kan worden teruggedraaid.

rollbackError

ApiError

Foutdetails als het terugdraaien van het besturingssysteem is mislukt.

successfullyRolledbackInstanceCount

integer

Het aantal exemplaren dat is teruggedraaid.

RollingUpgradeProgressInfo

Informatie over het aantal exemplaren van virtuele machines in elke upgradestatus.

Name Type Description
failedInstanceCount

integer

Het aantal exemplaren dat niet kan worden geüpgraded.

inProgressInstanceCount

integer

Het aantal exemplaren dat momenteel wordt bijgewerkt.

pendingInstanceCount

integer

Het aantal exemplaren dat nog niet is bijgewerkt.

successfulInstanceCount

integer

Het aantal exemplaren dat is bijgewerkt.

UpgradeOperationHistoricalStatusInfo

Antwoord van bewerking voor upgradegeschiedenis van virtuele-machineschaalset.

Name Type Description
location

string

Resourcelocatie

properties

UpgradeOperationHistoricalStatusInfoProperties

Informatie over de eigenschappen van de upgradebewerking.

type

string

Resourcetype

UpgradeOperationHistoricalStatusInfoProperties

Beschrijft elke upgrade van het besturingssysteem in de virtuele-machineschaalset.

Name Type Description
error

ApiError

Foutdetails voor deze upgrade, indien aanwezig.

progress

RollingUpgradeProgressInfo

Telt de VM's in elke status.

rollbackInfo

RollbackStatusInfo

Informatie over terugdraaien van het besturingssysteem indien uitgevoerd

runningStatus

UpgradeOperationHistoryStatus

Informatie over de algemene status van de upgradebewerking.

startedBy

UpgradeOperationInvoker

Aanroeper van de upgradebewerking

targetImageReference

ImageReference

Details van afbeeldingsreferentie

UpgradeOperationHistoryStatus

Informatie over de huidige status van de algehele upgrade.

Name Type Description
code

UpgradeState

Code die de huidige status van de upgrade aangeeft.

endTime

string

Eindtijd van de upgrade.

startTime

string

Begintijd van de upgrade.

UpgradeOperationInvoker

Aanroeper van de upgradebewerking

Name Type Description
Platform

string

Unknown

string

User

string

UpgradeState

Code die de huidige status van de upgrade aangeeft.

Name Type Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Lijst met bewerkingsreacties voor upgradegeschiedenis van virtuele-machineschaalset.

Name Type Description
nextLink

string

De URI voor het ophalen van de volgende pagina van de upgradegeschiedenis van het besturingssysteem. Roep ListNext() aan om de volgende pagina met de geschiedenis van upgrades op te halen.

value

UpgradeOperationHistoricalStatusInfo[]

De lijst met upgrades van het besturingssysteem die worden uitgevoerd op de virtuele-machineschaalset.