Virtual Machines - Attach Detach Data Disks

Servizio:: Compute

Versione API:: 2026-04-01

Collegare e scollegare dischi dati da e verso la macchina virtuale.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/attachDetachDataDisks?api-version=2026-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
dataDisksToAttach	DataDisksToAttach[]	Elenco di dischi dati gestiti da collegare.
dataDisksToDetach	DataDisksToDetach[]	Elenco di dischi dati gestiti da scollegare.

Risposte

Nome	Tipo	Descrizione
200 OK	StorageProfile	Operazione Azure completata con successo.
202 Accepted		Operazione sulle risorse accettata. Intestazioni Location: string Retry-After: integer
Other Status Codes	CloudError	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

StorageProfile

Operazione Azure completata con successo.

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	impersonare il tuo account utente

Esempio

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2026-04-01

{
  "dataDisksToAttach": [
    {
      "lun": 1,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadOnly",
      "deleteOption": "Delete",
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadWrite",
      "deleteOption": "Detach",
      "writeAcceleratorEnabled": false
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
      "detachOption": "ForceDetach"
    },
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z",
      "detachOption": "ForceDetach"
    }
  ]
}

Risposta di esempio

Codice di stato:: 200

location: https://foo.com/operationstatus

{
  "imageReference": {
    "publisher": "MicrosoftWindowsServer",
    "offer": "WindowsServer",
    "sku": "2016-Datacenter",
    "version": "latest"
  },
  "osDisk": {
    "osType": "Windows",
    "name": "myOsDisk",
    "createOption": "FromImage",
    "caching": "ReadWrite",
    "managedDisk": {
      "storageAccountType": "Premium_LRS",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"
    },
    "diskSizeGB": 30
  },
  "dataDisks": [
    {
      "lun": 1,
      "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "createOption": "Attach",
      "caching": "ReadOnly",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
        "diskEncryptionSet": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
        }
      },
      "deleteOption": "Delete",
      "diskSizeGB": 30,
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "name": "vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "createOption": "Attach",
      "caching": "ReadWrite",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
        "diskEncryptionSet": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
        }
      },
      "deleteOption": "Detach",
      "diskSizeGB": 100,
      "writeAcceleratorEnabled": false
    }
  ]
}

Codice di stato:: 202

location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2026-04-01

{
  "dataDisksToAttach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"
    }
  ]
}

Risposta di esempio

Codice di stato:: 200

location: https://foo.com/operationstatus

{
  "imageReference": {
    "publisher": "MicrosoftWindowsServer",
    "offer": "WindowsServer",
    "sku": "2016-Datacenter",
    "version": "latest"
  },
  "osDisk": {
    "osType": "Windows",
    "name": "myOsDisk",
    "createOption": "FromImage",
    "caching": "ReadWrite",
    "managedDisk": {
      "storageAccountType": "Premium_LRS",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"
    },
    "diskSizeGB": 30
  },
  "dataDisks": [
    {
      "lun": 0,
      "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "createOption": "Attach",
      "caching": "ReadWrite",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
      },
      "diskSizeGB": 30
    }
  ]
}

Codice di stato:: 202

location: https://foo.com/operationstatus

Definizioni

