Disks - Create Or Update

Crea o aggiorna un disco.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/disks/{diskName}?api-version=2023-10-02

Parametri dell'URI

Nome In Necessario Tipo Descrizione
diskName
path True

string

Nome del disco gestito creato. Non è possibile modificare il nome dopo la creazione del disco. I caratteri supportati per il nome sono a-z, A-Z, 0-9, _ e -. La lunghezza massima del nome è di 80 caratteri.

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 di servizio.

api-version
query True

string

Versione dell'API client.

Corpo della richiesta

Nome Necessario Tipo Descrizione
location True

string

Posizione risorsa

properties.creationData True

CreationData

Informazioni sull'origine del disco. Le informazioni CreateData non possono essere modificate dopo la creazione del disco.

extendedLocation

ExtendedLocation

Percorso esteso in cui verrà creato il disco. Non è possibile modificare la posizione estesa.

properties.burstingEnabled

boolean

Impostare su true per abilitare il bursting oltre la destinazione delle prestazioni di cui è stato effettuato il provisioning del disco. Il bursting è disabilitato per impostazione predefinita. Non si applica ai dischi Ultra.

properties.completionPercent

number

Percentuale completata per la copia in background quando viene creata una risorsa tramite l'operazione CopyStart.

properties.dataAccessAuthMode

DataAccessAuthMode

Requisiti di autenticazione aggiuntivi durante l'esportazione o il caricamento in un disco o uno snapshot.

properties.diskAccessId

string

ID ARM della risorsa DiskAccess per l'uso di endpoint privati nei dischi.

properties.diskIOPSReadOnly

integer

Numero totale di operazioni di I/O al secondo consentite in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. Un'operazione può trasferire tra 4k e 256k byte.

properties.diskIOPSReadWrite

integer

Numero di operazioni di I/O al secondo consentite per questo disco; solo impostabile per i dischi UltraSD. Un'operazione può trasferire tra 4k e 256k byte.

properties.diskMBpsReadOnly

integer

Velocità effettiva totale (MBps) che sarà consentita in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. MBps significa milioni di byte al secondo: MB usa la notazione ISO, di 10 poteri.

properties.diskMBpsReadWrite

integer

Larghezza di banda consentita per questo disco; solo impostabile per i dischi UltraSD. MBps significa milioni di byte al secondo: MB usa la notazione ISO, di 10 poteri.

properties.diskSizeGB

integer

Se creationData.createOption è Vuoto, questo campo è obbligatorio e indica le dimensioni del disco da creare. Se questo campo è presente per gli aggiornamenti o la creazione con altre opzioni, indica un ridimensionamento. Le ridimensionazioni sono consentite solo se il disco non è collegato a una macchina virtuale in esecuzione e può aumentare solo le dimensioni del disco.

properties.encryption

Encryption

La proprietà di crittografia può essere usata per crittografare i dati inattivi con chiavi gestite dal cliente o chiavi gestite dalla piattaforma.

properties.encryptionSettingsCollection

EncryptionSettingsCollection

La raccolta di impostazioni di crittografia usata per Crittografia dischi di Azure può contenere più impostazioni di crittografia per disco o snapshot.

properties.hyperVGeneration

HyperVGeneration

Generazione di hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

properties.maxShares

integer

Numero massimo di macchine virtuali che possono connettersi al disco contemporaneamente. Il valore maggiore di uno indica un disco che può essere montato su più macchine virtuali contemporaneamente.

properties.networkAccessPolicy

NetworkAccessPolicy

Criteri per l'accesso al disco tramite rete.

properties.optimizedForFrequentAttach

boolean

L'impostazione di questa proprietà su true migliora l'affidabilità e le prestazioni dei dischi dati che sono spesso (più di 5 volte al giorno) scollegate da una macchina virtuale e collegate a un'altra. Questa proprietà non deve essere impostata per i dischi non scollegati e collegati frequentemente perché i dischi non sono allineati al dominio di errore della macchina virtuale.

properties.osType

OperatingSystemTypes

Tipo di sistema operativo.

properties.publicNetworkAccess

PublicNetworkAccess

Criteri per il controllo dell'esportazione sul disco.

properties.purchasePlan

PurchasePlan

Informazioni sul piano di acquisto per l'immagine da cui è stato creato il disco del sistema operativo. Ad esempio, {name: 2019-Datacenter, editore: MicrosoftWindowsServer, prodotto: WindowsServer}

properties.securityProfile

DiskSecurityProfile

Contiene le informazioni correlate alla sicurezza per la risorsa.

properties.supportedCapabilities

SupportedCapabilities

Elenco delle funzionalità supportate per l'immagine da cui è stato creato il disco del sistema operativo.

properties.supportsHibernation

boolean

Indica il sistema operativo in un disco che supporta l'ibernazione.

properties.tier

string

Livello di prestazioni del disco (ad esempio, P4, S10) come descritto di seguito: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Non si applica ai dischi Ultra.

