Disks - Create Or Update

Crée ou met à jour un disque.

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

Paramètres URI

Nom Dans Obligatoire Type Description
diskName
path True

string

Nom du disque managé en cours de création. Le nom ne peut pas être modifié après la création du disque. Les caractères pris en charge pour le nom sont a-z, A-Z, 0-9, _ et -. La longueur maximale du nom est limitée à 80 caractères.

resourceGroupName
path True

string

Nom du groupe de ressources.

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

api-version
query True

string

Version de l’API cliente.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement de la ressource

properties.creationData True

CreationData

Informations sur la source de disque. Les informations CreationData ne peuvent pas être modifiées une fois le disque créé.

extendedLocation

ExtendedLocation

Emplacement étendu où le disque sera créé. L’emplacement étendu ne peut pas être modifié.

properties.burstingEnabled

boolean

Définissez sur true pour activer le bursting au-delà de la cible de performances provisionnée du disque. Le bursting est désactivé par défaut. Ne s’applique pas aux disques Ultra.

properties.completionPercent

number

Pourcentage terminé pour la copie en arrière-plan lorsqu’une ressource est créée via l’opération CopyStart.

properties.dataAccessAuthMode

DataAccessAuthMode

Exigences d’authentification supplémentaires lors de l’exportation ou du chargement sur un disque ou un instantané.

properties.diskAccessId

string

ID ARM de la ressource DiskAccess pour l’utilisation de points de terminaison privés sur des disques.

properties.diskIOPSReadOnly

integer

Nombre total d’E/S par seconde autorisées sur toutes les machines virtuelles qui montent le disque partagé en lecture seule. Une opération peut transférer entre 4 000 et 256 000 octets.

properties.diskIOPSReadWrite

integer

Nombre d’E/S par seconde autorisé pour ce disque ; paramétrable uniquement pour les disques UltraSSD. Une opération peut transférer entre 4 000 et 256 000 octets.

properties.diskMBpsReadOnly

integer

Débit total (MBits/s) autorisé sur toutes les machines virtuelles montant le disque partagé en lecture seule. MBits/s signifie des millions d’octets par seconde - Mo utilise ici la notation ISO, de puissances de 10.

properties.diskMBpsReadWrite

integer

Bande passante autorisée pour ce disque ; paramétrable uniquement pour les disques UltraSSD. MBits/s signifie des millions d’octets par seconde - Mo utilise ici la notation ISO, de puissances de 10.

properties.diskSizeGB

integer

Si creationData.createOption est Vide, ce champ est obligatoire et indique la taille du disque à créer. Si ce champ est présent pour les mises à jour ou la création avec d’autres options, il indique un redimensionnement. Les redimensionnements ne sont autorisés que si le disque n’est pas attaché à une machine virtuelle en cours d’exécution et peuvent uniquement augmenter la taille du disque.

properties.encryption

Encryption

La propriété de chiffrement peut être utilisée pour chiffrer des données au repos avec des clés gérées par le client ou des clés gérées par la plateforme.

properties.encryptionSettingsCollection

EncryptionSettingsCollection

La collection de paramètres de chiffrement utilisée pour Azure Disk Encryption peut contenir plusieurs paramètres de chiffrement par disque ou instantané.

properties.hyperVGeneration

HyperVGeneration

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

properties.maxShares

integer

Nombre maximal de machines virtuelles pouvant être attachées au disque en même temps. La valeur supérieure à un indique un disque qui peut être monté sur plusieurs machines virtuelles en même temps.

properties.networkAccessPolicy

NetworkAccessPolicy

Stratégie d’accès au disque via le réseau.

properties.optimizedForFrequentAttach

boolean

La définition de cette propriété sur true améliore la fiabilité et les performances des disques de données qui sont fréquemment (plus de 5 fois par jour) détachés d’une machine virtuelle et attachés à une autre. Cette propriété ne doit pas être définie pour les disques qui ne sont pas détachés et attachés fréquemment, car cela entraîne l’alignement des disques sur le domaine d’erreur de la machine virtuelle.

properties.osType

OperatingSystemTypes

Type système d’exploitation.

properties.publicNetworkAccess

PublicNetworkAccess

Stratégie de contrôle de l’exportation sur le disque.

properties.purchasePlan

PurchasePlan

