Condividi tramite


Virtual Machines - Attach Detach Data Disks

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
path True

string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.

vmName
path True

string

Nome della macchina virtuale.

api-version
query True

string

Versione dell'API client.

Corpo della richiesta

Nome Tipo Descrizione
parameters

AttachDetachDataDisksRequest

Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale.

Risposte

Nome Tipo Descrizione
200 OK

StorageProfile

OK

202 Accepted

Accettato

Intestazioni

Location: string

Other Status Codes

CloudError

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

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen
VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Esempio di richiesta

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2024-07-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

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
    }
  ]
}
location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Esempio di richiesta

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2024-07-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

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
    }
  ]
}
location: https://foo.com/operationstatus

Definizioni

Nome Descrizione
ApiEntityReference

Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.

ApiError

Errore dell'API.

ApiErrorBase

Base degli errori api.

AttachDetachDataDisksRequest

Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale.

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.

CloudError

Risposta di errore dal servizio di calcolo.

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.

DataDisksToAttach

Elenco di dischi dati gestiti da collegare.

DataDisksToDetach

Elenco di dischi dati gestiti da scollegare.

DiffDiskOptions

Specifica le impostazioni temporanee del disco per il disco del sistema operativo.

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.

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.

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.

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.

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.

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. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.

DiskEncryptionSettings

Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.

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.

InnerError

Dettagli dell'errore interno.

KeyVaultKeyReference

Specifica il percorso della chiave di crittografia della chiave in Key Vault.

KeyVaultSecretReference

Specifica il percorso della chiave di crittografia del disco, ovvero un segreto dell'insieme di credenziali delle chiavi.

ManagedDiskParameters

Parametri del disco gestito.

OperatingSystemTypes

Tipo di sistema operativo.

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. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.

StorageProfile

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

SubResource
VirtualHardDisk

Disco rigido virtuale.

VMDiskSecurityProfile

Specifica il profilo di sicurezza per il disco gestito.

ApiEntityReference

Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.

Nome Tipo Descrizione
id

string

ID risorsa ARM sotto forma di /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Errore dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

details

ApiErrorBase[]

Dettagli dell'errore dell'API

innererror

InnerError

Errore interno dell'API

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

AttachDetachDataDisksRequest

Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale.

Nome Tipo Descrizione
dataDisksToAttach

DataDisksToAttach[]

Elenco di dischi dati gestiti da collegare.

dataDisksToDetach

DataDisksToDetach[]

Elenco di dischi dati gestiti da scollegare.

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.

Nome Tipo Descrizione
None

string

ReadOnly

string

ReadWrite

string

CloudError

Risposta di errore dal servizio di calcolo.

Nome Tipo Descrizione
error

ApiError

Errore dell'API.

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.

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. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.

diskIOPSReadWrite

integer

Specifica il Read-Write operazioni di I/O al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi delle macchine virtuali VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.

diskMBpsReadWrite

integer

Specifica la larghezza di banda in MB al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi delle macchine virtuali VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.

diskSizeGB

integer

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

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.

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

Elenco di dischi dati gestiti 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

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

Elenco di dischi dati gestiti 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

Specifica le impostazioni temporanee del disco per il disco del sistema operativo.

Nome Tipo Descrizione
Local

string

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.

Nome Tipo Descrizione
CacheDisk

string

NvmeDisk

string

ResourceDisk

string

DiffDiskSettings

Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale.

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

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.

Nome Tipo Descrizione
NVMe

string

SCSI

string

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.

Nome Tipo Descrizione
Attach

string

Copy

string

Empty

string

FromImage

string

Restore

string

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.

Nome Tipo Descrizione
Delete

string

Detach

string

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. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.

Nome Tipo Descrizione
ForceDetach

string

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.

Nome Tipo Descrizione
id

string

ID risorsa

DiskEncryptionSettings

Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.

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

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.

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 usata 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

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump delle eccezioni.

exceptiontype

string

Tipo di eccezione.

KeyVaultKeyReference

Specifica il percorso della chiave di crittografia della chiave in 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

Specifica il percorso della chiave di crittografia del disco, ovvero un segreto dell'insieme di credenziali delle chiavi.

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

Parametri del 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

Tipo di sistema operativo.

Nome Tipo Descrizione
Linux

string

Windows

string

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.

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

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.

vhd

VirtualHardDisk

Disco rigido virtuale.

writeAcceleratorEnabled

boolean

Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

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.

Nome Tipo Descrizione
DiskWithVMGuestState

string

NonPersistedTPM

string

VMGuestStateOnly

string

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.

Nome Tipo Descrizione
PremiumV2_LRS

string

Premium_LRS

string

Premium_ZRS

string

StandardSSD_LRS

string

StandardSSD_ZRS

string

Standard_LRS

string

UltraSSD_LRS

string

StorageProfile

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

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

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

Nome Tipo Descrizione
id

string

ID risorsa

VirtualHardDisk

Disco rigido virtuale.

Nome Tipo Descrizione
uri

string

Specifica l'URI del disco rigido virtuale.

VMDiskSecurityProfile

Specifica il profilo di sicurezza per il disco gestito.

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.