Enable on-demand bursting

Article
10/09/2024

Premium solid-state drives (SSD) have two available bursting models; credit-based bursting and on-demand bursting. This article covers how to switch to on-demand bursting. Disks that use the on-demand model can burst beyond their original provisioned targets. On-demand bursting occurs as often as needed by the workload, up to the maximum burst target. On-demand bursting incurs additional charges.

For details on disk bursting, see Managed disk bursting.

For the max burst targets on each supported disk, see Scalability and performance targets for VM disks.

Important

You don't need to follow the steps in this article to use credit-based bursting. By default, credit-based bursting is enabled on all eligible disks.

Before you enable on-demand bursting, understand the following:

On-demand bursting cannot be enabled on a premium SSD that has less than or equal to 512 GiB. Premium SSDs less than or equal to 512 GiB will always use credit-based bursting.
On-demand bursting is only supported on premium SSDs. If a premium SSD with on-demand bursting enabled is switched to another disk type, then disk bursting is disabled.
On-demand bursting doesn't automatically disable itself when the performance tier is changed. If you want to change your performance tier but do not want to keep disk bursting, you must disable it.
On-demand bursting can only be enabled when the disk is detached from a VM or when the VM is stopped. On-demand bursting can be disabled 12 hours after it has been enabled.

Regional availability

Currently, the on-demand model for disk bursting is available in all Azure China regions.

Get started

On-demand bursting can be enabled with either the Azure portal, the Azure PowerShell module, the Azure CLI, or Azure Resource Manager templates. The following examples cover how to create a new disk with on-demand bursting enabled and enabling on-demand bursting on existing disks.

A managed disk must be larger than 512 GiB to enable on-demand bursting.

To enable on-demand bursting for an existing disk:

Sign in to the Azure portal and navigate to your disk.
Select Configuration and select Enable on-demand bursting.
Select Save.

On-demand bursting cmdlets are available in version 5.5.0 and newer of the Az module.

Create an empty data disk with on-demand bursting

A managed disk must be larger than 512 GiB to enable on-demand bursting. Replace the <myResourceGroupDisk> and <myDataDisk> parameters then run the following script to create a premium SSD with on-demand bursting:

Connect-AzAccount -Environment AzureChinaCloud
Set-AzContext -SubscriptionName <yourSubscriptionName>

$diskConfig = New-AzDiskConfig -Location 'chinanorth' -CreateOption Empty -DiskSizeGB 1024 -SkuName Premium_LRS -BurstingEnabled $true

$dataDisk = New-AzDisk -ResourceGroupName <myResourceGroupDisk> -DiskName <myDataDisk> -Disk $diskConfig

Enable on-demand bursting on an existing disk

A managed disk must be larger than 512 GiB to enable on-demand bursting. Replace the <myResourceGroupDisk>, <myDataDisk> parameters and run this command to enable on-demand bursting on an existing disk:

New-AzDiskUpdateConfig -BurstingEnabled $true | Update-AzDisk -ResourceGroupName <myResourceGroupDisk> -DiskName <myDataDisk> //Set the flag to $false to disable on-demand bursting

On-demand bursting cmdlets are available in version 2.19.0 and newer of the Azure CLI module.

Note

Before you can use Azure CLI in Microsoft Azure operated by 21Vianet, please run az cloud set -n AzureChinaCloud first to change the cloud environment. If you want to switch back to Azure Public Cloud, run az cloud set -n AzureCloud again.

Create and attach a on-demand bursting data disk

A managed disk must be larger than 512 GiB to enable on-demand bursting. Replace the <yourDiskName>, <yourResourceGroup>, and <yourVMName> parameters, then run the following commands to create a premium SSD with on-demand bursting:

az disk create -g <yourResourceGroup> -n <yourDiskName> --size-gb 1024 --sku Premium_LRS -l chinanorth --enable-bursting true

az vm disk attach --vm-name <yourVMName> --name <yourDiskName> --resource-group <yourResourceGroup>

Enable on-demand bursting on an existing disk - CLI

A managed disk must be larger than 512 GiB to enable on-demand bursting. Replace the <myResourceGroupDisk> and <yourDiskName> parameters and run this command to enable on-demand bursting on an existing disk:

az disk update --name <yourDiskName> --resource-group <yourResourceGroup> --enable-bursting true //Set the flag to false to disable on-demand bursting

With the 2020-09-30 disk API, you can enable on-demand bursting on newly-created or existing premium SSDs larger than 512 GiB. The 2020-09-30 API introduced a new property, burstingEnabled. By default, this property is set to false. The following sample template creates a 1TiB premium SSD in China North, with disk bursting enabled:

{
  "$schema": "http://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "diskSkuName": {
        "type": "string",
        "defaultValue": "Premium_LRS" //Supported on premium SSDs only
},
    "dataDiskSizeInGb": {
      "type": "string",
      "defaultValue": "1024" //Supported on disk size > 512 GiB
},
    "location": {
      "type": "string",
      "defaultValue": "chinanorth"
},
"diskApiVersion": {
      "type": "string",
      "defaultValue": "2020-09-30" //Preview supported version: 2020-09-30 or above
    }
  },
  "resources": [
    {
      "apiVersion": "[parameters('diskApiVersion')]",
      "type": "Microsoft.Compute/disks",
      "name": "[parameters('diskName')]",
      "location": "[parameters(location)]",
      "properties": {
        "creationData": {
          "createOption": "Empty"
        },
        "diskSizeGB": "[parameters('dataDiskSizeInGb')]",
        "burstingEnabled": "true" //Feature flag to enable disk bursting on disks > 512 GiB
      },
      "sku": {
        "name": "[parameters('diskSkuName')]"
      }
    ]
}

Next steps

To learn how to gain insight into your bursting resources, see Disk bursting metrics.

Enable on-demand bursting

Regional availability

Get started

Next steps

Additional resources