Informations sur le plan d’achat pour l’image à partir de laquelle le disque du système d’exploitation a été créé. Par exemple - {name : 2019-Datacenter, publisher : MicrosoftWindowsServer, product : WindowsServer}

properties.securityProfile

DiskSecurityProfile

Contient les informations relatives à la sécurité de la ressource.

properties.supportedCapabilities

SupportedCapabilities

Liste des fonctionnalités prises en charge pour l’image à partir de laquelle le disque du système d’exploitation a été créé.

properties.supportsHibernation

boolean

Indique que le système d’exploitation sur un disque prend en charge la mise en veille prolongée.

properties.tier

string

Niveau de performances du disque (par exemple, P4, S10) comme décrit ici : https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Ne s’applique pas aux disques Ultra.

sku

DiskSku

Nom de la référence sku des disques. Peut être Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.

tags

object

Balises de ressource

zones

string[]

Liste de zones logiques pour Disque.

Réponses

Nom Type Description
200 OK

Disk

Ok

202 Accepted

Disk

Accepté

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

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"
  }
}

Définitions

Nom Description
Architecture

Architecture du processeur prise en charge par un disque de système d’exploitation.

CreationData

Données utilisées lors de la création d’un disque.

DataAccessAuthMode

Exigences d’authentification supplémentaires lors de l’exportation ou du chargement sur un disque ou un instantané.

Disk

Ressource de disque.

DiskCreateOption

Cette opération énumère les sources possibles de la création d’un disque.

DiskSecurityProfile

Contient les informations relatives à la sécurité de la ressource.

DiskSecurityTypes

Spécifie le SecurityType de la machine virtuelle. Applicable aux disques de système d’exploitation uniquement.

DiskSku

Nom de la référence sku des disques. Peut être Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.

DiskState

Cette opération énumère l’état possible du disque.

DiskStorageAccountTypes

Nom de la référence SKU.

Encryption

Paramètres de chiffrement au repos pour le disque ou l’instantané

EncryptionSettingsCollection

Paramètres de chiffrement pour le disque ou le instantané

EncryptionSettingsElement

Paramètres de chiffrement pour un volume de disque.

EncryptionType

Type de clé utilisé pour chiffrer les données du disque.

ExtendedLocation

Type complexe de l’emplacement étendu.

ExtendedLocationTypes

Type de l’emplacement étendu.

HyperVGeneration

Génération de l’hyperviseur de la machine virtuelle. Applicable aux disques de système d’exploitation uniquement.

ImageDiskReference

Image source utilisée pour créer le disque.

KeyVaultAndKeyReference

Key Vault l’URL de clé et l’ID de coffre de KeK, KeK est facultatif et, lorsqu’il est fourni, est utilisé pour désencapsuler le chiffrementKey

KeyVaultAndSecretReference

url secrète Key Vault et ID de coffre de la clé de chiffrement

NetworkAccessPolicy

Stratégie d’accès au disque via le réseau.

OperatingSystemTypes

Type de système d’exploitation.

PropertyUpdatesInProgress

Propriétés du disque pour lequel la mise à jour est en attente.

ProvisionedBandwidthCopyOption

Si ce champ est défini sur un instantané et que createOption a la valeur CopyStart, le instantané est copié à une vitesse plus rapide.

PublicNetworkAccess

Stratégie de contrôle de l’exportation sur le disque.

PurchasePlan

Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace.

ShareInfoElement
SourceVault

L’ID de coffre est un ID de ressource Azure Resource Manager sous la forme /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

SupportedCapabilities

Liste des fonctionnalités prises en charge persistantes sur la ressource de disque pour l’utilisation de la machine virtuelle.

Architecture

Architecture du processeur prise en charge par un disque de système d’exploitation.

Nom Type Description
Arm64

string

x64

string

CreationData

Données utilisées lors de la création d’un disque.

Nom Type Description
createOption

DiskCreateOption

Cette opération énumère les sources possibles de la création d’un disque.

elasticSanResourceId

string

Obligatoire si createOption est CopyFromSanSnapshot. Il s’agit de l’ID ARM du volume san élastique source instantané.

galleryImageReference

ImageDiskReference

Obligatoire si vous créez à partir d’une image de galerie. L’id/sharedGalleryImageId/communityGalleryImageId de l’ImageDiskReference sera l’ID ARM de la version de l’image de galère partagée à partir de laquelle créer un disque.

imageReference

ImageDiskReference

