Disks - Get

Service:

Compute

API Version:

2023-10-02

Gets information about a disk.

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

URI Parameters

Name	In	Required	Type	Description
diskName	path	True	string	The name of the managed disk that is being created. The name can't be changed after the disk is created. Supported characters for the name are a-z, A-Z, 0-9, _ and -. The maximum name length is 80 characters.
resourceGroupName	path	True	string	The name of the resource group.
subscriptionId	path	True	string	Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
api-version	query	True	string	Client Api Version.

Responses

Name	Type	Description
200 OK	Disk	OK

Security

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Get information about a managed disk.

Sample request

HTTP

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

Java

/**
 * Samples for Disks GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.
     * json
     */
    /**
     * Sample code: Get information about a managed disk.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getInformationAboutAManagedDisk(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDisks().getByResourceGroupWithResponse("myResourceGroup",
            "myManagedDisk", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/81a4ee5a83ae38620c0e1404793caffe005d26e4/specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
func ExampleDisksClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewDisksClient().Get(ctx, "myResourceGroup", "myManagedDisk", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Disk = armcompute.Disk{
	// 	Name: to.Ptr("myManagedDisk"),
	// 	Type: to.Ptr("Microsoft.Compute/disks"),
	// 	ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"department": to.Ptr("Development"),
	// 		"project": to.Ptr("ManagedDisks"),
	// 	},
	// 	ManagedBy: to.Ptr("/subscriptions/123caaa-123v-v211-a49f-f88ccac5bf88/resourceGroups/ResourceGroupName/providers/Microsoft.Compute/virtualMachines/TestVM414689371c88843d65ec"),
	// 	Properties: &armcompute.DiskProperties{
	// 		LastOwnershipUpdateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2016-12-28T04:41:35.079Z"); return t}()),
	// 		CreationData: &armcompute.CreationData{
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionFromImage),
	// 			ImageReference: &armcompute.ImageDiskReference{
	// 				ID: to.Ptr("/Subscriptions/{subscription-id}/Providers/Microsoft.Compute/Locations/westus/Publishers/test_test_pmc2pc1/ArtifactTypes/VMImage/Offers/marketplace_vm_test/Skus/test_sku/Versions/1.0.0"),
	// 			},
	// 		},
	// 		DiskSizeGB: to.Ptr[int32](10),
	// 		Encryption: &armcompute.Encryption{
	// 			Type: to.Ptr(armcompute.EncryptionTypeEncryptionAtRestWithPlatformKey),
	// 		},
	// 		EncryptionSettingsCollection: &armcompute.EncryptionSettingsCollection{
	// 			Enabled: to.Ptr(true),
	// 			EncryptionSettings: []*armcompute.EncryptionSettingsElement{
	// 				{
	// 					DiskEncryptionKey: &armcompute.KeyVaultAndSecretReference{
	// 						SecretURL: to.Ptr("https://myvmvault.vault-int.azure-int.net/secrets/{secret}"),
	// 						SourceVault: &armcompute.SourceVault{
	// 							ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"),
	// 						},
	// 					},
	// 					KeyEncryptionKey: &armcompute.KeyVaultAndKeyReference{
	// 						KeyURL: to.Ptr("https://myvmvault.vault-int.azure-int.net/keys/{key}"),
	// 						SourceVault: &armcompute.SourceVault{
	// 							ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"),
	// 						},
	// 					},
	// 			}},
	// 		},
	// 		HyperVGeneration: to.Ptr(armcompute.HyperVGenerationV1),
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		PurchasePlan: &armcompute.DiskPurchasePlan{
	// 			Name: to.Ptr("test_sku"),
	// 			Product: to.Ptr("marketplace_vm_test"),
	// 			Publisher: to.Ptr("test_test_pmc2pc1"),
	// 		},
	// 		SecurityProfile: &armcompute.DiskSecurityProfile{
	// 			SecurityType: to.Ptr(armcompute.DiskSecurityTypesTrustedLaunch),
	// 		},
	// 		SupportedCapabilities: &armcompute.SupportedCapabilities{
	// 			AcceleratedNetwork: to.Ptr(true),
	// 		},
	// 		SupportsHibernation: to.Ptr(true),
	// 		TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2016-12-28T04:41:35.079Z"); return t}()),
	// 	},
	// 	SKU: &armcompute.DiskSKU{
	// 		Name: to.Ptr(armcompute.DiskStorageAccountTypesStandardLRS),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets information about a disk.
 *
 * @summary Gets information about a disk.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
 */
