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 |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
vm
|
path | True |
string |
Der Name der VM-Skalierungsgruppe. |
api-version
|
query | True |
string |
Client-API-Version. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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
Virtual |
Virtual |
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 |
---|---|
Api |
API-Fehler. |
Api |
API-Fehlerbasis. |
Cloud |
Eine Fehlerantwort des Computediensts. |
Image |
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. |
Inner |
Details zu inneren Fehlern. |
Rollback |
Informationen zum Rollback für fehlerhafte VM-Instanzen nach einem Betriebssystemupgradevorgang. |
Rolling |
Informationen zur Anzahl der VM-Instanzen in jedem Upgradestatus. |
Upgrade |
Antwort auf den Vorgangsverlauf des Vorgangs "VM-Skalierungsgruppe für betriebssystemskalieren". |
Upgrade |
Beschreibt jedes Betriebssystemupgrade für die VM-Skalierungsgruppe. |
Upgrade |
Informationen zum aktuellen Ausführungsstatus des gesamten Upgrades. |
Upgrade |
Aufruf des Upgradevorgangs |
Upgrade |
Code, der die aktuelle status des Upgrades angibt. |
Virtual |
Liste der Antwort des Vorgangs "Upgradeverlauf" für die VM-Skalierungsgruppe. |
ApiError
API-Fehler.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Fehlercode. |
details |
Details zu API-Fehlern |
|
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 |
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 |
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 |
Informationen zu den Eigenschaften des Upgradevorgangs. |
|
type |
string |
Ressourcentyp |
UpgradeOperationHistoricalStatusInfoProperties
Beschreibt jedes Betriebssystemupgrade für die VM-Skalierungsgruppe.
Name | Typ | Beschreibung |
---|---|---|
error |
Fehlerdetails für dieses Upgrade, falls vorhanden. |
|
progress |
Anzahl der VMs in jedem Zustand. |
|
rollbackInfo |
Informationen zum Betriebssystemrollback bei Ausführung |
|
runningStatus |
Informationen zum allgemeinen status des Upgradevorgangs. |
|
startedBy |
Aufruf des Upgradevorgangs |
|
targetImageReference |
Details zur Bildreferenz |
UpgradeOperationHistoryStatus
Informationen zum aktuellen Ausführungsstatus des gesamten Upgrades.
Name | Typ | Beschreibung |
---|---|---|
code |
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 |
Die Liste der Betriebssystemupgrades, die für die VM-Skalierungsgruppe ausgeführt werden. |