Nome	Descrizione
AdditionalDiskProperties	Specifica proprietà aggiuntive per un disco gestito che possono essere impostate al momento della creazione implicita del disco.
ApiEntityReference	Informazioni di riferimento sulle entità API.
ApiError	Errore API.
ApiErrorBase	Base di errore API.
AttachDetachDataDisksRequest	Specifica l'input per collegare e scollegare un elenco di dischi dati gestiti.
AvailabilityPolicyDiskDelay	Determina come gestire i dischi con operazioni di I/O lente.
CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium
CloudError	Risposta di errore dal servizio di calcolo.
DataDisk	Descrive un disco dati.
DataDisksToAttach	Descrive il disco dati da collegare.
DataDisksToDetach	Descrive il disco dati da scollegare.
DiffDiskOptions	Specifica l'opzione disco temporaneo per il disco del sistema operativo.
DiffDiskPlacement	Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. Questa proprietà può essere utilizzata dall'utente nella richiesta per scegliere la posizione, ad esempio il disco della cache, il disco delle risorse o lo spazio su disco nvme per il provisioning del disco del sistema operativo temporaneo. Per ulteriori informazioni sui requisiti di dimensione del disco di Ephemeral OS, si prega di consultare i requisiti di dimensione disco di Ephemeral OS per Windows VM a https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e VM Linux a https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Versione minima api per NvmeDisk: 2024-03-01.
DiffDiskSettings	Descrive i parametri delle impostazioni temporanee del disco che possono essere specificate per il disco del sistema operativo. Nota: Le impostazioni temporanee del disco possono essere specificate solo per il disco gestito.
DiskApiVersion	Specifica la versione dell'API Disk utilizzata nell'applicazione di ProprietàDiskDisk aggiuntive ai dischi gestiti. Il valore deve essere nel formato YYYY-MM-DD.
DiskAvailabilityPolicy	In caso di problemi di disponibilità o connettività con il disco, specifica il comportamento della tua VM.
DiskControllerTypes	Specifica il tipo di controller del disco configurato per la macchina virtuale e VirtualMachineScaleSet. Questa proprietà è supportata solo per macchine virtuali il cui sistema operativo disco e sku VM supportano la Generazione 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), si prega di verificare la funzionalità HyperVGenerations restituita come parte delle capacità VM SKU nella risposta di Microsoft. L'API degli SKU di calcolo per la regione contiene V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Per altre informazioni sui tipi di controller disco supportati, vedere https://aka.ms/azure-diskcontrollertypes.
DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza. Vuoto: Questo valore viene usato durante la creazione di un disco dati vuoto. Copia: Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Restore: Questo valore viene usato per creare un disco dati da un punto di ripristino del disco.
DiskDeleteOptionTypes	Specifica il comportamento del disco gestito quando la macchina virtuale viene eliminata, ad esempio se il disco gestito viene eliminato o scollegato. I valori supportati sono: Delete. Se viene usato questo valore, il disco gestito viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco gestito viene mantenuto dopo l'eliminazione della macchina virtuale. Versione minima api: 2021-03-01.
DiskDetachOptionTypes	Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. I valori supportati sono: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di resort per scollegare il disco forzatamente dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in anteprima. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.
DiskEncryptionSetParameters	Descrive il parametro dell'ID risorsa del set di crittografia dischi gestiti dal cliente che può essere specificato per il disco. Nota: L'ID risorsa del set di crittografia del disco può essere specificato solo per il disco gestito. Per altri dettagli, vedere https://aka.ms/mdssewithcmkoverview.
DiskEncryptionSettings	Descrive le impostazioni di crittografia per un disco
ImageReference	Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio 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 delle immagini possono essere impostati solo quando si crea il set di scalabilità.
InnerError	Dettagli dell'errore interno.
KeyVaultKeyReference	Descrive un riferimento alla chiave di Key Vault
KeyVaultSecretReference	Descrive un riferimento a Key Vault Secret
ManagedDiskParameters	Parametri di un disco gestito.
ManagedDiskProperties	Specifica le proprietà di un disco gestito che possono essere impostate al momento della creazione implicita del disco.
NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
OperatingSystemTypes	Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine personalizzata. I valori possibili sono: Windows,Linux.
OSDisk	Specifica informazioni sul disco del sistema operativo usato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
SecurityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.
StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. Il tipo di account di archiviazione del disco del sistema operativo gestito può essere impostato solo quando si crea il set di scalabilità. NOTA: UltraSSD_LRS può essere usato solo con dischi dati. Non può essere usato con il disco del sistema operativo. Standard_LRS usa HDD Standard. StandardSSD_LRS usa unità SSD Standard. Premium_LRS usa l'unità SSD Premium. UltraSSD_LRS usa il disco Ultra. Premium_ZRS usa l'archiviazione con ridondanza della zona SSD Premium. StandardSSD_ZRS usa l'archiviazione con ridondanza della zona SSD Standard. Per maggiori informazioni sui dischi supportati per protezione di Windows, si riferisce a https://docs.microsoft.com/azure/virtual-machines/windows/disks-types e, per Linux Macchine virtuali, si rifera a https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
StorageFaultDomainAlignmentType	Specifica il tipo di allineamento del dominio di errore di memoria per il disco.
StorageProfile	Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali.
SubResource
VirtualHardDisk	Descrive l'URI di un disco.
VMDiskSecurityProfile	Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate.