async function getInformationAboutAManagedDisk() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const diskName = "myManagedDisk";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.disks.get(resourceGroupName, diskName);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
// this example is just showing the usage of "Disks_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedDiskResource created on azure
// for more information of creating ManagedDiskResource, please refer to the document of ManagedDiskResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string diskName = "myManagedDisk";
ResourceIdentifier managedDiskResourceId = ManagedDiskResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, diskName);
ManagedDiskResource managedDisk = client.GetManagedDiskResource(managedDiskResourceId);

// invoke the operation
ManagedDiskResource result = await managedDisk.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedDiskData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:

200

{
  "managedBy": "/subscriptions/123caaa-123v-v211-a49f-f88ccac5bf88/resourceGroups/ResourceGroupName/providers/Microsoft.Compute/virtualMachines/TestVM414689371c88843d65ec",
  "sku": {
    "name": "Standard_LRS"
  },
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "purchasePlan": {
      "name": "test_sku",
      "publisher": "test_test_pmc2pc1",
      "product": "marketplace_vm_test"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "supportsHibernation": true,
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscription-id}/Providers/Microsoft.Compute/Locations/westus/Publishers/test_test_pmc2pc1/ArtifactTypes/VMImage/Offers/marketplace_vm_test/Skus/test_sku/Versions/1.0.0"
      }
    },
    "diskSizeGB": 10,
    "encryptionSettingsCollection": {
      "enabled": true,
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "sourceVault": {
              "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"
            },
            "secretUrl": "https://myvmvault.vault-int.azure-int.net/secrets/{secret}"
          },
          "keyEncryptionKey": {
            "sourceVault": {
              "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"
            },
            "keyUrl": "https://myvmvault.vault-int.azure-int.net/keys/{key}"
          }
        }
      ]
    },
    "encryption": {
      "type": "EncryptionAtRestWithPlatformKey"
    },
    "LastOwnershipUpdateTime": "2016-12-28T04:41:35.079872+00:00",
    "timeCreated": "2016-12-28T04:41:35.079872+00:00",
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.Compute/disks",
  "location": "westus",
  "tags": {
    "department": "Development",
    "project": "ManagedDisks"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk",
  "name": "myManagedDisk"
}

Definitions

Name	Description
Architecture	CPU architecture supported by an OS disk.
CreationData	Data used when creating a disk.
DataAccessAuthMode	Additional authentication requirements when exporting or uploading to a disk or snapshot.
Disk	Disk resource.
DiskCreateOption	This enumerates the possible sources of a disk's creation.
DiskSecurityProfile	Contains the security related information for the resource.
DiskSecurityTypes	Specifies the SecurityType of the VM. Applicable for OS disks only.
DiskSku	The disks sku name. Can be Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS, or PremiumV2_LRS.
DiskState	This enumerates the possible state of the disk.
DiskStorageAccountTypes	The sku name.
Encryption	Encryption at rest settings for disk or snapshot
EncryptionSettingsCollection	Encryption settings for disk or snapshot
EncryptionSettingsElement	Encryption settings for one disk volume.
EncryptionType	The type of key used to encrypt the data of the disk.
ExtendedLocation	The complex type of the extended location.
ExtendedLocationTypes	The type of the extended location.
HyperVGeneration	The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
ImageDiskReference	The source image used for creating the disk.
KeyVaultAndKeyReference	Key Vault Key Url and vault id of KeK, KeK is optional and when provided is used to unwrap the encryptionKey
KeyVaultAndSecretReference	Key Vault Secret Url and vault id of the encryption key
NetworkAccessPolicy	Policy for accessing the disk via network.
OperatingSystemTypes	The Operating System type.
PropertyUpdatesInProgress	Properties of the disk for which update is pending.
ProvisionedBandwidthCopyOption	If this field is set on a snapshot and createOption is CopyStart, the snapshot will be copied at a quicker speed.
PublicNetworkAccess	Policy for controlling export on the disk.
PurchasePlan	Used for establishing the purchase context of any 3rd Party artifact through MarketPlace.
ShareInfoElement
SourceVault	The vault id is an Azure Resource Manager Resource id in the form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	List of supported capabilities persisted on the disk resource for VM use.