Informations sur la source de disque pour les images PIR ou utilisateur.

logicalSectorSize

integer

Taille du secteur logique en octets pour les disques Ultra. (valeurs prises en charge : 512 et 4096, par défaut 4096)

performancePlus

boolean

Définissez cet indicateur sur true pour obtenir une amélioration de la cible de performances du disque déployé, consultez ici sur la cible de performances correspondante. Cet indicateur ne peut être défini qu’au moment de la création du disque et ne peut pas être désactivé une fois activé.

provisionedBandwidthCopySpeed

ProvisionedBandwidthCopyOption

Si ce champ est défini sur un instantané et que createOption a la valeur CopyStart, le instantané sera copié à une vitesse plus rapide.

securityDataUri

string

Si createOption a la valeur ImportSecure, il s’agit de l’URI d’un objet blob à importer dans l’état invité de la machine virtuelle.

sourceResourceId

string

Si createOption est Copy, il s’agit de l’ID ARM de la instantané ou du disque source.

sourceUniqueId

string

Si ce champ est défini, il s’agit de l’ID unique identifiant la source de cette ressource.

sourceUri

string

Si createOption est Import, il s’agit de l’URI d’un objet blob à importer dans un disque managé.

storageAccountId

string

Obligatoire si createOption est Import. Azure Resource Manager identificateur du compte de stockage contenant l’objet blob à importer en tant que disque.

uploadSizeBytes

integer

Si createOption est Upload, il s’agit de la taille du contenu du chargement, y compris le pied de page du disque dur virtuel. Cette valeur doit être comprise entre 20972032 (20 Mio + 512 octets pour le pied de disque dur virtuel) et 35183298347520 octets (32 Tio + 512 octets pour le pied de disque dur virtuel).

DataAccessAuthMode

Exigences d’authentification supplémentaires lors de l’exportation ou du chargement sur un disque ou un instantané.

Nom Type Description
AzureActiveDirectory

string

Lorsque l’URL d’exportation/chargement est utilisée, le système vérifie si l’utilisateur dispose d’une identité dans Azure Active Directory, avec des autorisations nécessaires pour exporter/charger les données. Consultez la page aka.ms/DisksAzureADAuth.

None

string

Aucune authentification supplémentaire n’est effectuée lors de l’accès à l’URL d’exportation/chargement.

Disk

Ressource de disque.

Nom Type Description
extendedLocation

ExtendedLocation

Emplacement étendu où le disque sera créé. L’emplacement étendu ne peut pas être modifié.

id

string

ID de ressource

location

string

Emplacement de la ressource

managedBy

string

URI relatif contenant l’ID de la machine virtuelle sur laquelle le disque est attaché.

managedByExtended

string[]

Liste des URI relatifs contenant les ID des machines virtuelles auxquelles le disque est attaché. maxShares doit être défini sur une valeur supérieure à une pour les disques afin de permettre leur attachement à plusieurs machines virtuelles.

name

string

Nom de la ressource

properties.LastOwnershipUpdateTime

string

Heure UTC à laquelle l’état de propriété du disque a été modifié pour la dernière fois, c’est-à-dire l’heure à laquelle le disque a été attaché ou détaché d’une machine virtuelle ou l’heure à laquelle la machine virtuelle à laquelle le disque a été connecté a été désallouée ou démarrée.

properties.burstingEnabled

boolean

Définissez sur true pour activer le bursting au-delà de la cible de performances provisionnée du disque. Le bursting est désactivé par défaut. Ne s’applique pas aux disques Ultra.

properties.burstingEnabledTime

string

Heure la plus récente à laquelle le bursting a été activé pour la dernière fois sur un disque.

properties.completionPercent

number

Pourcentage terminé pour la copie en arrière-plan lorsqu’une ressource est créée via l’opération CopyStart.

properties.creationData

CreationData

Informations sur la source de disque. Les informations CreationData ne peuvent pas être modifiées une fois le disque créé.

properties.dataAccessAuthMode

DataAccessAuthMode

Exigences d’authentification supplémentaires lors de l’exportation ou du chargement sur un disque ou un instantané.

properties.diskAccessId

string

ID ARM de la ressource DiskAccess pour l’utilisation de points de terminaison privés sur des disques.

properties.diskIOPSReadOnly

integer