AdditionalDiskProperties

Oggetto

Specifica proprietà aggiuntive per un disco gestito che possono essere impostate al momento della creazione implicita del disco.

Nome	Tipo	Descrizione
managedDiskProperties	ManagedDiskProperties	Specifica le proprietà del disco gestito che possono essere impostate al momento della creazione implicita del disco.

ApiEntityReference

Oggetto

Informazioni di riferimento sulle entità API.

Nome	Tipo	Descrizione
id	string	ID risorsa ARM sotto forma di /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

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.

AttachDetachDataDisksRequest

Oggetto

Specifica l'input per collegare e scollegare un elenco di dischi dati gestiti.

Nome	Tipo	Descrizione
dataDisksToAttach	DataDisksToAttach[]	Elenco di dischi dati gestiti da collegare.
dataDisksToDetach	DataDisksToDetach[]	Elenco di dischi dati gestiti da scollegare.

AvailabilityPolicyDiskDelay

Enumerazione

Determina come gestire i dischi con operazioni di I/O lente.

Valore	Descrizione
None	Comporta di default senza specifica la policy di disponibilità, ovvero riavvio della VM su I/O disco lento.
AutomaticReattach	In caso di guasto dell'I/O del disco o di una risposta lenta, prova a staccare e poi ricollegare il disco.

CachingTypes

Enumerazione

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. I valori predefiniti sono: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium

Valore	Descrizione
None
ReadOnly
ReadWrite

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore API.

DataDisk

Oggetto

Descrive un disco dati.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare il disco dati della macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza. Vuoto: Questo valore viene usato durante la creazione di un disco dati vuoto. Copia: Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Restore: Questo valore viene usato per creare un disco dati da un punto di ripristino del disco.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco dati deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Delete. Se si usa questo valore, il disco dati viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco dati viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach.
detachOption	DiskDetachOptionTypes	Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di resort per scollegare il disco forzatamente dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in anteprima. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.
diskIOPSReadWrite	integer (int64)	Specifica il Read-Write operazioni di I/O al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS.
diskMBpsReadWrite	integer (int64)	Specifica la larghezza di banda in MB al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS.
diskSizeGB	integer (int32)	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
image	VirtualHardDisk	Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se sourceImage è specificato, il disco rigido virtuale di destinazione non deve esistere.
lun	integer (int32)	Specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato a una macchina virtuale.
managedDisk	ManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
sourceResource	ApiEntityReference	Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Specifica il tipo di allineamento del dominio di errore di memoria per il disco.
toBeDetached	boolean	Specifica se il disco dati è in corso di scollegamento da VirtualMachine/VirtualMachineScaleset
vhd	VirtualHardDisk	Disco rigido virtuale.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

DataDisksToAttach

Oggetto

Descrive il disco dati da collegare.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco dati deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Delete. Se si usa questo valore, il disco dati viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco dati viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach.
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
diskId	string	ID del disco dati gestito.
lun	integer (int32)	Numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato a una macchina virtuale. Se non specificato, lun verrebbe assegnato automaticamente.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

DataDisksToDetach

Oggetto

Descrive il disco dati da scollegare.

Nome	Tipo	Descrizione
detachOption	DiskDetachOptionTypes	Opzioni supportate per Scollegare un disco da una macchina virtuale. Per altri dettagli, vedere Riferimento all'oggetto DetachOption.
diskId	string	ID del disco dati gestito.

DiffDiskOptions

Enumerazione

Specifica l'opzione disco temporaneo per il disco del sistema operativo.

Valore	Descrizione
Local

DiffDiskPlacement

Enumerazione

Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. Questa proprietà può essere utilizzata dall'utente nella richiesta per scegliere la posizione, ad esempio il disco della cache, il disco delle risorse o lo spazio su disco nvme per il provisioning del disco del sistema operativo temporaneo. Per ulteriori informazioni sui requisiti di dimensione del disco di Ephemeral OS, si prega di consultare i requisiti di dimensione disco di Ephemeral OS per Windows VM a https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e VM Linux a https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Versione minima api per NvmeDisk: 2024-03-01.