Architecture

CPU architecture supported by an OS disk.

Name	Type	Description
Arm64	string
x64	string

CreationData

Data used when creating a disk.

Name	Type	Description
createOption	DiskCreateOption	This enumerates the possible sources of a disk's creation.
elasticSanResourceId	string	Required if createOption is CopyFromSanSnapshot. This is the ARM id of the source elastic san volume snapshot.
galleryImageReference	ImageDiskReference	Required if creating from a Gallery Image. The id/sharedGalleryImageId/communityGalleryImageId of the ImageDiskReference will be the ARM id of the shared galley image version from which to create a disk.
imageReference	ImageDiskReference	Disk source information for PIR or user images.
logicalSectorSize	integer	Logical sector size in bytes for Ultra disks. Supported values are 512 ad 4096. 4096 is the default.
performancePlus	boolean	Set this flag to true to get a boost on the performance target of the disk deployed, see here on the respective performance target. This flag can only be set on disk creation time and cannot be disabled after enabled.
provisionedBandwidthCopySpeed	ProvisionedBandwidthCopyOption	If this field is set on a snapshot and createOption is CopyStart, the snapshot will be copied at a quicker speed.
securityDataUri	string	If createOption is ImportSecure, this is the URI of a blob to be imported into VM guest state.
sourceResourceId	string	If createOption is Copy, this is the ARM id of the source snapshot or disk.
sourceUniqueId	string	If this field is set, this is the unique id identifying the source of this resource.
sourceUri	string	If createOption is Import, this is the URI of a blob to be imported into a managed disk.
storageAccountId	string	Required if createOption is Import. The Azure Resource Manager identifier of the storage account containing the blob to import as a disk.
uploadSizeBytes	integer	If createOption is Upload, this is the size of the contents of the upload including the VHD footer. This value should be between 20972032 (20 MiB + 512 bytes for the VHD footer) and 35183298347520 bytes (32 TiB + 512 bytes for the VHD footer).

DataAccessAuthMode

Additional authentication requirements when exporting or uploading to a disk or snapshot.

Name	Type	Description
AzureActiveDirectory	string	When export/upload URL is used, the system checks if the user has an identity in Azure Active Directory and has necessary permissions to export/upload the data. Please refer to aka.ms/DisksAzureADAuth.
None	string	No additional authentication would be performed when accessing export/upload URL.

Disk

Disk resource.

