Condividi tramite


Virtual Machines - Reimage

Ricrea l'immagine (aggiornamento del sistema operativo) di una macchina virtuale che non dispone di un disco temporaneo del sistema operativo, per le macchine virtuali con un disco temporaneo del sistema operativo che la macchina virtuale viene reimpostata sullo 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=2024-03-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
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.

vmName
path True

string

Nome della macchina virtuale.

api-version
query True

string

Versione api client.

Corpo della richiesta

Nome Tipo Descrizione
parameters

VirtualMachineReimageParameters

Parametri forniti all'operazione Reimage Virtual Machine.

Risposte

Nome Tipo Descrizione
200 OK

OK

202 Accepted

Accettato

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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=2024-03-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=2024-03-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=2024-03-01

{
  "tempDisk": true
}

Risposta di esempio

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Definizioni

Nome Descrizione
ApiError

Errore dell'API.

ApiErrorBase

Base degli errori api.

CloudError

Risposta di errore dal servizio di calcolo.

InnerError

Dettagli dell'errore interno.

OSProfileProvisioningData

Specifica le informazioni necessarie per la ricreazione del disco del sistema operativo non temporaneo.

VirtualMachineReimageParameters

Parametri forniti all'operazione Reimage Virtual Machine.

ApiError

Errore dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

details

ApiErrorBase[]

Dettagli dell'errore dell'API

innererror

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

ApiError

Errore dell'API.

InnerError

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump delle eccezioni.

exceptiontype

string

Tipo di eccezione.

OSProfileProvisioningData

Specifica le informazioni necessarie per la ricreazione del disco del sistema operativo non temporaneo.

Nome Tipo Descrizione
adminPassword

string

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à: 3 su 4 condizioni seguenti devono essere soddisfatte
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 nelle macchine virtuali Linux di Azure usando l'estensione VMAccess

customData

string

Specifica una stringa con codifica in Base 64 di dati personalizzati. La stringa con codifica in Base 64 viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è 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 da salvare 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 forniti all'operazione Reimage Virtual Machine.

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 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 ricreazione dell'immagine del disco temporaneo è supportato solo per VM/VMSS con disco del sistema operativo temporaneo.