Virtual Machines - Reimage
Ricrea l'immagine (aggiorna il sistema operativo) di una macchina virtuale che non dispone di un disco OS temporaneo, per le macchine virtuali che dispongono di un disco OS temporaneo la macchina virtuale viene ripristinata allo stato iniziale. NOTA: il mantenimento del disco del sistema operativo precedente dipende dal valore di deleteOption del disco del sistema operativo. Se deleteOption è scollegato, il disco del sistema operativo precedente verrà mantenuto dopo la ricreazione dell'immagine. Se deleteOption viene eliminato, il disco del sistema operativo precedente verrà eliminato dopo la ricreazione dell'immagine. L'opzione deleteOption del disco del sistema operativo deve essere aggiornata di conseguenza prima di eseguire la ricreazione dell'immagine.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/reimage?api-version=2025-11-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
path | True |
string minLength: 1 |
ID della sottoscrizione di destinazione. |
|
vm
|
path | True |
string |
Nome della macchina virtuale. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| exactVersion |
string |
Specifica in numero decimale la versione in cui deve essere ricreata l'immagine del disco del sistema operativo. Se non viene specificata la versione esatta, il disco del sistema operativo viene ricreato l'immagine sulla versione esistente del disco del sistema operativo. |
| osProfile |
Specifica le informazioni necessarie per la ricreazione dell'immagine del disco del sistema operativo non temporaneo. |
|
| tempDisk |
boolean |
Specifica se creare nuovamente l'immagine del disco temporaneo. Valore predefinito: false. Nota: questo parametro di reimage del disco temporaneo è supportato solo per VM/VMSS con disco del sistema operativo temporaneo. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
La richiesta ha avuto esito positivo. |
|
| 202 Accepted |
Operazione sulle risorse accettata. Intestazioni
|
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
| Reimage a Non-Ephemeral Virtual Machine. |
| Reimage a Virtual Machine. |
Reimage a Non-Ephemeral Virtual Machine.
Esempio di richiesta
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2025-11-01
{
"tempDisk": true,
"exactVersion": "aaaaaa",
"osProfile": {
"adminPassword": "{your-password}",
"customData": "{your-custom-data}"
}
}
Risposta di esempio
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2025-04-01
Reimage a Virtual Machine.
Esempio di richiesta
Risposta di esempio
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2025-04-01
Definizioni
| Nome | Descrizione |
|---|---|
|
Api |
Errore API. |
|
Api |
Base di errore API. |
|
Cloud |
Risposta di errore dal servizio di calcolo. |
|
Inner |
Dettagli dell'errore interno. |
|
OSProfile |
Parametri aggiuntivi per la reimaging di macchine virtuali non temporanee. |
|
Virtual |
Parametri per la reimaging della macchina virtuale. NOTA: il disco del sistema operativo della macchina virtuale verrà sempre ricreato |
ApiError
Errore API.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore Api |
|
| innererror |
L'errore interno dell'API |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore specifico. |
ApiErrorBase
Base di errore 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 API. |
InnerError
Dettagli dell'errore interno.
| Nome | Tipo | Descrizione |
|---|---|---|
| errordetail |
string |
Messaggio di errore interno o dump di eccezione. |
| exceptiontype |
string |
Tipo di eccezione. |
OSProfileProvisioningData
Parametri aggiuntivi per la reimaging di macchine virtuali non temporanee.
| Nome | Tipo | Descrizione |
|---|---|---|
| adminPassword |
string (password) |
Specifica la password dell'account amministratore. |
| customData |
string |
Specifica una stringa con codifica base 64 di dati personalizzati. La stringa con codifica base 64 viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è di 65535 byte. Nota: non passare segreti o password nella proprietà customData. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. La proprietà customData viene passata alla macchina virtuale per essere salvata come file, per altre informazioni, vedere Dati personalizzati nelle macchine virtuali di Azure. Se si usa cloud-init per la macchina virtuale Linux, vedere Uso di cloud-init per personalizzare una macchina virtuale Linux durante la creazione. |
VirtualMachineReimageParameters
Parametri per la reimaging della macchina virtuale. NOTA: il disco del sistema operativo della macchina virtuale verrà sempre ricreato
| Nome | Tipo | Descrizione |
|---|---|---|
| exactVersion |
string |
Specifica in numero decimale la versione in cui deve essere ricreata l'immagine del disco del sistema operativo. Se non viene specificata la versione esatta, il disco del sistema operativo viene ricreato l'immagine sulla versione esistente del disco del sistema operativo. |
| osProfile |
Specifica le informazioni necessarie per la ricreazione dell'immagine del disco del sistema operativo non temporaneo. |
|
| tempDisk |
boolean |
Specifica se creare nuovamente l'immagine del disco temporaneo. Valore predefinito: false. Nota: questo parametro di reimage del disco temporaneo è supportato solo per VM/VMSS con disco del sistema operativo temporaneo. |