Name	Type	Description
extendedLocation	ExtendedLocation	The extended location where the disk will be created. Extended location cannot be changed.
id	string	Resource Id
location	string	Resource location
managedBy	string	A relative URI containing the ID of the VM that has the disk attached.
managedByExtended	string[]	List of relative URIs containing the IDs of the VMs that have the disk attached. maxShares should be set to a value greater than one for disks to allow attaching them to multiple VMs.
name	string	Resource name
properties.LastOwnershipUpdateTime	string	The UTC time when the ownership state of the disk was last changed i.e., the time the disk was last attached or detached from a VM or the time when the VM to which the disk was attached was deallocated or started.
properties.burstingEnabled	boolean	Set to true to enable bursting beyond the provisioned performance target of the disk. Bursting is disabled by default. Does not apply to Ultra disks.
properties.burstingEnabledTime	string	Latest time when bursting was last enabled on a disk.
properties.completionPercent	number	Percentage complete for the background copy when a resource is created via the CopyStart operation.
properties.creationData	CreationData	Disk source information. CreationData information cannot be changed after the disk has been created.
properties.dataAccessAuthMode	DataAccessAuthMode	Additional authentication requirements when exporting or uploading to a disk or snapshot.
properties.diskAccessId	string	ARM id of the DiskAccess resource for using private endpoints on disks.
properties.diskIOPSReadOnly	integer	The total number of IOPS that will be allowed across all VMs mounting the shared disk as ReadOnly. One operation can transfer between 4k and 256k bytes.
properties.diskIOPSReadWrite	integer	The number of IOPS allowed for this disk; only settable for UltraSSD disks. One operation can transfer between 4k and 256k bytes.
properties.diskMBpsReadOnly	integer	The total throughput (MBps) that will be allowed across all VMs mounting the shared disk as ReadOnly. MBps means millions of bytes per second - MB here uses the ISO notation, of powers of 10.
properties.diskMBpsReadWrite	integer	The bandwidth allowed for this disk; only settable for UltraSSD disks. MBps means millions of bytes per second - MB here uses the ISO notation, of powers of 10.
properties.diskSizeBytes	integer	The size of the disk in bytes. This field is read only.
properties.diskSizeGB	integer	If creationData.createOption is Empty, this field is mandatory and it indicates the size of the disk to create. If this field is present for updates or creation with other options, it indicates a resize. Resizes are only allowed if the disk is not attached to a running VM, and can only increase the disk's size.
properties.diskState	DiskState	The state of the disk.
properties.encryption	Encryption	Encryption property can be used to encrypt data at rest with customer managed keys or platform managed keys.
properties.encryptionSettingsCollection	EncryptionSettingsCollection	Encryption settings collection used for Azure Disk Encryption, can contain multiple encryption settings per disk or snapshot.
properties.hyperVGeneration	HyperVGeneration	The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
properties.maxShares	integer	The maximum number of VMs that can attach to the disk at the same time. Value greater than one indicates a disk that can be mounted on multiple VMs at the same time.
properties.networkAccessPolicy	NetworkAccessPolicy	Policy for accessing the disk via network.
properties.optimizedForFrequentAttach	boolean	Setting this property to true improves reliability and performance of data disks that are frequently (more than 5 times a day) by detached from one virtual machine and attached to another. This property should not be set for disks that are not detached and attached frequently as it causes the disks to not align with the fault domain of the virtual machine.
properties.osType	OperatingSystemTypes	The Operating System type.
properties.propertyUpdatesInProgress	PropertyUpdatesInProgress	Properties of the disk for which update is pending.
properties.provisioningState	string	The disk provisioning state.
properties.publicNetworkAccess	PublicNetworkAccess	Policy for controlling export on the disk.
properties.purchasePlan	PurchasePlan	Purchase plan information for the the image from which the OS disk was created. E.g. - {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}
properties.securityProfile	DiskSecurityProfile	Contains the security related information for the resource.
properties.shareInfo	ShareInfoElement[]	Details of the list of all VMs that have the disk attached. maxShares should be set to a value greater than one for disks to allow attaching them to multiple VMs.
properties.supportedCapabilities	SupportedCapabilities	List of supported capabilities for the image from which the OS disk was created.
properties.supportsHibernation	boolean	Indicates the OS on a disk supports hibernation.
properties.tier	string	Performance tier of the disk (e.g, P4, S10) as described here: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Does not apply to Ultra disks.
properties.timeCreated	string	The time when the disk was created.
properties.uniqueId	string	Unique Guid identifying the resource.
sku	DiskSku	The disks sku name. Can be Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS, or PremiumV2_LRS.
tags	object	Resource tags
type	string	Resource type
zones	string[]	The Logical zone list for Disk.

DiskCreateOption

This enumerates the possible sources of a disk's creation.

Name	Type	Description
Attach	string	Disk will be attached to a VM.
Copy	string	Create a new disk or snapshot by copying from a disk or snapshot specified by the given sourceResourceId.
CopyFromSanSnapshot	string	Create a new disk by exporting from elastic san volume snapshot
CopyStart	string	Create a new disk by using a deep copy process, where the resource creation is considered complete only after all data has been copied from the source.
Empty	string	Create an empty data disk of a size given by diskSizeGB.
FromImage	string	Create a new disk from a platform image specified by the given imageReference or galleryImageReference.
Import	string	Create a disk by importing from a blob specified by a sourceUri in a storage account specified by storageAccountId.
ImportSecure	string	Similar to Import create option. Create a new Trusted Launch VM or Confidential VM supported disk by importing additional blob for VM guest state specified by securityDataUri in storage account specified by storageAccountId
Restore	string	Create a new disk by copying from a backup recovery point.
Upload	string	Create a new disk by obtaining a write token and using it to directly upload the contents of the disk.
UploadPreparedSecure	string	Similar to Upload create option. Create a new Trusted Launch VM or Confidential VM supported disk and upload using write token in both disk and VM guest state

DiskSecurityProfile

Contains the security related information for the resource.

