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 |
---|---|---|---|---|
resource
|
path | True |
string |
Namnet på resursgruppen. |
subscription
|
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. |
vm
|
path | True |
string |
Namnet på VM-skalningsuppsättningen. |
api-version
|
query | True |
string |
Klient-API-version. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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
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": [
{}
]
}
Definitioner
Name | Description |
---|---|
Api |
API-fel. |
Api |
Api-felbas. |
Cloud |
Ett felsvar från Beräkningstjänsten. |
Image |
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. |
Inner |
Inre felinformation. |
Rollback |
Information om återställning på misslyckade VM-instanser efter en operativsystemuppgraderingsåtgärd. |
Rolling |
Information om antalet virtuella datorinstanser i varje uppgraderingstillstånd. |
Upgrade |
Åtgärdssvar för vm-skalningsuppsättningens historik för operativsystemuppgradering. |
Upgrade |
Beskriver varje os-uppgradering på VM-skalningsuppsättningen. |
Upgrade |
Information om aktuellt körningstillstånd för den övergripande uppgraderingen. |
Upgrade |
Anropare för uppgraderingsåtgärden |
Upgrade |
Kod som anger uppgraderingens aktuella status. |
Virtual |
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 |
Api-felinformationen |
|
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 |
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 |
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 |
Information om egenskaperna för uppgraderingsåtgärden. |
|
type |
string |
Resurstyp |
UpgradeOperationHistoricalStatusInfoProperties
Beskriver varje os-uppgradering på VM-skalningsuppsättningen.
Name | Typ | Description |
---|---|---|
error |
Felinformation för den här uppgraderingen om det finns några. |
|
progress |
Antal virtuella datorer i varje tillstånd. |
|
rollbackInfo |
Information om återställning av operativsystem om det utförs |
|
runningStatus |
Information om uppgraderingsåtgärdens övergripande status. |
|
startedBy |
Anropare för uppgraderingsåtgärden |
|
targetImageReference |
Information om bildreferens |
UpgradeOperationHistoryStatus
Information om aktuellt körningstillstånd för den övergripande uppgraderingen.
Name | Typ | Description |
---|---|---|
code |
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 |
Listan över OS-uppgraderingar som utförs på vm-skalningsuppsättningen. |