Valore	Descrizione
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Oggetto

Descrive i parametri delle impostazioni temporanee del disco che possono essere specificate per il disco del sistema operativo. Nota: Le impostazioni temporanee del disco possono essere specificate solo per il disco gestito.

Nome	Tipo	Descrizione
enableFullCaching	boolean	Specifica se abilitare o meno la cache completa per questa VM, che memorizzerà localmente il disco del sistema operativo sull'host e renderà questa VM più resistente alle interruzioni di storage
option	DiffDiskOptions	Specifica le impostazioni temporanee del disco per il disco del sistema operativo.
placement	DiffDiskPlacement	Specifica il posizionamento temporaneo del disco per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: cacheDisk se ne è configurato uno per le dimensioni della macchina virtuale in caso contrario viene usato ResourceDisk o NvmeDisk. Vedere la documentazione relativa alle dimensioni della macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e alla macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare le dimensioni delle macchine virtuali che espongono un disco della cache. Versione minima api per NvmeDisk: 2024-03-01.

DiskApiVersion

Enumerazione

Specifica la versione dell'API Disk utilizzata nell'applicazione di ProprietàDiskDisk aggiuntive ai dischi gestiti. Il valore deve essere nel formato YYYY-MM-DD.

Valore	Descrizione
2025-01-02	La versione API Disk RP 2025-01-025.
2026-03-02	La versione 2026-03-03-API API.

DiskAvailabilityPolicy

Oggetto

In caso di problemi di disponibilità o connettività con il disco, specifica il comportamento della tua VM.

Nome	Tipo	Descrizione
actionOnDiskDelay	AvailabilityPolicyDiskDelay	Determina come gestire i dischi con operazioni di I/O lente.

DiskControllerTypes

Enumerazione

Specifica il tipo di controller del disco configurato per la macchina virtuale e VirtualMachineScaleSet. Questa proprietà è supportata solo per macchine virtuali il cui sistema operativo disco e sku VM supportano la Generazione 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), si prega di verificare la funzionalità HyperVGenerations restituita come parte delle capacità VM SKU nella risposta di Microsoft. L'API degli SKU di calcolo per la regione contiene V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Per altre informazioni sui tipi di controller disco supportati, vedere https://aka.ms/azure-diskcontrollertypes.

Valore	Descrizione
SCSI
NVMe

DiskCreateOptionTypes

Enumerazione

Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza. Vuoto: Questo valore viene usato durante la creazione di un disco dati vuoto. Copia: Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Restore: Questo valore viene usato per creare un disco dati da un punto di ripristino del disco.

Valore	Descrizione
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Enumerazione

Specifica il comportamento del disco gestito quando la macchina virtuale viene eliminata, ad esempio se il disco gestito viene eliminato o scollegato. I valori supportati sono: Delete. Se viene usato questo valore, il disco gestito viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco gestito viene mantenuto dopo l'eliminazione della macchina virtuale. Versione minima api: 2021-03-01.

Valore	Descrizione
Delete
Detach

DiskDetachOptionTypes

Enumerazione

Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. I valori supportati sono: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di resort per scollegare il disco forzatamente dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in anteprima. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.

Valore	Descrizione
ForceDetach

DiskEncryptionSetParameters

Oggetto

Descrive il parametro dell'ID risorsa del set di crittografia dischi gestiti dal cliente che può essere specificato per il disco. Nota: L'ID risorsa del set di crittografia del disco può essere specificato solo per il disco gestito. Per altri dettagli, vedere https://aka.ms/mdssewithcmkoverview.

Nome	Tipo	Descrizione
id	string	ID risorsa

DiskEncryptionSettings

Oggetto

Descrive le impostazioni di crittografia per un disco

Nome	Tipo	Descrizione
diskEncryptionKey	KeyVaultSecretReference	Specifica il percorso della chiave di crittografia del disco, ovvero un segreto dell'insieme di credenziali delle chiavi.
enabled	boolean	Specifica se la crittografia del disco deve essere abilitata nella macchina virtuale.
keyEncryptionKey	KeyVaultKeyReference	Specifica il percorso della chiave di crittografia della chiave in Key Vault.