Nombre total d’E/S par seconde autorisées sur toutes les machines virtuelles qui montent le disque partagé en lecture seule. Une opération peut transférer entre 4 000 et 256 000 octets.

properties.diskIOPSReadWrite

integer

Nombre d’E/S par seconde autorisé pour ce disque ; paramétrable uniquement pour les disques UltraSSD. Une opération peut transférer entre 4 000 et 256 000 octets.

properties.diskMBpsReadOnly

integer

Débit total (MBits/s) autorisé sur toutes les machines virtuelles montant le disque partagé en lecture seule. MBits/s signifie des millions d’octets par seconde - Mo utilise ici la notation ISO, de puissances de 10.

properties.diskMBpsReadWrite

integer

Bande passante autorisée pour ce disque ; paramétrable uniquement pour les disques UltraSSD. MBits/s signifie des millions d’octets par seconde - Mo utilise ici la notation ISO, de puissances de 10.

properties.diskSizeBytes

integer

Taille du disque en octets. Ce champ est en lecture seule.

properties.diskSizeGB

integer

Si creationData.createOption est Vide, ce champ est obligatoire et indique la taille du disque à créer. Si ce champ est présent pour les mises à jour ou la création avec d’autres options, il indique un redimensionnement. Les redimensionnements ne sont autorisés que si le disque n’est pas attaché à une machine virtuelle en cours d’exécution et peuvent uniquement augmenter la taille du disque.

properties.diskState

DiskState

État du disque.

properties.encryption

Encryption

La propriété de chiffrement peut être utilisée pour chiffrer des données au repos avec des clés gérées par le client ou des clés gérées par la plateforme.

properties.encryptionSettingsCollection

EncryptionSettingsCollection

La collection de paramètres de chiffrement utilisée pour Azure Disk Encryption peut contenir plusieurs paramètres de chiffrement par disque ou instantané.

properties.hyperVGeneration

HyperVGeneration

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

properties.maxShares

integer

Nombre maximal de machines virtuelles pouvant être attachées au disque en même temps. La valeur supérieure à un indique un disque qui peut être monté sur plusieurs machines virtuelles en même temps.

properties.networkAccessPolicy

NetworkAccessPolicy

Stratégie d’accès au disque via le réseau.

properties.optimizedForFrequentAttach

boolean

La définition de cette propriété sur true améliore la fiabilité et les performances des disques de données qui sont fréquemment (plus de 5 fois par jour) détachés d’une machine virtuelle et attachés à une autre. Cette propriété ne doit pas être définie pour les disques qui ne sont pas détachés et attachés fréquemment, car cela entraîne l’alignement des disques avec le domaine d’erreur de la machine virtuelle.

properties.osType

OperatingSystemTypes

Type système d’exploitation.

properties.propertyUpdatesInProgress

PropertyUpdatesInProgress

Propriétés du disque pour lequel la mise à jour est en attente.

properties.provisioningState

string

État d’approvisionnement de disque.

properties.publicNetworkAccess

PublicNetworkAccess

Stratégie de contrôle de l’exportation sur le disque.

properties.purchasePlan

PurchasePlan

Informations sur le plan d’achat pour l’image à partir de laquelle le disque du système d’exploitation a été créé. Par exemple - {name : 2019-Datacenter, publisher : MicrosoftWindowsServer, product : WindowsServer}

properties.securityProfile

DiskSecurityProfile

Contient les informations relatives à la sécurité pour la ressource.

properties.shareInfo

ShareInfoElement[]

Détails de la liste de toutes les machines virtuelles auxquelles le disque est attaché. maxShares doit être défini sur une valeur supérieure à une pour les disques afin de permettre leur attachement à plusieurs machines virtuelles.

properties.supportedCapabilities

SupportedCapabilities

Liste des fonctionnalités prises en charge pour l’image à partir de laquelle le disque du système d’exploitation a été créé.

properties.supportsHibernation

boolean

Indique que le système d’exploitation sur un disque prend en charge la mise en veille prolongée.

properties.tier

string

Niveau de performances du disque (par exemple, P4, S10) comme décrit ici : https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Ne s’applique pas aux disques Ultra.

properties.timeCreated

string

Heure de création du disque.

properties.uniqueId

string

Guid unique identifiant la ressource.

sku

DiskSku

Nom de la référence sku des disques. Peut être Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.

tags

object

Balises de ressource

type

string

Type de ressource

zones

string[]

Liste de zones logiques pour Disque.

