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 |
---|---|---|---|---|
resource
|
path | True |
string |
Nome del gruppo di risorse. |
subscription
|
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. |
vm
|
path | True |
string |
Nome della macchina virtuale. |
api-version
|
query | True |
string |
Versione dell'API client. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
parameters |
Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Accettato Intestazioni Location: string |
|
Other Status Codes |
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
Virtual |
Virtual |
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 |
---|---|
Api |
Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco. |
Api |
Errore dell'API. |
Api |
Base degli errori api. |
Attach |
Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale. |
Caching |
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. |
Cloud |
Risposta di errore dal servizio di calcolo. |
Data |
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. |
Data |
Elenco di dischi dati gestiti da collegare. |
Data |
Elenco di dischi dati gestiti da scollegare. |
Diff |
Specifica le impostazioni temporanee del disco per il disco del sistema operativo. |
Diff |
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. |
Diff |
Specifica le impostazioni temporanee del disco per il disco del sistema operativo usato dalla macchina virtuale. |
Disk |
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. |
Disk |
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. |
Disk |
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. |
Disk |
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'. |
Disk |
Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito. |
Disk |
Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15. |
Image |
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. |
Inner |
Dettagli dell'errore interno. |
Key |
Specifica il percorso della chiave di crittografia della chiave in Key Vault. |
Key |
Specifica il percorso della chiave di crittografia del disco, ovvero un segreto dell'insieme di credenziali delle chiavi. |
Managed |
Parametri del disco gestito. |
Operating |
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. |
security |
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. |
Storage |
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. |
Storage |
Specifica le impostazioni di archiviazione per i dischi delle macchine virtuali. |
Sub |
|
Virtual |
Disco rigido virtuale. |
VMDisk |
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 |
Dettagli dell'errore dell'API |
|
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 |
Elenco di dischi dati gestiti da collegare. |
|
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Parametri del disco gestito. |
|
name |
string |
Nome del disco. |
sourceResource |
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 |
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 |
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 |
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 |
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 |
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 |
Specifica le impostazioni temporanee del disco per il disco del sistema operativo. |
|
placement |
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 |
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 |
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 |
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 |
URL relativo dell'insieme di credenziali delle chiavi contenente il segreto. |
ManagedDiskParameters
Parametri del disco gestito.
Nome | Tipo | Descrizione |
---|---|---|
diskEncryptionSet |
Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito. |
|
id |
string |
ID risorsa |
securityProfile |
Specifica il profilo di sicurezza per il disco gestito. |
|
storageAccountType |
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 |
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 |
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 |
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 |
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 |
Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15. |
|
image |
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 |
Parametri del disco gestito. |
|
name |
string |
Nome del disco. |
osType |
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 |
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 |
Data |
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 |
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 |
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 |
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 |
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 |
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. |