Virtual Machine Scale Sets - Get OS Upgrade History

Ruft eine Liste der Betriebssystemupgrades für eine VM-Skalierungsgruppe instance ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

vmScaleSetName
path True

string

Der Name der VM-Skalierungsgruppe.

api-version
query True

string

Client-API-Version.

Antworten

Name Typ Beschreibung
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

OK

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

Name Beschreibung
ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

CloudError

Eine Fehlerantwort des Computediensts.

ImageReference

Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder VM-Images angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein VM-Image verwenden möchten, wird aber nicht in anderen Erstellungsvorgängen verwendet. HINWEIS: Herausgeber und Angebot für Bildreferenzen können nur festgelegt werden, wenn Sie die Skalierungsgruppe erstellen.

InnerError

Details zu inneren Fehlern.

RollbackStatusInfo

Informationen zum Rollback für fehlerhafte VM-Instanzen nach einem Betriebssystemupgradevorgang.

RollingUpgradeProgressInfo

Informationen zur Anzahl der VM-Instanzen in jedem Upgradestatus.

UpgradeOperationHistoricalStatusInfo

Antwort auf den Vorgangsverlauf des Vorgangs "VM-Skalierungsgruppe für betriebssystemskalieren".

UpgradeOperationHistoricalStatusInfoProperties

Beschreibt jedes Betriebssystemupgrade für die VM-Skalierungsgruppe.

UpgradeOperationHistoryStatus

Informationen zum aktuellen Ausführungsstatus des gesamten Upgrades.

UpgradeOperationInvoker

Aufruf des Upgradevorgangs

UpgradeState

Code, der die aktuelle status des Upgrades angibt.

VirtualMachineScaleSetListOSUpgradeHistory

Liste der Antwort des Vorgangs "Upgradeverlauf" für die VM-Skalierungsgruppe.

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Details zu API-Fehlern

innererror

InnerError

Innerer API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

CloudError

Eine Fehlerantwort des Computediensts.

Name Typ Beschreibung
error

ApiError

API-Fehler.

ImageReference

Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder VM-Images angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein VM-Image verwenden möchten, wird aber nicht in anderen Erstellungsvorgängen verwendet. HINWEIS: Herausgeber und Angebot für Bildreferenzen können nur festgelegt werden, wenn Sie die Skalierungsgruppe erstellen.

Name Typ Beschreibung
communityGalleryImageId

string

Geben Sie die eindeutige ID des Communitykatalogimages für die VM-Bereitstellung an. Dies kann vom GET-Aufruf des Communitykatalogimages abgerufen werden.

exactVersion

string

Gibt in Dezimalzahlen die Version des Plattformimages oder Marketplace-Images an, die zum Erstellen des virtuellen Computers verwendet wird. Dieses schreibgeschützte Feld unterscheidet sich von "version", nur wenn der im Feld "version" angegebene Wert "latest" lautet.

id

string

Ressourcen-ID

offer

string

Gibt das Angebot des Plattformimages oder Marketplace-Images an, das zum Erstellen des virtuellen Computers verwendet wird.

publisher

string

Der Imageherausgeber.

sharedGalleryImageId

string

Geben Sie die eindeutige ID des freigegebenen Katalogimages für die VM-Bereitstellung an. Dies kann über den GET-Aufruf des freigegebenen Katalogimages abgerufen werden.

sku

string

Die Bild-SKU.

version

string

Gibt die Version des Plattformimages oder Marketplace-Images an, das zum Erstellen des virtuellen Computers verwendet wird. Die zulässigen Formate sind Major.Minor.Build oder "latest". Haupt-, Neben- und Build sind Dezimalzahlen. Geben Sie „latest“ an, damit Sie die neueste Version eines Images verwenden können, das zum Zeitpunkt der Bereitstellung verfügbar ist. Selbst wenn Sie "latest" verwenden, wird das VM-Image nach der Bereitstellung nicht automatisch aktualisiert, auch wenn eine neue Version verfügbar ist. Verwenden Sie das Feld "version" nicht für die Bereitstellung von Katalogimages. Das Katalogimage sollte immer das Feld "id" für die Bereitstellung verwenden, um die neueste Version des Katalogimages zu verwenden. Legen Sie einfach "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}" im Feld "id" ohne Versionseingabe fest.

