Virtual Machine Scale Sets - Get OS Upgrade History
Ottiene l'elenco degli aggiornamenti del sistema operativo in un'istanza del set di scalabilità di macchine virtuali.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2024-03-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
resource
|
path | True |
string |
Nome del gruppo di risorse. |
subscription
|
path | True |
string |
Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio. |
vm
|
path | True |
string |
Nome del set di scalabilità di macchine virtuali. |
api-version
|
query | True |
string |
Versione api client. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
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": [
{}
]
}
Definizioni
Nome | Descrizione |
---|---|
Api |
Errore dell'API. |
Api |
Base degli errori api. |
Cloud |
Risposta di errore dal servizio di calcolo. |
Image |
Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione. NOTA: l'autore e l'offerta di riferimento alle immagini possono essere impostati solo quando si crea il set di scalabilità. |
Inner |
Dettagli dell'errore interno. |
Rollback |
Informazioni sul rollback nelle istanze di macchina virtuale non riuscite dopo un'operazione di aggiornamento del sistema operativo. |
Rolling |
Informazioni sul numero di istanze di macchina virtuale in ogni stato di aggiornamento. |
Upgrade |
Risposta dell'operazione cronologia aggiornamento del set di scalabilità di macchine virtuali. |
Upgrade |
Descrive ogni aggiornamento del sistema operativo nel set di scalabilità di macchine virtuali. |
Upgrade |
Informazioni sullo stato di esecuzione corrente dell'aggiornamento complessivo. |
Upgrade |
Invoker dell'operazione di aggiornamento |
Upgrade |
Codice che indica lo stato corrente dell'aggiornamento. |
Virtual |
Elenco della risposta dell'operazione cronologia aggiornamento del sistema operativo del set di scalabilità di macchine virtuali. |
ApiError
Errore dell'API.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore dell'API |
|
innererror |
Errore interno dell'API |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore specifico. |
ApiErrorBase
Base degli errori api.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore specifico. |
CloudError
Risposta di errore dal servizio di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
error |
Errore dell'API. |
ImageReference
Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione. NOTA: l'autore e l'offerta di riferimento alle immagini possono essere impostati solo quando si crea il set di scalabilità.
Nome | Tipo | Descrizione |
---|---|---|
communityGalleryImageId |
string |
Specifica l'ID univoco dell'immagine della raccolta della community per la distribuzione di macchine virtuali. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta della community. |
exactVersion |
string |
Specifica i numeri decimali, la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. Questo campo di sola lettura è diverso da 'version', solo se il valore specificato nel campo 'version' è 'latest'. |
id |
string |
ID risorsa |
offer |
string |
Specifica l'offerta dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. |
publisher |
string |
Autore dell'immagine. |
sharedGalleryImageId |
string |
Specifica l'ID univoco dell'immagine della raccolta condivisa per la distribuzione della macchina virtuale. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta condivisa. |
sku |
string |
SKU dell'immagine. |
version |
string |
Specifica la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. I formati consentiti sono Major.Minor.Build o 'latest'. Major, Minor e Build sono numeri decimali. Specificare "latest" per usare la versione più recente di un'immagine disponibile in fase di distribuzione. Anche se si usa 'latest', l'immagine della macchina virtuale non verrà aggiornata automaticamente dopo la distribuzione anche se una nuova versione diventa disponibile. Non usare il campo 'version' per la distribuzione di immagini della raccolta, l'immagine della raccolta deve sempre usare il campo 'id' per la distribuzione, per usare la versione più recente dell'immagine della raccolta, è sufficiente impostare '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' nel campo 'id' senza input della versione. |
InnerError
Dettagli dell'errore interno.
Nome | Tipo | Descrizione |
---|---|---|
errordetail |
string |
Messaggio di errore interno o dump delle eccezioni. |
exceptiontype |
string |
Tipo di eccezione. |
RollbackStatusInfo
Informazioni sul rollback nelle istanze di macchina virtuale non riuscite dopo un'operazione di aggiornamento del sistema operativo.
Nome | Tipo | Descrizione |
---|---|---|
failedRolledbackInstanceCount |
integer |
Numero di istanze di cui non è stato possibile eseguire il rollback. |
rollbackError |
Dettagli errore se il rollback del sistema operativo non è riuscito. |
|
successfullyRolledbackInstanceCount |
integer |
Numero di istanze di cui è stato eseguito il rollback. |
RollingUpgradeProgressInfo
Informazioni sul numero di istanze di macchina virtuale in ogni stato di aggiornamento.
Nome | Tipo | Descrizione |
---|---|---|
failedInstanceCount |
integer |
Numero di istanze che non sono state aggiornate correttamente. |
inProgressInstanceCount |
integer |
Numero di istanze attualmente in fase di aggiornamento. |
pendingInstanceCount |
integer |
Numero di istanze che non sono ancora state aggiornate. |
successfulInstanceCount |
integer |
Numero di istanze aggiornate correttamente. |
UpgradeOperationHistoricalStatusInfo
Risposta dell'operazione cronologia aggiornamento del set di scalabilità di macchine virtuali.
Nome | Tipo | Descrizione |
---|---|---|
location |
string |
Posizione risorsa |
properties |
Informazioni sulle proprietà dell'operazione di aggiornamento. |
|
type |
string |
Tipo di risorsa |
UpgradeOperationHistoricalStatusInfoProperties
Descrive ogni aggiornamento del sistema operativo nel set di scalabilità di macchine virtuali.
Nome | Tipo | Descrizione |
---|---|---|
error |
Dettagli errore per questo aggiornamento, se presenti. |
|
progress |
Conteggio delle macchine virtuali in ogni stato. |
|
rollbackInfo |
Informazioni sul rollback del sistema operativo se eseguito |
|
runningStatus |
Informazioni sullo stato complessivo dell'operazione di aggiornamento. |
|
startedBy |
Invoker dell'operazione di aggiornamento |
|
targetImageReference |
Dettagli di riferimento sulle immagini |
UpgradeOperationHistoryStatus
Informazioni sullo stato di esecuzione corrente dell'aggiornamento complessivo.
Nome | Tipo | Descrizione |
---|---|---|
code |
Codice che indica lo stato corrente dell'aggiornamento. |
|
endTime |
string |
Ora di fine dell'aggiornamento. |
startTime |
string |
Ora di inizio dell'aggiornamento. |
UpgradeOperationInvoker
Invoker dell'operazione di aggiornamento
Nome | Tipo | Descrizione |
---|---|---|
Platform |
string |
|
Unknown |
string |
|
User |
string |
UpgradeState
Codice che indica lo stato corrente dell'aggiornamento.
Nome | Tipo | Descrizione |
---|---|---|
Cancelled |
string |
|
Completed |
string |
|
Faulted |
string |
|
RollingForward |
string |
VirtualMachineScaleSetListOSUpgradeHistory
Elenco della risposta dell'operazione cronologia aggiornamento del sistema operativo del set di scalabilità di macchine virtuali.
Nome | Tipo | Descrizione |
---|---|---|
nextLink |
string |
URI per recuperare la pagina successiva della cronologia di aggiornamento del sistema operativo. Chiamare ListNext() per recuperare la pagina successiva della cronologia degli aggiornamenti. |
value |
Elenco degli aggiornamenti del sistema operativo eseguiti nel set di scalabilità di macchine virtuali. |