Name	Type	Description
secureVMDiskEncryptionSetId	string	ResourceId of the disk encryption set associated to Confidential VM supported disk encrypted with customer managed key
securityType	DiskSecurityTypes	Specifies the SecurityType of the VM. Applicable for OS disks only.

DiskSecurityTypes

Specifies the SecurityType of the VM. Applicable for OS disks only.

Name	Type	Description
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Indicates Confidential VM disk with both OS disk and VM guest state encrypted with a customer managed key
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Indicates Confidential VM disk with both OS disk and VM guest state encrypted with a platform managed key
ConfidentialVM_NonPersistedTPM	string	Indicates Confidential VM disk with a ephemeral vTPM. vTPM state is not persisted across VM reboots.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Indicates Confidential VM disk with only VM guest state encrypted
TrustedLaunch	string	Trusted Launch provides security features such as secure boot and virtual Trusted Platform Module (vTPM)

DiskSku

The disks sku name. Can be Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS, or PremiumV2_LRS.

Name	Type	Description
name	DiskStorageAccountTypes	The sku name.
tier	string	The sku tier.

DiskState

This enumerates the possible state of the disk.

Name	Type	Description
ActiveSAS	string	The disk currently has an Active SAS Uri associated with it.
ActiveSASFrozen	string	The disk is attached to a VM in hibernated state and has an active SAS URI associated with it.
ActiveUpload	string	A disk is created for upload and a write token has been issued for uploading to it.
Attached	string	The disk is currently attached to a running VM.
Frozen	string	The disk is attached to a VM which is in hibernated state.
ReadyToUpload	string	A disk is ready to be created by upload by requesting a write token.
Reserved	string	The disk is attached to a stopped-deallocated VM.
Unattached	string	The disk is not being used and can be attached to a VM.

DiskStorageAccountTypes

The sku name.

Name	Type	Description
PremiumV2_LRS	string	Premium SSD v2 locally redundant storage. Best for production and performance-sensitive workloads that consistently require low latency and high IOPS and throughput.
Premium_LRS	string	Premium SSD locally redundant storage. Best for production and performance sensitive workloads.
Premium_ZRS	string	Premium SSD zone redundant storage. Best for the production workloads that need storage resiliency against zone failures.
StandardSSD_LRS	string	Standard SSD locally redundant storage. Best for web servers, lightly used enterprise applications and dev/test.
StandardSSD_ZRS	string	Standard SSD zone redundant storage. Best for web servers, lightly used enterprise applications and dev/test that need storage resiliency against zone failures.
Standard_LRS	string	Standard HDD locally redundant storage. Best for backup, non-critical, and infrequent access.
UltraSSD_LRS	string	Ultra SSD locally redundant storage. Best for IO-intensive workloads such as SAP HANA, top tier databases (for example, SQL, Oracle), and other transaction-heavy workloads.

Encryption

Encryption at rest settings for disk or snapshot

Name	Type	Description
diskEncryptionSetId	string	ResourceId of the disk encryption set to use for enabling encryption at rest.
type	EncryptionType	The type of key used to encrypt the data of the disk.

EncryptionSettingsCollection

Encryption settings for disk or snapshot

Name	Type	Description
enabled	boolean	Set this flag to true and provide DiskEncryptionKey and optional KeyEncryptionKey to enable encryption. Set this flag to false and remove DiskEncryptionKey and KeyEncryptionKey to disable encryption. If EncryptionSettings is null in the request object, the existing settings remain unchanged.
encryptionSettings	EncryptionSettingsElement[]	A collection of encryption settings, one for each disk volume.
encryptionSettingsVersion	string	Describes what type of encryption is used for the disks. Once this field is set, it cannot be overwritten. '1.0' corresponds to Azure Disk Encryption with AAD app.'1.1' corresponds to Azure Disk Encryption.

EncryptionSettingsElement

Encryption settings for one disk volume.

Name	Type	Description
diskEncryptionKey	KeyVaultAndSecretReference	Key Vault Secret Url and vault id of the disk encryption key
keyEncryptionKey	KeyVaultAndKeyReference	Key Vault Key Url and vault id of the key encryption key. KeyEncryptionKey is optional and when provided is used to unwrap the disk encryption key.

EncryptionType

The type of key used to encrypt the data of the disk.