InnerError

Details zu inneren Fehlern.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.

exceptiontype

string

Der Ausnahmetyp.

RollbackStatusInfo

Informationen zum Rollback für fehlerhafte VM-Instanzen nach einem Betriebssystemupgradevorgang.

Name Typ Beschreibung
failedRolledbackInstanceCount

integer

Die Anzahl der Instanzen, für die ein Rollback fehlgeschlagen ist.

rollbackError

ApiError

Fehlerdetails, wenn ein Rollback des Betriebssystems fehlgeschlagen ist.

successfullyRolledbackInstanceCount

integer

Die Anzahl der Instanzen, für die ein Rollback erfolgreich ausgeführt wurde.

RollingUpgradeProgressInfo

Informationen zur Anzahl der VM-Instanzen in jedem Upgradestatus.

Name Typ Beschreibung
failedInstanceCount

integer

Die Anzahl der Instanzen, die nicht erfolgreich aktualisiert werden konnten.

inProgressInstanceCount

integer

Die Anzahl der Instanzen, die gerade aktualisiert werden.

pendingInstanceCount

integer

Die Anzahl der Instanzen, die noch nicht mit dem Upgrade begonnen haben.

successfulInstanceCount

integer

Die Anzahl der Instanzen, die erfolgreich aktualisiert wurden.

UpgradeOperationHistoricalStatusInfo

Antwort auf den Vorgangsverlauf des Vorgangs "VM-Skalierungsgruppe für betriebssystemskalieren".

Name Typ Beschreibung
location

string

Ressourcenspeicherort

properties

UpgradeOperationHistoricalStatusInfoProperties

Informationen zu den Eigenschaften des Upgradevorgangs.

type

string

Ressourcentyp

UpgradeOperationHistoricalStatusInfoProperties

Beschreibt jedes Betriebssystemupgrade für die VM-Skalierungsgruppe.

Name Typ Beschreibung
error

ApiError

Fehlerdetails für dieses Upgrade, falls vorhanden.

progress

RollingUpgradeProgressInfo

Anzahl der VMs in jedem Zustand.

rollbackInfo

RollbackStatusInfo

Informationen zum Betriebssystemrollback bei Ausführung

runningStatus

UpgradeOperationHistoryStatus

Informationen zum allgemeinen status des Upgradevorgangs.

startedBy

UpgradeOperationInvoker

Aufruf des Upgradevorgangs

targetImageReference

ImageReference

Details zur Bildreferenz

UpgradeOperationHistoryStatus

Informationen zum aktuellen Ausführungsstatus des gesamten Upgrades.

Name Typ Beschreibung
code

UpgradeState

Code, der die aktuelle status des Upgrades angibt.

endTime

string

Endzeit des Upgrades.

startTime

string

Startzeit des Upgrades.

UpgradeOperationInvoker

Aufruf des Upgradevorgangs

Name Typ Beschreibung
Platform

string

Unknown

string

User

string

UpgradeState

Code, der die aktuelle status des Upgrades angibt.

Name Typ Beschreibung
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Liste der Antwort des Vorgangs "Upgradeverlauf" für die VM-Skalierungsgruppe.

Name Typ Beschreibung
nextLink

string

Der URI zum Abrufen der nächsten Seite des Betriebssystemupgradeverlaufs. Rufen Sie ListNext() auf, um die nächste Seite des Verlaufs von Upgrades abzurufen.

value

UpgradeOperationHistoricalStatusInfo[]

Die Liste der Betriebssystemupgrades, die für die VM-Skalierungsgruppe ausgeführt werden.