Virtual Machines - Attach Detach Data Disks

Servizio:: Compute

Versione API:: 2025-11-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=2025-11-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

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

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=2025-11-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=2025-11-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
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.
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	Viene descritto 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.
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 a Key Vault Key
KeyVaultSecretReference	Descrive un riferimento a Key Vault Secret
ManagedDiskParameters	Parametri di un disco gestito.
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 maggiori informazioni sui dischi, vedi Informazioni sui dischi e i VHD per Azure macchine virtuali.
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 Windows Virtual Machines, si riferisce a https://docs.microsoft.com/azure/virtual-machines/windows/disks-types e, per Linux Virtual Machines, 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.

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.

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

Viene descritto 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 di 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.

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 la posizione della chiave di crittografia del disco, che è un Key Vault Secret.
enabled	boolean	Specifica se la crittografia del disco deve essere abilitata nella macchina virtuale.
keyEncryptionKey	KeyVaultKeyReference	Specifica la posizione 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 differisce da 'versione', solo se il valore specificato nel campo 'versione' è 'più recente'.
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	L'immagine publisher.
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. Per favore, non usare il campo 'version' per il deployment dell'immagine galleria, l'immagine della galleria dovrebbe sempre usare il campo 'id' per il deployment; per usare la versione 'più recente' dell'immagine galleria, basta impostare '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/galleries/{galleryName}/images/{imageName}' nel campo 'id' senza input di 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 a Key Vault Key

Nome	Tipo	Descrizione
keyUrl	string	L'URL che fa riferimento a una chiave di cifratura della chiave in Key Vault.
sourceVault	SubResource	L'URL relativo del Key Vault che contiene la chiave.

KeyVaultSecretReference

Oggetto

Descrive un riferimento a Key Vault Secret

Nome	Tipo	Descrizione
secretUrl	string	L'URL che fa riferimento a un segreto in un Key Vault.
sourceVault	SubResource	L'URL relativo del Key Vault che contiene il segreto.

ManagedDiskParameters

Oggetto

Parametri di un disco gestito.

Nome	Tipo	Descrizione
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.

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 maggiori informazioni sui dischi, vedi Informazioni sui dischi e i VHD per Azure macchine virtuali.

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 Windows Virtual Machines, si riferisce a https://docs.microsoft.com/azure/virtual-machines/windows/disks-types e, per Linux Virtual Machines, 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 maggiori informazioni sui dischi, vedi Informazioni sui dischi e i VHD per Azure macchine virtuali.
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 maggiori informazioni sui dischi, vedi Informazioni sui dischi e i VHD per Azure macchine virtuali.

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.

Condividi tramite

Virtual Machines - Attach Detach Data Disks

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Esempio di richiesta

Risposta di esempio

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Esempio di richiesta

Risposta di esempio

Definizioni

ApiEntityReference

ApiError

ApiErrorBase

AttachDetachDataDisksRequest

CachingTypes

CloudError

DataDisk

DataDisksToAttach

DataDisksToDetach

DiffDiskOptions

DiffDiskPlacement

DiffDiskSettings

DiskControllerTypes

DiskCreateOptionTypes

DiskDeleteOptionTypes

DiskDetachOptionTypes

DiskEncryptionSetParameters

DiskEncryptionSettings

ImageReference

InnerError

KeyVaultKeyReference

KeyVaultSecretReference

ManagedDiskParameters

OperatingSystemTypes

OSDisk

SecurityEncryptionTypes

StorageAccountTypes

StorageFaultDomainAlignmentType

StorageProfile

SubResource

VirtualHardDisk

VMDiskSecurityProfile