sku

DiskSku

Nome sku dischi. Può essere Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.

tags

object

Tag delle risorse

zones

string[]

Elenco di zone logiche per Disco.

Risposte

Nome Tipo Descrizione
200 OK

Disk

OK

202 Accepted

Disk

Accettato

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Create a confidential VM supported disk encrypted with customer managed key
Create a managed disk and associate with disk access resource.
Create a managed disk and associate with disk encryption set.
Create a managed disk by copying a snapshot.
Create a managed disk by importing an unmanaged blob from a different subscription.
Create a managed disk by importing an unmanaged blob from the same subscription.
Create a managed disk from a platform image.
Create a managed disk from an Azure Compute Gallery community image.
Create a managed disk from an Azure Compute Gallery direct shared image.
Create a managed disk from an Azure Compute Gallery image.
Create a managed disk from an existing managed disk in the same or different subscription.
Create a managed disk from elastic san volume snapshot.
Create a managed disk from ImportSecure create option
Create a managed disk from UploadPreparedSecure create option
Create a managed disk with dataAccessAuthMode
Create a managed disk with optimizedForFrequentAttach.
Create a managed disk with performancePlus.
Create a managed disk with premium v2 account type.
Create a managed disk with security profile
Create a managed disk with ssd zrs account type.
Create a managed disk with ultra account type with readOnly property set.
Create a managed upload disk.
Create an empty managed disk in extended location.
Create an empty managed disk.
Create an ultra managed disk with logicalSectorSize 512E

Create a confidential VM supported disk encrypted with customer managed key

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithCustomerKey",
      "secureVMDiskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{diskEncryptionSetName}"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithCustomerKey",
      "secureVMDiskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{diskEncryptionSetName}"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithCustomerKey",
      "secureVMDiskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{diskEncryptionSetName}"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Create a managed disk and associate with disk access resource.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "networkAccessPolicy": "AllowPrivate",
    "diskAccessId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/{existing-diskAccess-name}"
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Succeeded",
    "networkAccessPolicy": "AllowPrivate",
    "diskAccessId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/{existing-diskAccess-name}",
    "publicNetworkAccess": "Enabled"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk and associate with disk encryption set.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "encryption": {
      "diskEncryptionSetId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Succeeded",
    "encryption": {
      "diskEncryptionSetId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
    }
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk by copying a snapshot.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot"
    }
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot"
    }
  }
}

Create a managed disk by importing an unmanaged blob from a different subscription.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Import",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Create a managed disk by importing an unmanaged blob from the same subscription.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Import",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Create a managed disk from a platform image.

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "purchasePlan": {
      "name": "{sku}",
      "publisher": "{publisher}",
      "product": "{offer}"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    },
    "provisioningState": "Updating"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "purchasePlan": {
      "name": "{sku}",
      "publisher": "{publisher}",
      "product": "{offer}"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "communityGalleryImageId": "/CommunityGalleries/{communityGalleryPublicGalleryName}/Images/{imageName}/Versions/1.0.0"
      }
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "communityGalleryImageId": "/CommunityGalleries/{communityGalleryPublicGalleryName}/Images/{imageName}/Versions/1.0.0"
      }
    },
    "provisioningState": "Updating"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "communityGalleryImageId": "/CommunityGalleries/{communityGalleryPublicGalleryName}/Images/{imageName}/Versions/1.0.0"
      }
    }
  }
}

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "sharedGalleryImageId": "/SharedGalleries/{sharedGalleryUniqueName}/Images/{imageName}/Versions/1.0.0"
      }
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "sharedGalleryImageId": "/SharedGalleries/{sharedGalleryUniqueName}/Images/{imageName}/Versions/1.0.0"
      }
    },
    "provisioningState": "Updating"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "sharedGalleryImageId": "/SharedGalleries/{sharedGalleryUniqueName}/Images/{imageName}/Versions/1.0.0"
      }
    }
  }
}

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "id": "/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Providers/Microsoft.Compute/Galleries/{galleryName}/Images/{imageName}/Versions/1.0.0"
      }
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "id": "/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Providers/Microsoft.Compute/Galleries/{galleryName}/Images/{imageName}/Versions/1.0.0"
      }
    },
    "provisioningState": "Updating"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "galleryImageReference": {
        "id": "/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Providers/Microsoft.Compute/Galleries/{galleryName}/Images/{imageName}/Versions/1.0.0"
      }
    }
  }
}

Create a managed disk from an existing managed disk in the same or different subscription.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk2?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk1"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk1"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk2"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk1"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk2"
}