Name	Type	Description
EncryptionAtRestWithCustomerKey	string	Disk is encrypted at rest with Customer managed key that can be changed and revoked by a customer.
EncryptionAtRestWithPlatformAndCustomerKeys	string	Disk is encrypted at rest with 2 layers of encryption. One of the keys is Customer managed and the other key is Platform managed.
EncryptionAtRestWithPlatformKey	string	Disk is encrypted at rest with Platform managed key. It is the default encryption type. This is not a valid encryption type for disk encryption sets.

ExtendedLocation

The complex type of the extended location.

Name	Type	Description
name	string	The name of the extended location.
type	ExtendedLocationTypes	The type of the extended location.

ExtendedLocationTypes

The type of the extended location.

Name	Type	Description
EdgeZone	string

HyperVGeneration

The hypervisor generation of the Virtual Machine. Applicable to OS disks only.

Name	Type	Description
V1	string
V2	string

ImageDiskReference

The source image used for creating the disk.

Name	Type	Description
communityGalleryImageId	string	A relative uri containing a community Azure Compute Gallery image reference.
id	string	A relative uri containing either a Platform Image Repository, user image, or Azure Compute Gallery image reference.
lun	integer	If the disk is created from an image's data disk, this is an index that indicates which of the data disks in the image to use. For OS disks, this field is null.
sharedGalleryImageId	string	A relative uri containing a direct shared Azure Compute Gallery image reference.

KeyVaultAndKeyReference

Key Vault Key Url and vault id of KeK, KeK is optional and when provided is used to unwrap the encryptionKey

Name	Type	Description
keyUrl	string	Url pointing to a key or secret in KeyVault
sourceVault	SourceVault	Resource id of the KeyVault containing the key or secret

KeyVaultAndSecretReference

Key Vault Secret Url and vault id of the encryption key

Name	Type	Description
secretUrl	string	Url pointing to a key or secret in KeyVault
sourceVault	SourceVault	Resource id of the KeyVault containing the key or secret

NetworkAccessPolicy

Policy for accessing the disk via network.

Name	Type	Description
AllowAll	string	The disk can be exported or uploaded to from any network.
AllowPrivate	string	The disk can be exported or uploaded to using a DiskAccess resource's private endpoints.
DenyAll	string	The disk cannot be exported.

OperatingSystemTypes

The Operating System type.

Name	Type	Description
Linux	string
Windows	string

PropertyUpdatesInProgress

Properties of the disk for which update is pending.

Name	Type	Description
targetTier	string	The target performance tier of the disk if a tier change operation is in progress.

ProvisionedBandwidthCopyOption

If this field is set on a snapshot and createOption is CopyStart, the snapshot will be copied at a quicker speed.

Name	Type	Description
Enhanced	string
None	string

PublicNetworkAccess

Policy for controlling export on the disk.

Name	Type	Description
Disabled	string	You cannot access the underlying data of the disk publicly on the internet even when NetworkAccessPolicy is set to AllowAll. You can access the data via the SAS URI only from your trusted Azure VNET when NetworkAccessPolicy is set to AllowPrivate.
Enabled	string	You can generate a SAS URI to access the underlying data of the disk publicly on the internet when NetworkAccessPolicy is set to AllowAll. You can access the data via the SAS URI only from your trusted Azure VNET when NetworkAccessPolicy is set to AllowPrivate.

PurchasePlan

Used for establishing the purchase context of any 3rd Party artifact through MarketPlace.

Name	Type	Description
name	string	The plan ID.
product	string	Specifies the product of the image from the marketplace. This is the same value as Offer under the imageReference element.
promotionCode	string	The Offer Promotion Code.
publisher	string	The publisher ID.

ShareInfoElement

Name	Type	Description
vmUri	string	A relative URI containing the ID of the VM that has the disk attached.

SourceVault

The vault id is an Azure Resource Manager Resource id in the form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Name	Type	Description
id	string	Resource Id

SupportedCapabilities

List of supported capabilities persisted on the disk resource for VM use.

Name	Type	Description
acceleratedNetwork	boolean	True if the image from which the OS disk is created supports accelerated networking.
architecture	Architecture	CPU architecture supported by an OS disk.
diskControllerTypes	string	The disk controllers that an OS disk supports. If set it can be SCSI or SCSI, NVME or NVME, SCSI.