Virtual Machine Scale Sets - Reimage
Ricreazione dell'immagine (aggiornamento del sistema operativo) di una o più macchine virtuali in un set di scalabilità di macchine virtuali che non hanno un disco temporaneo del sistema operativo, per le macchine virtuali che dispongono di un disco temporaneo del sistema operativo, la macchina virtuale viene reimpostata sullo stato iniziale.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/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 del set di scalabilità di macchine virtuali. |
|
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. |
| forceUpdateOSDiskForEphemeral |
boolean |
Parametro per forzare l'aggiornamento del disco del sistema operativo temporaneo per una macchina virtuale del set di scalabilità di macchine virtuali |
| instanceIds |
string[] |
ID istanza del set di scalabilità di macchine virtuali. L'omissione degli ID istanza del set di scalabilità di macchine virtuali comporterà l'esecuzione dell'operazione in tutte le macchine virtuali nel set di scalabilità di macchine virtuali. |
| 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
|
Virtual |
|
Virtual |
VirtualMachineScaleSet_Reimage_MaximumSet_Gen
Esempio di richiesta
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2025-11-01
{
"instanceIds": [
"aaaaaaaaaa"
],
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
Risposta di esempio
location: https://foo.com/operationstatus
VirtualMachineScaleSet_Reimage_MinimumSet_Gen
Esempio di richiesta
Risposta di esempio
location: https://foo.com/operationstatus
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 |
Descrive i parametri di reimage di una macchina virtuale del set di scalabilità di macchine virtuali. |
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. |
VirtualMachineScaleSetReimageParameters
Descrive i parametri di reimage di una macchina virtuale del set di scalabilità di macchine virtuali.
| 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. |
| forceUpdateOSDiskForEphemeral |
boolean |
Parametro per forzare l'aggiornamento del disco del sistema operativo temporaneo per una macchina virtuale del set di scalabilità di macchine virtuali |
| instanceIds |
string[] |
ID istanza del set di scalabilità di macchine virtuali. L'omissione degli ID istanza del set di scalabilità di macchine virtuali comporterà l'esecuzione dell'operazione in tutte le macchine virtuali nel set di scalabilità di macchine virtuali. |
| 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. |