ImageReference

Oggetto

Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio 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 delle immagini possono essere impostati solo quando si crea il set di scalabilità.

Nome	Tipo	Descrizione
communityGalleryImageId	string	È stato specificato 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, in numeri decimali, la versione dell'immagine della piattaforma o dell'immagine del marketplace utilizzata 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	È stato specificato 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 diventa disponibile una nuova versione. Non usare il campo 'version' per la distribuzione di immagini della raccolta, l'immagine della raccolta deve usare sempre 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

Oggetto

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump di eccezione.
exceptiontype	string	Tipo di eccezione.

KeyVaultKeyReference

Oggetto

Descrive un riferimento alla chiave di Key Vault

Nome	Tipo	Descrizione
keyUrl	string	URL che fa riferimento a una chiave di crittografia della chiave in Key Vault.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente la chiave.

KeyVaultSecretReference

Oggetto

Descrive un riferimento a Key Vault Secret

Nome	Tipo	Descrizione
secretUrl	string	URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente il segreto.

ManagedDiskParameters

Oggetto

Parametri di un disco gestito.

Nome	Tipo	Descrizione
additionalDiskProperties	AdditionalDiskProperties	Specifica proprietà aggiuntive per il disco gestito che possono essere impostate al momento della creazione implicita del disco. Questa proprietà non è registrata per i Punti di Ripristino.
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
id	string	ID risorsa
securityProfile	VMDiskSecurityProfile	Specifica il profilo di sicurezza per il disco gestito.
storageAccountType	StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.

ManagedDiskProperties

Oggetto

Specifica le proprietà di un disco gestito che possono essere impostate al momento della creazione implicita del disco.

Nome	Tipo	Descrizione
availabilityPolicy	DiskAvailabilityPolicy	In caso di problemi di disponibilità o connettività con il disco, specifica il comportamento della tua VM.
burstingEnabled	boolean	Impostare su true per abilitare il bursting oltre la destinazione delle prestazioni con provisioning del disco. Il bursting è disabilitato per impostazione predefinita. Non si applica ai dischi Ultra.
diskAccessId	string	Azure resource Id della risorsa DiskAccess per l'uso di endpoint privati su dischi.
diskIOPSReadOnly	integer (int64)	Numero totale di operazioni di I/O al secondo consentite in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. Un'operazione può trasferire tra 4k e 256.000 byte.
diskMBpsReadOnly	integer (int64)	Velocità effettiva totale (MBps) che sarà consentita in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. MBps significa milioni di byte al secondo - MB qui usa la notazione ISO, di poteri di 10.
logicalSectorSize	integer (int32)	Dimensione del settore logico in byte per Ultra Disk. I valori supportati sono 512 e 4096. 4096 è l'impostazione predefinita.
maxShares	integer (int32) minimum: 1	Numero massimo di macchine virtuali che possono essere collegate al disco contemporaneamente. Il valore maggiore di uno indica un disco che può essere montato in più macchine virtuali contemporaneamente. Si applica solo ai dischi dati.
networkAccessPolicy	NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
optimizedForFrequentAttach	boolean	Impostare questa proprietà su true migliora l'affidabilità e le prestazioni dei dischi dati che vengono frequentemente (più di 5 volte al giorno) staccati da una macchina virtuale e collegati a un'altra. Questa proprietà non deve essere impostata per i dischi non scollegati e collegati frequentemente perché i dischi non sono allineati al dominio di errore della macchina virtuale.
performancePlus	boolean	Impostare questo flag su true per ottenere un aumento della destinazione delle prestazioni del disco distribuito. Questo flag può essere impostato solo in fase di creazione del disco e non può essere disabilitato dopo l'abilitazione.
tier	string	Livello di prestazioni del disco (ad esempio, P4, S10) come descritto qui: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Non si applica ai dischi Ultra.

NetworkAccessPolicy

Enumerazione

Criteri per l'accesso al disco tramite rete.

Valore	Descrizione
AllowAll	Il disco può essere esportato o caricato da qualsiasi rete.
AllowPrivate	Il disco può essere esportato o caricato utilizzando gli endpoint privati di una risorsa DiskAccess.
DenyAll	Impossibile esportare il disco.