DiskCreateOption

Cette opération énumère les sources possibles de la création d’un disque.

Nom Type Description
Attach

string

Le disque sera attaché à une machine virtuelle.

Copy

string

Créez un disque ou un instantané en copiant à partir d’un disque ou instantané spécifié par le sourceResourceId donné.

CopyFromSanSnapshot

string

Créez un disque en exportant à partir d’elastic san volume instantané

CopyStart

string

Créez un disque à l’aide d’un processus de copie approfondie, où la création de la ressource n’est considérée comme terminée qu’une fois que toutes les données ont été copiées à partir de la source.

Empty

string

Créez un disque de données vide d’une taille donnée par diskSizeGB.

FromImage

string

Créez un disque à partir d’une image de plateforme spécifiée par l’imageReference ou galleryImageReference donnée.

Import

string

Créez un disque en important à partir d’un objet blob spécifié par un sourceUri dans un compte de stockage spécifié par storageAccountId.

ImportSecure

string

Semblable à l’option Importer créer. Créez une machine virtuelle de lancement approuvé ou un disque de machine virtuelle confidentielle pris en charge en important un objet blob supplémentaire pour l’état invité de la machine virtuelle spécifié par securityDataUri dans le compte de stockage spécifié par storageAccountId

Restore

string

Créez un disque en copiant à partir d’un point de récupération de sauvegarde.

Upload

string

Créez un disque en obtenant un jeton d’écriture et en l’utilisant pour charger directement le contenu du disque.

UploadPreparedSecure

string

Similaire à l’option Charger la création. Créer une machine virtuelle de lancement approuvé ou un disque de machine virtuelle confidentielle pris en charge et charger à l’aide d’un jeton d’écriture dans l’état invité du disque et de la machine virtuelle

DiskSecurityProfile

Contient les informations relatives à la sécurité de la ressource.

Nom Type Description
secureVMDiskEncryptionSetId

string

ResourceId du jeu de chiffrement de disque associé à un disque pris en charge par une machine virtuelle confidentielle chiffré avec une clé gérée par le client

securityType

DiskSecurityTypes

Spécifie le SecurityType de la machine virtuelle. Applicable uniquement aux disques de système d’exploitation.

DiskSecurityTypes

Spécifie le SecurityType de la machine virtuelle. Applicable aux disques de système d’exploitation uniquement.

Nom Type Description
ConfidentialVM_DiskEncryptedWithCustomerKey

string

Indique un disque de machine virtuelle confidentiel avec le disque du système d’exploitation et l’état invité de la machine virtuelle chiffré avec une clé gérée par le client

ConfidentialVM_DiskEncryptedWithPlatformKey

string

Indique un disque de machine virtuelle confidentiel avec le disque du système d’exploitation et l’état invité de la machine virtuelle chiffrés avec une clé gérée par la plateforme

ConfidentialVM_NonPersistedTPM

string

Indique un disque de machine virtuelle confidentiel avec un vTPM éphémère. L’état de vTPM n’est pas persistant entre les redémarrages de machine virtuelle.

ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey

string

Indique un disque de machine virtuelle confidentiel avec uniquement l’état invité de la machine virtuelle chiffré

TrustedLaunch

string

Lancement approuvé fournit des fonctionnalités de sécurité telles que le démarrage sécurisé et le module de plateforme sécurisée virtuel (vTPM)

DiskSku

Nom de la référence sku des disques. Peut être Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS ou PremiumV2_LRS.

Nom Type Description
name

DiskStorageAccountTypes

Nom de la référence sku.

tier

string

Niveau de référence sku.

DiskState

Cette opération énumère l’état possible du disque.

Nom Type Description
ActiveSAS

string

Un URI SAS actif est actuellement associé au disque.

ActiveSASFrozen

string

Le disque est attaché à une machine virtuelle dans un état hibernated et est associé à un URI SAS actif.

ActiveUpload

string

Un disque est créé pour le chargement et un jeton d’écriture a été émis pour le chargement.

Attached

string

Le disque est actuellement attaché à une machine virtuelle en cours d’exécution.

Frozen

string

Le disque est attaché à une machine virtuelle qui est dans un état hibernated.

ReadyToUpload

string

Un disque est prêt à être créé par chargement en demandant un jeton d’écriture.

Reserved

string

Le disque est attaché à une machine virtuelle arrêtée-désallouée.

