PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/disks/{diskName}/?api-version=2023-10-02
Updates (patches) a disk.
Servers
- https://management.azure.com/
Path parameters
Name | Type | Required | Description |
---|---|---|---|
diskName |
String | Yes |
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. |
subscriptionId |
String | Yes |
Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
resourceGroupName |
String | Yes |
The name of the resource group. |
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
sku |
Object | No |
The disks sku name. Can be Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS, or PremiumV2_LRS. |
sku.tier |
String | No |
The sku tier. |
sku.name |
String | No |
The sku name. Possible values:
|
properties |
Object | No |
Disk resource update properties. |
properties.encryptionSettingsCollection |
Object | No |
Encryption settings for disk or snapshot |
properties.encryptionSettingsCollection.encryptionSettings[] |
Array | No |
A collection of encryption settings, one for each disk volume. |
properties.encryptionSettingsCollection.encryptionSettings[].keyEncryptionKey |
Object | No |
Key Vault Key Url and vault id of KeK, KeK is optional and when provided is used to unwrap the encryptionKey |
properties.encryptionSettingsCollection.encryptionSettings[].keyEncryptionKey.sourceVault |
Object | Yes |
The vault id is an Azure Resource Manager Resource id in the form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName} |
properties.encryptionSettingsCollection.encryptionSettings[].keyEncryptionKey.sourceVault.id |
String | No |
Resource Id |
properties.encryptionSettingsCollection.encryptionSettings[].keyEncryptionKey.keyUrl |
String | Yes |
Url pointing to a key or secret in KeyVault |
properties.encryptionSettingsCollection.encryptionSettings[].diskEncryptionKey |
Object | No |
Key Vault Secret Url and vault id of the encryption key |
properties.encryptionSettingsCollection.encryptionSettings[].diskEncryptionKey.sourceVault |
Object | Yes |
The vault id is an Azure Resource Manager Resource id in the form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName} |
properties.encryptionSettingsCollection.encryptionSettings[].diskEncryptionKey.sourceVault.id |
String | No |
Resource Id |
properties.encryptionSettingsCollection.encryptionSettings[].diskEncryptionKey.secretUrl |
String | Yes |
Url pointing to a key or secret in KeyVault |
properties.encryptionSettingsCollection.enabled |
Boolean | Yes |
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. |
properties.encryptionSettingsCollection.encryptionSettingsVersion |
String | No |
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. |
properties.tier |
String | No |
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.dataAccessAuthMode |
String | No |
Additional authentication requirements when exporting or uploading to a disk or snapshot. Possible values:
|
properties.diskIOPSReadOnly |
Integer | No |
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.diskAccessId |
String | No |
ARM id of the DiskAccess resource for using private endpoints on disks. |
properties.propertyUpdatesInProgress |
Object | No |
Properties of the disk for which update is pending. |
properties.propertyUpdatesInProgress.targetTier |
String | No |
The target performance tier of the disk if a tier change operation is in progress. |
properties.maxShares |
Integer | No |
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.diskSizeGB |
Integer | No |
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.optimizedForFrequentAttach |
Boolean | No |
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.diskMBpsReadOnly |
Integer | No |
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.supportsHibernation |
Boolean | No |
Indicates the OS on a disk supports hibernation. |
properties.purchasePlan |
Object | No |
Used for establishing the purchase context of any 3rd Party artifact through MarketPlace. |
properties.purchasePlan.name |
String | Yes |
The plan ID. |
properties.purchasePlan.publisher |
String | Yes |
The publisher ID. |
properties.purchasePlan.product |
String | Yes |
Specifies the product of the image from the marketplace. This is the same value as Offer under the imageReference element. |
properties.purchasePlan.promotionCode |
String | No |
The Offer Promotion Code. |
properties.encryption |
Object | No |
Encryption at rest settings for disk or snapshot |
properties.encryption.diskEncryptionSetId |
String | No |
ResourceId of the disk encryption set to use for enabling encryption at rest. |
properties.encryption.type |
String | No |
The type of key used to encrypt the data of the disk. Possible values:
|
properties.diskIOPSReadWrite |
Integer | No |
The number of IOPS allowed for this disk; only settable for UltraSSD disks. One operation can transfer between 4k and 256k bytes. |
properties.osType |
String | No |
the Operating System type. Possible values:
|
properties.publicNetworkAccess |
String | No |
Policy for controlling export on the disk. Possible values:
|
properties.networkAccessPolicy |
String | No |
Policy for accessing the disk via network. Possible values:
|
properties.supportedCapabilities |
Object | No |
List of supported capabilities persisted on the disk resource for VM use. |
properties.supportedCapabilities.acceleratedNetwork |
Boolean | No |
True if the image from which the OS disk is created supports accelerated networking. |
properties.supportedCapabilities.diskControllerTypes |
String | No |
The disk controllers that an OS disk supports. If set it can be SCSI or SCSI, NVME or NVME, SCSI. |
properties.supportedCapabilities.architecture |
String | No |
CPU architecture supported by an OS disk. Possible values:
|
properties.diskMBpsReadWrite |
Integer | No |
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.burstingEnabled |
Boolean | No |
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. |
tags |
Object | No |
Resource tags |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.