Create a managed disk from elastic san volume snapshot.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "CopyFromSanSnapshot",
      "elasticSanResourceId": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ElasticSan/elasticSans/myElasticSan/volumegroups/myElasticSanVolumeGroup/snapshots/myElasticSanVolumeSnapshot"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "CopyFromSanSnapshot",
      "elasticSanResourceId": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ElasticSan/elasticSans/myElasticSan/volumegroups/myElasticSanVolumeGroup/snapshots/myElasticSanVolumeSnapshot"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "CopyFromSanSnapshot",
      "elasticSanResourceId": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ElasticSan/elasticSans/myElasticSan/volumegroups/myElasticSanVolumeGroup/snapshots/myElasticSanVolumeSnapshot"
    },
    "provisioningState": "Succeeded"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk from ImportSecure create option

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
    },
    "creationData": {
      "createOption": "ImportSecure",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
      "securityDataUri": "https://mystorageaccount.blob.core.windows.net/osimages/vmgs.vhd"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
    },
    "creationData": {
      "createOption": "ImportSecure",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
      "securityDataUri": "https://mystorageaccount.blob.core.windows.net/osimages/vmgs.vhd"
    }
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
    },
    "creationData": {
      "createOption": "ImportSecure",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
      "securityDataUri": "https://mystorageaccount.blob.core.windows.net/osimages/vmgs.vhd"
    }
  }
}

Create a managed disk from UploadPreparedSecure create option

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "UploadPreparedSecure",
      "uploadSizeBytes": 10737418752
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "UploadPreparedSecure",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "UploadPreparedSecure",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Succeeded"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk with dataAccessAuthMode

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "dataAccessAuthMode": "AzureActiveDirectory"
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Succeeded",
    "dataAccessAuthMode": "AzureActiveDirectory"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk with optimizedForFrequentAttach.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "optimizedForFrequentAttach": true
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating",
    "optimizedForFrequentAttach": true
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Succeeded",
    "optimizedForFrequentAttach": true
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk with performancePlus.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "performancePlus": true
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "performancePlus": true
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "performancePlus": true
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk with premium v2 account type.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myPremiumV2Disk?api-version=2023-10-02

{
  "location": "West US",
  "sku": {
    "name": "PremiumV2_LRS"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "diskIOPSReadWrite": 125,
    "diskMBpsReadWrite": 3000
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myPremiumV2Disk",
  "sku": {
    "name": "PremiumV2_LRS",
    "tier": "Premium"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myPremiumV2Disk",
  "sku": {
    "name": "PremiumV2_LRS",
    "tier": "Premium"
  }
}

Create a managed disk with security profile

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "North Central US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/uswest/Publishers/Microsoft/ArtifactTypes/VMImage/Offers/{offer}"
      }
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "North Central US",
  "properties": {
    "provisioningState": "Updating",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/uswest/Publishers/Microsoft/ArtifactTypes/VMImage/Offers/{offer}"
      }
    }
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "name": "myDisk",
  "location": "North Central US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/uswest/Publishers/Microsoft/ArtifactTypes/VMImage/Offers/{offer}"
      }
    }
  }
}

Create a managed disk with ssd zrs account type.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "sku": {
    "name": "Premium_ZRS"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "Premium_ZRS",
    "tier": "Premium"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "Premium_ZRS",
    "tier": "Premium"
  }
}

Create a managed disk with ultra account type with readOnly property set.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myUltraReadOnlyDisk?api-version=2023-10-02

{
  "location": "West US",
  "sku": {
    "name": "UltraSSD_LRS"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty",
      "logicalSectorSize": 4096
    },
    "diskSizeGB": 200,
    "diskIOPSReadWrite": 125,
    "diskMBpsReadWrite": 3000,
    "encryption": {
      "type": "EncryptionAtRestWithPlatformKey"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myUltraReadOnlyDisk",
  "sku": {
    "name": "UltraSSD_LRS",
    "tier": "Ultra"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating",
    "encryption": {
      "type": "EncryptionAtRestWithPlatformKey"
    }
  },
  "location": "West US",
  "name": "myUltraReadOnlyDisk",
  "sku": {
    "name": "UltraSSD_LRS",
    "tier": "Ultra"
  }
}

Create a managed upload disk.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "uploadSizeBytes": 10737418752
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}

Create an empty managed disk in extended location.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "extendedLocation": {
    "type": "EdgeZone",
    "name": "{edge-zone-id}"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "extendedLocation": {
    "type": "EdgeZone",
    "name": "{edge-zone-id}"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "extendedLocation": {
    "type": "EdgeZone",
    "name": "{edge-zone-id}"
  }
}

Create an empty managed disk.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}

Create an ultra managed disk with logicalSectorSize 512E

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2023-10-02