OperatingSystemTypes

Enumerazione

Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine personalizzata. I valori possibili sono: Windows,Linux.

Valore	Descrizione
Windows
Linux

OSDisk

Oggetto

Specifica informazioni sul disco del sistema operativo usato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: Questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco del sistema operativo deve essere eliminato o scollegato dopo l'eliminazione della macchina virtuale. I valori possibili sono: Delete. Se si usa questo valore, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.
diffDiskSettings	DiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.
diskSizeGB	integer (int32)	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
encryptionSettings	DiskEncryptionSettings	Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.
image	VirtualHardDisk	Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se sourceImage è specificato, il disco rigido virtuale di destinazione non deve esistere.
managedDisk	ManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
osType	OperatingSystemTypes	Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine utente o un disco rigido virtuale specializzato. I valori possibili sono: Windows,Linux.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Specifica il tipo di allineamento del dominio di errore di memoria per il disco.
vhd	VirtualHardDisk	Disco rigido virtuale.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

SecurityEncryptionTypes

Enumerazione

Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.

Valore	Descrizione
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

Enumerazione

Specifica il tipo di account di archiviazione per il disco gestito. Il tipo di account di archiviazione del disco del sistema operativo gestito può essere impostato solo quando si crea il set di scalabilità. NOTA: UltraSSD_LRS può essere usato solo con dischi dati. Non può essere usato con il disco del sistema operativo. Standard_LRS usa HDD Standard. StandardSSD_LRS usa unità SSD Standard. Premium_LRS usa l'unità SSD Premium. UltraSSD_LRS usa il disco Ultra. Premium_ZRS usa l'archiviazione con ridondanza della zona SSD Premium. StandardSSD_ZRS usa l'archiviazione con ridondanza della zona SSD Standard. Per maggiori informazioni sui dischi supportati per protezione di Windows, si riferisce a https://docs.microsoft.com/azure/virtual-machines/windows/disks-types e, per Linux Macchine virtuali, si rifera a https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Valore	Descrizione
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageFaultDomainAlignmentType

Enumerazione

Specifica il tipo di allineamento del dominio di errore di memoria per il disco.

Valore	Descrizione
Aligned	I domini di errore di archiviazione disco sono mappati ai domini di errore di calcolo. Il deployment fallisce se il disco non supporta abbastanza domini di errore.
BestEffortAligned	Tenta di mappare i domini di errore di memoria a domini di errore calcolare. I dischi sono disallineati se il disco non supporta abbastanza domini di errore.

StorageProfile

Oggetto

Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali.

Nome	Tipo	Descrizione
alignRegionalDisksToVMZone	boolean	Specifica se i dischi a livello di area devono essere allineati/spostati nella zona della macchina virtuale. Questo è applicabile solo per le macchine virtuali con set di proprietà di posizionamento. Si noti che questa modifica è irreversibile. Versione minima api: 2024-11-01.
dataDisks	DataDisk[]	Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
diskApiVersion	DiskApiVersion	Specifica la versione dell'API Disk utilizzata nell'applicazione di ProprietàDiskDisk aggiuntive ai dischi gestiti. Il valore deve essere nel formato YYYY-MM-DD (ad esempio, "2026-03-02").
diskControllerType	DiskControllerTypes	Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller del disco predefinito se non specificata la macchina virtuale specificata viene creata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e delle dimensioni della macchina virtuale dalla versione minima dell'API specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.
imageReference	ImageReference	Specifica le informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini delle macchine virtuali. Questo elemento è obbligatorio 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.
osDisk	OSDisk	Specifica informazioni sul disco del sistema operativo usato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

SubResource

Oggetto

Nome	Tipo	Descrizione
id	string	ID risorsa

VirtualHardDisk

Oggetto

Descrive l'URI di un disco.

Nome	Tipo	Descrizione
uri	string	Specifica l'URI del disco rigido virtuale.

VMDiskSecurityProfile

Oggetto

Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito usato per il disco del sistema operativo ConfidentialVM crittografato con chiave gestita dal cliente e il BLOB VMGuest.
securityEncryptionType	SecurityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.