Condividi tramite

Virtual Machines - Reimage

Servizio:
Compute
Versione API:
2025-04-01

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: la conservazione del vecchio disco del sistema operativo dipende dal valore di deleteOption del disco del sistema operativo. Se deleteOption è detach, il vecchio disco del sistema operativo verrà conservato dopo la ricreazione dell'immagine. Se deleteOption è delete, il vecchio disco del sistema operativo verrà eliminato dopo la ricreazione dell'immagine. Il deleteOption del disco del sistema operativo deve essere aggiornato 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-04-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId
 path True

string

minLength: 1

ID della sottoscrizione di destinazione.
vmName
 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

OSProfileProvisioningData

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 riimmagine del disco temporaneo è supportato solo per VM/VMSS con disco OS temporaneo.

Risposte

Nome Tipo Descrizione
200 OK

La richiesta è andata a buon fine.
202 Accepted

Operazione sulle risorse accettata.

Intestazioni

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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-04-01

{
  "tempDisk": true,
  "exactVersion": "aaaaaa",
  "osProfile": {
    "adminPassword": "{your-password}",
    "customData": "{your-custom-data}"
  }
}

Risposta di esempio

Codice di stato:
200
Codice di stato:
202 
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

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2025-04-01

{
  "tempDisk": true
}

Risposta di esempio

Codice di stato:
200
Codice di stato:
202 
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2025-04-01

Definizioni

Nome Descrizione
ApiError

Errore API.
ApiErrorBase

Base di errore API.
CloudError

Risposta di errore dal servizio di calcolo.
InnerError

Dettagli dell'errore interno.
OSProfileProvisioningData

Parametri aggiuntivi per la ricreazione dell'immagine di una macchina virtuale non temporanea.
VirtualMachineReimageParameters

Parametri per la ricreazione dell'immagine della macchina virtuale. NOTA: il disco del sistema operativo della macchina virtuale verrà sempre ricreato

ApiError

Oggetto

Errore API.

Nome Tipo Descrizione
code

string

Codice di errore.
details

ApiErrorBase[]

Dettagli dell'errore Api
innererror

InnerError

L'errore interno dell'API
message

string

Messaggio di errore.
target

string

Destinazione dell'errore specifico.

ApiErrorBase

Oggetto

Base di errore API.

Nome Tipo Descrizione
code

string

Codice di errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore specifico.

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome Tipo Descrizione
error

ApiError

Errore API.

InnerError

Oggetto

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump di eccezione.
exceptiontype

string

Tipo di eccezione.

OSProfileProvisioningData

Oggetto

Parametri aggiuntivi per la ricreazione dell'immagine di una macchina virtuale non temporanea.

Nome Tipo Descrizione
adminPassword

string (password)

Specifica la password dell'account amministratore.

Lunghezza minima (Windows): 8 caratteri

Lunghezza minima (Linux): 6 caratteri

Lunghezza massima (Windows): 123 caratteri

Lunghezza massima (Linux): 72 caratteri

requisiti di complessità: è necessario soddisfare 3 su 4 condizioni seguenti
Ha caratteri inferiori
Ha caratteri superiori
Ha una cifra
Ha un carattere speciale (corrispondenza regex [\W_])

Valori non consentiti: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"

Per reimpostare la password, vedere Come reimpostare il servizio Desktop remoto o la relativa password di accesso in una macchina virtuale Windows

Per reimpostare la password radice, vedere Gestire utenti, SSH e controllare o ripristinare i dischi in macchine virtuali Linux di Azure usando l'estensione VMAccess
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

Oggetto

Parametri per la ricreazione dell'immagine 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

OSProfileProvisioningData

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 riimmagine del disco temporaneo è supportato solo per VM/VMSS con disco OS temporaneo.