{
  "location": "West US",
  "sku": {
    "name": "UltraSSD_LRS"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty",
      "logicalSectorSize": 512
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty",
      "logicalSectorSize": 512
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "UltraSSD_LRS",
    "tier": "Ultra"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk",
  "properties": {
    "creationData": {
      "createOption": "Empty",
      "logicalSectorSize": 512
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "UltraSSD_LRS",
    "tier": "Ultra"
  }
}

Definizioni

Nome Descrizione
Architecture

Architettura della CPU supportata da un disco del sistema operativo.

CreationData

Dati usati durante la creazione di un disco.

DataAccessAuthMode

Requisiti di autenticazione aggiuntivi durante l'esportazione o il caricamento in un disco o uno snapshot.

Disk

Risorsa disco.

DiskCreateOption

In questo modo vengono enumerate le possibili origini della creazione di un disco.

DiskSecurityProfile

Contiene le informazioni relative alla sicurezza per la risorsa.

DiskSecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

DiskSku

Nome sku dei dischi. Può essere Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.

DiskState

In questo modo viene enumerato lo stato possibile del disco.

DiskStorageAccountTypes

Nome sku.

Encryption

Impostazioni di crittografia dei dati inattivi per disco o snapshot

EncryptionSettingsCollection

Impostazioni di crittografia per il disco o lo snapshot

EncryptionSettingsElement

Impostazioni di crittografia per un volume del disco.

EncryptionType

Tipo di chiave usata per crittografare i dati del disco.

ExtendedLocation

Tipo complesso della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

HyperVGeneration

Generazione di hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

ImageDiskReference

Immagine di origine usata per la creazione del disco.

KeyVaultAndKeyReference

Key Vault URL chiave e ID insieme di credenziali di KeK, KeK è facoltativo e, se specificato, viene usato per annullare ilrap della chiave di crittografiaKey

KeyVaultAndSecretReference

Key Vault l'URL segreto e l'ID dell'insieme di credenziali della chiave di crittografia

NetworkAccessPolicy

Criteri per l'accesso al disco tramite rete.

OperatingSystemTypes

Tipo di sistema operativo.

PropertyUpdatesInProgress

Proprietà del disco per cui l'aggiornamento è in sospeso.

ProvisionedBandwidthCopyOption

Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato a velocità più rapida.

PublicNetworkAccess

Criteri per il controllo dell'esportazione sul disco.

PurchasePlan

Usato per stabilire il contesto di acquisto di qualsiasi elemento di terze parti tramite MarketPlace.

ShareInfoElement
SourceVault

L'ID dell'insieme di credenziali è un ID risorsa di Azure Resource Manager nel formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

SupportedCapabilities

Elenco delle funzionalità supportate rese persistenti nella risorsa disco per l'uso della macchina virtuale.

Architecture

Architettura della CPU supportata da un disco del sistema operativo.

Nome Tipo Descrizione
Arm64

string

x64

string

CreationData

Dati usati durante la creazione di un disco.

Nome Tipo Descrizione
createOption

DiskCreateOption

In questo modo vengono enumerate le possibili origini della creazione di un disco.

elasticSanResourceId

string

Obbligatorio se createOption è CopyFromSanSnapshot. Questo è l'ID ARM dello snapshot del volume san elastico di origine.

galleryImageReference

ImageDiskReference

Obbligatorio se si crea da un'immagine della raccolta. L'id/sharedGalleryImageId/communityGalleryImageId di ImageDiskReference sarà l'ID ARM della versione condivisa dell'immagine di galleria da cui creare un disco.

imageReference

ImageDiskReference

Informazioni sull'origine del disco per le immagini PIR o utente.

logicalSectorSize

integer

Dimensioni del settore logico in byte per i dischi Ultra. I valori supportati sono 512 annunci 4096. 4096 è il valore predefinito.

performancePlus

boolean

Impostare questo flag su true per ottenere un incremento sulla destinazione delle prestazioni del disco distribuito, vedere qui sulla rispettiva destinazione delle prestazioni. Questo flag può essere impostato solo in fase di creazione del disco e non può essere disabilitato dopo l'abilitazione.

provisionedBandwidthCopySpeed

ProvisionedBandwidthCopyOption

Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida.

securityDataUri

string

Se createOption è ImportSecure, si tratta dell'URI di un BLOB da importare nello stato guest della macchina virtuale.

sourceResourceId

string

Se createOption è Copy, si tratta dell'ID ARM dello snapshot o del disco di origine.

sourceUniqueId

string

Se questo campo è impostato, questo è l'ID univoco che identifica l'origine della risorsa.

sourceUri

string

Se createOption è Import, si tratta dell'URI di un BLOB da importare in un disco gestito.

storageAccountId

string

Obbligatorio se createOption è Import. L'identificatore di Azure Resource Manager dell'account di archiviazione contenente il BLOB da importare come disco.

uploadSizeBytes

integer

Se createOption è Upload, si tratta delle dimensioni del contenuto del caricamento, incluso il piè di pagina del disco rigido virtuale. Questo valore deve essere compreso tra 20972032 (20 MiB + 512 byte per il piè di pagina del disco rigido virtuale) e 35183298347520 byte (32 TiB + 512 byte per il piè di pagina del disco rigido virtuale).

DataAccessAuthMode

Requisiti di autenticazione aggiuntivi durante l'esportazione o il caricamento in un disco o uno snapshot.

Nome Tipo Descrizione
AzureActiveDirectory

string

Quando viene usato l'URL di esportazione/caricamento, il sistema verifica se l'utente ha un'identità in Azure Active Directory e dispone delle autorizzazioni necessarie per esportare/caricare i dati. Fare riferimento a aka.ms/DisksAzureADAuth.

None

string

Nessuna autenticazione aggiuntiva verrà eseguita quando si accede all'URL di esportazione/caricamento.

Disk

Risorsa disco.

Nome Tipo Descrizione
extendedLocation

ExtendedLocation

Percorso esteso in cui verrà creato il disco. Non è possibile modificare la posizione estesa.

id

string

ID risorsa

location

string

Posizione risorsa

managedBy

string

URI relativo contenente l'ID della macchina virtuale a cui è collegato il disco.

managedByExtended

string[]

Elenco di URI relativi contenenti gli ID delle macchine virtuali collegate al disco. maxShares deve essere impostato su un valore maggiore di uno per i dischi per consentire il collegamento a più macchine virtuali.

name

string

Nome risorsa

properties.LastOwnershipUpdateTime

string

Ora UTC quando lo stato di proprietà del disco è stato modificato per l'ultima volta che il disco è stato collegato o scollegato da una macchina virtuale o dall'ora in cui è stata associata la macchina virtuale a cui è stato collegato il disco è stato deallocato o avviato.

properties.burstingEnabled

boolean

Impostare su true per abilitare il bursting oltre la destinazione delle prestazioni di cui è stato effettuato il provisioning del disco. Il bursting è disabilitato per impostazione predefinita. Non si applica ai dischi Ultra.

properties.burstingEnabledTime

string

Ultima volta che il bursting è stato abilitato per l'ultima volta in un disco.

properties.completionPercent

number

Percentuale completata per la copia in background quando viene creata una risorsa tramite l'operazione CopyStart.

properties.creationData

CreationData

Informazioni sull'origine del disco. Le informazioni creationData non possono essere modificate dopo la creazione del disco.

properties.dataAccessAuthMode

DataAccessAuthMode

Requisiti di autenticazione aggiuntivi durante l'esportazione o il caricamento in un disco o uno snapshot.

properties.diskAccessId

string

ID ARM della risorsa DiskAccess per l'uso di endpoint privati nei dischi.

properties.diskIOPSReadOnly

integer

Numero totale di operazioni di I/O al secondo consentite in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. Un'operazione può trasferire tra 4k e 256.000 byte.

properties.diskIOPSReadWrite

integer

Numero di operazioni di I/O al secondo consentite per questo disco; solo impostabile per i dischi UltraSSD. Un'operazione può trasferire tra 4k e 256.000 byte.

properties.diskMBpsReadOnly

integer

Velocità effettiva totale (MBps) consentita in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. MBps significa milioni di byte al secondo - MB usa la notazione ISO, di poteri di 10.

properties.diskMBpsReadWrite

integer

Larghezza di banda consentita per questo disco; solo impostabile per i dischi UltraSSD. MBps significa milioni di byte al secondo - MB usa la notazione ISO, di poteri di 10.

properties.diskSizeBytes

integer

Dimensioni del disco in byte. Questo campo è di sola lettura.

properties.diskSizeGB

integer

Se creationData.createOption è Vuoto, questo campo è obbligatorio e indica le dimensioni del disco da creare. Se questo campo è presente per gli aggiornamenti o la creazione con altre opzioni, indica un ridimensionamento. I ridimensionamenti sono consentiti solo se il disco non è collegato a una macchina virtuale in esecuzione e può aumentare solo le dimensioni del disco.

properties.diskState

DiskState

Stato del disco.

properties.encryption

Encryption

La proprietà di crittografia può essere usata per crittografare i dati inattivi con chiavi gestite dal cliente o chiavi gestite dalla piattaforma.

properties.encryptionSettingsCollection

EncryptionSettingsCollection

La raccolta di impostazioni di crittografia usata per Crittografia dischi di Azure può contenere più impostazioni di crittografia per disco o snapshot.

properties.hyperVGeneration

HyperVGeneration

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

properties.maxShares

integer

Numero massimo di macchine virtuali che possono essere collegate al disco contemporaneamente. Il valore maggiore di uno indica un disco che può essere montato in più macchine virtuali contemporaneamente.

properties.networkAccessPolicy

NetworkAccessPolicy

Criteri per l'accesso al disco tramite rete.

properties.optimizedForFrequentAttach

boolean

L'impostazione di questa proprietà su true migliora l'affidabilità e le prestazioni dei dischi dati che sono spesso (più di 5 volte al giorno) scollegate da una macchina virtuale e collegate a un'altra. Questa proprietà non deve essere impostata per i dischi non scollegati e collegati frequentemente perché i dischi non sono allineati al dominio di errore della macchina virtuale.

properties.osType

OperatingSystemTypes

Tipo di sistema operativo.

properties.propertyUpdatesInProgress

PropertyUpdatesInProgress

Proprietà del disco per cui l'aggiornamento è in sospeso.

properties.provisioningState

string

Stato del provisioning del disco.

properties.publicNetworkAccess

PublicNetworkAccess

Criteri per il controllo dell'esportazione sul disco.

properties.purchasePlan

PurchasePlan

Informazioni sul piano di acquisto per l'immagine da cui è stato creato il disco del sistema operativo. Ad esempio- {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}

properties.securityProfile

DiskSecurityProfile

Contiene le informazioni correlate alla sicurezza per la risorsa.

properties.shareInfo

ShareInfoElement[]

Dettagli dell'elenco di tutte le macchine virtuali in cui è collegato il disco. maxShares deve essere impostato su un valore maggiore di uno per i dischi per consentire il collegamento a più macchine virtuali.

properties.supportedCapabilities

SupportedCapabilities

Elenco delle funzionalità supportate per l'immagine da cui è stato creato il disco del sistema operativo.

properties.supportsHibernation

boolean

Indica il sistema operativo in un disco che supporta l'ibernazione.

properties.tier

string

Livello di prestazioni del disco (ad esempio, P4, S10) come descritto di seguito: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Non si applica ai dischi Ultra.

properties.timeCreated

string

Ora di creazione del disco.

properties.uniqueId

string

Guid univoco che identifica la risorsa.

sku

DiskSku

Nome sku dei dischi. Può essere Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.

tags

object

Tag delle risorse

type

string

Tipo di risorsa

zones

string[]

Elenco Di zone logiche per Disco.

DiskCreateOption

In questo modo vengono enumerate le possibili origini della creazione di un disco.

Nome Tipo Descrizione
Attach

string

Il disco verrà collegato a una macchina virtuale.

Copy

string

Creare un nuovo disco o uno snapshot copiando da un disco o uno snapshot specificato dall'oggetto sourceResourceId specificato.

CopyFromSanSnapshot

string

Creare un nuovo disco esportando dallo snapshot del volume san elastico

CopyStart

string

Creare un nuovo disco usando un processo di copia profonda, in cui la creazione della risorsa viene considerata completa solo dopo la copia di tutti i dati dall'origine.

Empty

string

Creare un disco dati vuoto di una dimensione specificata da diskSizeGB.

FromImage

string

Creare un nuovo disco da un'immagine della piattaforma specificata dall'immagine SpecificataReference o galleryImageReference.

Import

string

Creare un disco importando da un BLOB specificato da un sourceUri in un account di archiviazione specificato da storageAccountId.

ImportSecure

string

Analogamente all'opzione Di creazione di importazione. Creare una nuova macchina virtuale di avvio attendibile o una macchina virtuale riservata supportata importando un BLOB aggiuntivo per lo stato guest della macchina virtuale specificato da securityDataUri nell'account di archiviazione specificato da storageAccountId

Restore

string

Creare un nuovo disco copiando da un punto di ripristino di backup.

Upload

string

Creare un nuovo disco ottenendo un token di scrittura e usandolo per caricare direttamente il contenuto del disco.

UploadPreparedSecure

string

Analogamente all'opzione Carica creazione. Creare una nuova macchina virtuale di avvio attendibile o una macchina virtuale riservata supportata e caricare usando il token di scrittura nello stato guest sia del disco che della macchina virtuale

DiskSecurityProfile

Contiene le informazioni relative alla sicurezza per la risorsa.

Nome Tipo Descrizione
secureVMDiskEncryptionSetId

string

ResourceId del set di crittografia del disco associato alla macchina virtuale riservata supportata crittografata con la chiave gestita dal cliente

securityType

DiskSecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

DiskSecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

Nome Tipo Descrizione
ConfidentialVM_DiskEncryptedWithCustomerKey

string

Indica il disco della macchina virtuale riservato con lo stato guest del sistema operativo e della macchina virtuale crittografato con una chiave gestita dal cliente

ConfidentialVM_DiskEncryptedWithPlatformKey

string

Indica il disco vm riservato con disco del sistema operativo e lo stato guest della macchina virtuale crittografato con una chiave gestita dalla piattaforma

ConfidentialVM_NonPersistedTPM

string

Indica il disco vm riservato con una vTPM temporaneo. Lo stato vTPM non viene mantenuto tra i riavvii della macchina virtuale.

ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey

string

Indica il disco vm riservato con solo lo stato guest della macchina virtuale crittografato

TrustedLaunch

string

Avvio attendibile offre funzionalità di sicurezza, ad esempio l'avvio sicuro e il modulo della piattaforma attendibile virtuale (vTPM)

DiskSku

Nome sku dei dischi. Può essere Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.

Nome Tipo Descrizione
name

DiskStorageAccountTypes

Nome sku.

tier

string

Livello SKU.

DiskState

In questo modo viene enumerato lo stato possibile del disco.

Nome Tipo Descrizione
ActiveSAS

string

Il disco ha attualmente un URI di firma di accesso condiviso attivo associato.

ActiveSASFrozen

string

Il disco è collegato a una macchina virtuale in stato di ibernazione e ha un URI di firma di accesso condiviso attivo associato.

ActiveUpload

string

Viene creato un disco per il caricamento e viene rilasciato un token di scrittura per il caricamento.

Attached

string

Il disco è attualmente collegato a una macchina virtuale in esecuzione.

Frozen

string

Il disco viene collegato a una macchina virtuale in stato di ibernazione.

ReadyToUpload

string

Un disco è pronto per essere creato richiedendo un token di scrittura.

Reserved

string

Il disco viene collegato a una macchina virtuale deallocata arrestata.

Unattached

string

Il disco non viene usato e può essere collegato a una macchina virtuale.

DiskStorageAccountTypes

Nome sku.

Nome Tipo Descrizione
PremiumV2_LRS

string

Archiviazione con ridondanza locale di SSD Premium v2. Migliore per i carichi di lavoro sensibili alle prestazioni e alla produzione che richiedono in modo coerente bassa latenza e velocità effettiva elevata e I/O al secondo.

Premium_LRS

string

Archiviazione con ridondanza locale di SSD Premium. Migliore per carichi di lavoro sensibili alla produzione e alle prestazioni.

Premium_ZRS

string

Archiviazione con ridondanza della zona SSD Premium. Migliore per i carichi di lavoro di produzione che necessitano di resilienza di archiviazione contro gli errori della zona.

StandardSSD_LRS

string

Archiviazione con ridondanza locale ssd standard. Ideale per i server Web, usate in modo leggero applicazioni aziendali e sviluppo/test.

StandardSSD_ZRS

string

Archiviazione con ridondanza della zona SSD standard. Ideale per i server Web, usate in modo leggero applicazioni aziendali e sviluppo/test che necessitano di resilienza di archiviazione contro gli errori della zona.

Standard_LRS

string

Archiviazione con ridondanza locale hdd standard. Ideale per il backup, non critico e l'accesso non frequente.

UltraSSD_LRS

string

Archiviazione ultra SSD con ridondanza locale. Ideale per i carichi di lavoro con utilizzo intensivo di IO, ad esempio SAP HANA, database di primo livello (ad esempio, SQL, Oracle) e altri carichi di lavoro pesanti per le transazioni.

Encryption

Impostazioni di crittografia dei dati inattivi per disco o snapshot

Nome Tipo Descrizione
diskEncryptionSetId

string

ResourceId del set di crittografia del disco da usare per abilitare la crittografia dei dati inattivi.

type

EncryptionType

Tipo di chiave utilizzata per crittografare i dati del disco.

EncryptionSettingsCollection

Impostazioni di crittografia per il disco o lo snapshot

Nome Tipo Descrizione
enabled

boolean

Impostare questo flag su true e specificare DiskEncryptionKey e keyEncryptionKey facoltativo per abilitare la crittografia. Impostare questo flag su false e rimuovere DiskEncryptionKey e KeyEncryptionKey per disabilitare la crittografia. Se EncryptionSettings è Null nell'oggetto richiesta, le impostazioni esistenti rimangono invariate.

encryptionSettings

EncryptionSettingsElement[]

Raccolta di impostazioni di crittografia, una per ogni volume del disco.

encryptionSettingsVersion

string

Descrive il tipo di crittografia usato per i dischi. Dopo aver impostato questo campo, non può essere sovrascritto. '1.0' corrisponde a Crittografia dischi di Azure con l'app AAD.'1.1' corrisponde a Crittografia dischi di Azure.

EncryptionSettingsElement

Impostazioni di crittografia per un volume del disco.

Nome Tipo Descrizione
diskEncryptionKey

KeyVaultAndSecretReference

Key Vault URL segreto e ID insieme di credenziali della chiave di crittografia del disco

keyEncryptionKey

KeyVaultAndKeyReference

Key Vault l'URL della chiave e l'ID dell'insieme di credenziali della chiave. KeyEncryptionKey è facoltativo e, se specificato, viene usato per annullare ilrap della chiave di crittografia del disco.

EncryptionType

Tipo di chiave usata per crittografare i dati del disco.

Nome Tipo Descrizione
EncryptionAtRestWithCustomerKey

string

Il disco viene crittografato inattivo con la chiave gestita dal cliente che può essere modificato e revocato da un cliente.

EncryptionAtRestWithPlatformAndCustomerKeys

string

Il disco viene crittografato inattivo con 2 livelli di crittografia. Una delle chiavi è gestita dal cliente e l'altra chiave è gestita dalla piattaforma.

EncryptionAtRestWithPlatformKey

string

Il disco viene crittografato inattivo con la chiave gestita della piattaforma. È il tipo di crittografia predefinito. Non è un tipo di crittografia valido per i set di crittografia dei dischi.

ExtendedLocation

Tipo complesso della posizione estesa.

Nome Tipo Descrizione
name

string

Nome della posizione estesa.

type

ExtendedLocationTypes

Tipo della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

Nome Tipo Descrizione
EdgeZone

string

HyperVGeneration

Generazione di hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

Nome Tipo Descrizione
V1

string

V2

string

ImageDiskReference

Immagine di origine usata per la creazione del disco.

Nome Tipo Descrizione
communityGalleryImageId

string

URI relativo contenente un riferimento all'immagine di Azure Compute Gallery della community.

id

string

URI relativo contenente un repository di immagini della piattaforma, un'immagine utente o un riferimento all'immagine di Azure Compute Gallery.

lun

integer

Se il disco viene creato dal disco dati di un'immagine, si tratta di un indice che indica quale dei dischi dati nell'immagine da usare. Per i dischi del sistema operativo, questo campo è Null.

sharedGalleryImageId

string

URI relativo contenente un riferimento all'immagine di Azure Compute Gallery condivisa diretta.

KeyVaultAndKeyReference

Key Vault URL chiave e ID insieme di credenziali di KeK, KeK è facoltativo e, se specificato, viene usato per annullare ilrap della chiave di crittografiaKey

Nome Tipo Descrizione
keyUrl

string

URL che punta a una chiave o a un segreto in KeyVault

sourceVault

SourceVault

ID risorsa di KeyVault contenente la chiave o il segreto

KeyVaultAndSecretReference

Key Vault l'URL segreto e l'ID dell'insieme di credenziali della chiave di crittografia

Nome Tipo Descrizione
secretUrl

string

URL che punta a una chiave o a un segreto in KeyVault

sourceVault

SourceVault

ID risorsa di KeyVault contenente la chiave o il segreto

NetworkAccessPolicy

Criteri per l'accesso al disco tramite rete.

Nome Tipo Descrizione
AllowAll

string

Il disco può essere esportato o caricato da qualsiasi rete.

AllowPrivate

string

Il disco può essere esportato o caricato in usando gli endpoint privati di una risorsa DiskAccess.

DenyAll

string

Impossibile esportare il disco.

OperatingSystemTypes

Tipo di sistema operativo.

Nome Tipo Descrizione
Linux

string

Windows

string

PropertyUpdatesInProgress

Proprietà del disco per cui l'aggiornamento è in sospeso.

Nome Tipo Descrizione
targetTier

string

Livello di prestazioni di destinazione del disco se è in corso un'operazione di modifica del livello.

ProvisionedBandwidthCopyOption

Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato a velocità più rapida.

Nome Tipo Descrizione
Enhanced

string

None

string

PublicNetworkAccess

Criteri per il controllo dell'esportazione sul disco.

Nome Tipo Descrizione
Disabled

string

Non è possibile accedere ai dati sottostanti del disco pubblicamente su Internet anche quando NetworkAccessPolicy è impostato su AllowAll. È possibile accedere ai dati tramite l'URI di firma di accesso condiviso solo dalla rete virtuale di Azure attendibile quando NetworkAccessPolicy è impostato su AllowPrivate.

Enabled

string

È possibile generare un URI di firma di accesso condiviso per accedere ai dati sottostanti del disco pubblicamente su Internet quando NetworkAccessPolicy è impostato su AllowAll. È possibile accedere ai dati tramite l'URI di firma di accesso condiviso solo dalla rete virtuale di Azure attendibile quando NetworkAccessPolicy è impostato su AllowPrivate.

PurchasePlan

Usato per stabilire il contesto di acquisto di qualsiasi elemento di terze parti tramite MarketPlace.

Nome Tipo Descrizione
name

string

ID piano.

product

string

Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference.

promotionCode

string

Codice promozionale dell'offerta.

publisher

string

ID editore.

ShareInfoElement

Nome Tipo Descrizione
vmUri

string

URI relativo contenente l'ID della macchina virtuale a cui è collegato il disco.

SourceVault

L'ID dell'insieme di credenziali è un ID risorsa di Azure Resource Manager nel formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Nome Tipo Descrizione
id

string

ID risorsa

SupportedCapabilities

Elenco delle funzionalità supportate rese persistenti nella risorsa disco per l'uso della macchina virtuale.

Nome Tipo Descrizione
acceleratedNetwork

boolean

True se l'immagine da cui viene creato il disco del sistema operativo supporta la rete accelerata.

architecture

Architecture

Architettura della CPU supportata da un disco del sistema operativo.

diskControllerTypes

string

Controller del disco supportati da un disco del sistema operativo. Se impostato può essere SCSI o SCSI, NVME o NVME, SCSI.