Unattached

string

Le disque n’est pas utilisé et peut être attaché à une machine virtuelle.

DiskStorageAccountTypes

Nom de la référence SKU.

Nom Type Description
PremiumV2_LRS

string

Stockage ssd Premium v2 localement redondant. Idéal pour les charges de travail sensibles à la production et aux performances qui nécessitent systématiquement une faible latence, des IOPS et un débit élevés.

Premium_LRS

string

Stockage localement redondant SSD Premium. Idéal pour les charges de travail de production et sensibles aux performances.

Premium_ZRS

string

Stockage redondant interzone SSD Premium. Idéal pour les charges de travail de production qui ont besoin d’une résilience de stockage contre les défaillances de zone.

StandardSSD_LRS

string

Stockage localement redondant SSD Standard. Idéal pour les serveurs web, les applications d’entreprise peu utilisées et les environnements dev/test.

StandardSSD_ZRS

string

Stockage redondant interzone SSD standard. Idéal pour les serveurs web, les applications d’entreprise légèrement utilisées et le développement/test qui nécessitent une résilience de stockage contre les défaillances de zone.

Standard_LRS

string

Stockage localement redondant HDD Standard. Idéal pour un accès de secours non critique et occasionnel.

UltraSSD_LRS

string

Stockage ssd ultra redondant localement. Idéal pour les charges de travail gourmandes en E/S, telles que SAP HANA, les bases de données de niveau supérieur (par exemple, SQL, Oracle) et d’autres charges de travail gourmandes en transactions.

Encryption

Paramètres de chiffrement au repos pour le disque ou l’instantané

Nom Type Description
diskEncryptionSetId

string

ResourceId du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos.

type

EncryptionType

Type de clé utilisé pour chiffrer les données du disque.

EncryptionSettingsCollection

Paramètres de chiffrement pour le disque ou le instantané

Nom Type Description
enabled

boolean

Définissez cet indicateur sur true et fournissez DiskEncryptionKey et keyEncryptionKey facultatif pour activer le chiffrement. Définissez cet indicateur sur false et supprimez DiskEncryptionKey et KeyEncryptionKey pour désactiver le chiffrement. Si EncryptionSettings a la valeur Null dans l’objet de requête, les paramètres existants restent inchangés.

encryptionSettings

EncryptionSettingsElement[]

Collection de paramètres de chiffrement, un pour chaque volume de disque.

encryptionSettingsVersion

string

Décrit le type de chiffrement utilisé pour les disques. Une fois ce champ défini, il ne peut pas être remplacé. « 1.0 » correspond à Azure Disk Encryption avec l’application AAD.'1.1' correspond à Azure Disk Encryption.

EncryptionSettingsElement

Paramètres de chiffrement pour un volume de disque.

Nom Type Description
diskEncryptionKey

KeyVaultAndSecretReference

Key Vault URL secrète et ID de coffre de la clé de chiffrement de disque

keyEncryptionKey

KeyVaultAndKeyReference

Key Vault l’URL de la clé et l’ID de coffre de la clé de chiffrement de clé. KeyEncryptionKey est facultatif et, lorsqu’il est fourni, est utilisé pour désencapsuler la clé de chiffrement de disque.

EncryptionType

Type de clé utilisé pour chiffrer les données du disque.

Nom Type Description
EncryptionAtRestWithCustomerKey

string

Le disque est chiffré au repos avec une clé gérée par le client qui peut être modifiée et révoquée par un client.

EncryptionAtRestWithPlatformAndCustomerKeys

string

Le disque est chiffré au repos avec 2 couches de chiffrement. L’une des clés est gérée par le client et l’autre clé est gérée par la plateforme.

EncryptionAtRestWithPlatformKey

string

Le disque est chiffré au repos avec la clé gérée par la plateforme. Il s’agit du type de chiffrement par défaut. Il ne s’agit pas d’un type de chiffrement valide pour les jeux de chiffrement de disque.

ExtendedLocation

Type complexe de l’emplacement étendu.

Nom Type Description
name

string

Nom de l’emplacement étendu.

type

ExtendedLocationTypes

Type de l’emplacement étendu.

ExtendedLocationTypes

Type de l’emplacement étendu.

Nom Type Description
EdgeZone

string

HyperVGeneration

Génération de l’hyperviseur de la machine virtuelle. Applicable aux disques de système d’exploitation uniquement.

Nom Type Description
V1

string

V2

string

ImageDiskReference

Image source utilisée pour créer le disque.

Nom Type Description
communityGalleryImageId

string

URI relatif contenant une référence d’image Azure Compute Gallery de communauté.

id

string

URI relatif contenant un référentiel d’images de plateforme, une image utilisateur ou une référence d’image Azure Compute Gallery.

lun

integer

Si le disque est créé à partir du disque de données d’une image, il s’agit d’un index qui indique les disques de données de l’image à utiliser. Pour les disques de système d’exploitation, ce champ est null.

sharedGalleryImageId

string

URI relatif contenant une référence d’image Azure Compute Gallery partagée directe.

KeyVaultAndKeyReference

Key Vault l’URL de clé et l’ID de coffre de KeK, KeK est facultatif et, lorsqu’il est fourni, est utilisé pour désencapsuler le chiffrementKey

Nom Type Description
keyUrl

string

URL pointant vers une clé ou un secret dans KeyVault

sourceVault

SourceVault

ID de ressource du KeyVault contenant la clé ou le secret

KeyVaultAndSecretReference

url secrète Key Vault et ID de coffre de la clé de chiffrement

Nom Type Description
secretUrl

string

URL pointant vers une clé ou un secret dans KeyVault

sourceVault

SourceVault

ID de ressource du KeyVault contenant la clé ou le secret

NetworkAccessPolicy

Stratégie d’accès au disque via le réseau.

Nom Type Description
AllowAll

string

Le disque peut être exporté ou chargé à partir de n’importe quel réseau.

AllowPrivate

string

Le disque peut être exporté ou chargé vers à l’aide des points de terminaison privés d’une ressource DiskAccess.

DenyAll

string

Impossible d’exporter le disque.

OperatingSystemTypes

Type de système d’exploitation.

Nom Type Description
Linux

string

Windows

string

PropertyUpdatesInProgress

Propriétés du disque pour lequel la mise à jour est en attente.

Nom Type Description
targetTier

string

Niveau de performances cible du disque si une opération de changement de niveau est en cours.

ProvisionedBandwidthCopyOption

Si ce champ est défini sur un instantané et que createOption a la valeur CopyStart, le instantané est copié à une vitesse plus rapide.

Nom Type Description
Enhanced

string

None

string

PublicNetworkAccess

Stratégie de contrôle de l’exportation sur le disque.

Nom Type Description
Disabled

string

Vous ne pouvez pas accéder aux données sous-jacentes du disque publiquement sur Internet, même si NetworkAccessPolicy est défini sur AllowAll. Vous pouvez accéder aux données via l’URI SAS uniquement à partir de votre réseau virtuel Azure approuvé lorsque NetworkAccessPolicy est défini sur AllowPrivate.

Enabled

string

Vous pouvez générer un URI SAS pour accéder publiquement aux données sous-jacentes du disque sur Internet lorsque NetworkAccessPolicy est défini sur AllowAll. Vous pouvez accéder aux données via l’URI SAS uniquement à partir de votre réseau virtuel Azure approuvé lorsque NetworkAccessPolicy est défini sur AllowPrivate.

PurchasePlan

Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace.

Nom Type Description
name

string

ID de plan.

product

string

Spécifie le produit de l’image de la Place de marché. Il s’agit de la même valeur que Offer sous l’élément imageReference.

promotionCode

string

Code de promotion de l’offre.

publisher

string

ID de l’éditeur.

ShareInfoElement

Nom Type Description
vmUri

string

URI relatif contenant l’ID de la machine virtuelle sur laquelle le disque est attaché.

SourceVault

L’ID de coffre est un ID de ressource Azure Resource Manager sous la forme /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Nom Type Description
id

string

ID de ressource

SupportedCapabilities

Liste des fonctionnalités prises en charge persistantes sur la ressource de disque pour l’utilisation de la machine virtuelle.

Nom Type Description
acceleratedNetwork

boolean

True si l’image à partir de laquelle le disque du système d’exploitation est créé prend en charge la mise en réseau accélérée.

architecture

Architecture

Architecture du processeur prise en charge par un disque de système d’exploitation.

diskControllerTypes

string

Contrôleurs de disque pris en charge par un disque de système d’exploitation. S’il est défini, il peut être SCSI ou SCSI, NVME ou NVME, SCSI.