Skip to content

Commit 8698f1e

Browse files
author
Vamsi Kavuru
committed
Made chnages to ADH-How-to doc to include ultra ssd
1 parent 260d04a commit 8698f1e

File tree

1 file changed

+39
-4
lines changed

1 file changed

+39
-4
lines changed

articles/virtual-machines/dedicated-hosts-how-to.md

Lines changed: 39 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ This article guides you through how to create an Azure [dedicated host](dedicate
2424
## Limitations
2525

2626
- The sizes and hardware types available for dedicated hosts vary by region. Refer to the host [pricing page](https://aka.ms/ADHPricing) to learn more.
27+
- Not all Azure VM SKUs, regions and availability zones support ultra disks, see [Azure ultra disks](disks-enable-ultra-ssd.md) for more information.
2728
- The fault domain count of the virtual machine scale set can't exceed the fault domain count of the host group.
2829

2930
## Create a host group
@@ -36,6 +37,10 @@ In either case, you need to provide the fault domain count for your host group.
3637

3738
You can also decide to use both availability zones and fault domains.
3839

40+
Enabling ultra disks is a host group level setting and cannot be changed after a host group is created.
41+
42+
If you intend to use Lsv2 based VM SKUs with ultra disks on ADH, set host group's **Fault domain count** to **1**.
43+
3944
### [Portal](#tab/portal)
4045

4146
In this example, we'll create a host group using one availability zone and two fault domains.
@@ -49,6 +54,7 @@ In this example, we'll create a host group using one availability zone and two f
4954
1. For **Host group name**, type *myHostGroup*.
5055
1. For **Location**, select **East US**.
5156
1. For **Availability Zone**, select **1**.
57+
1. Select **Enable Ultra SSD** (Preview) to use ultra disks with supported Virtual Machines.
5258
1. For **Fault domain count**, select **2**.
5359
1. Select **Automatic placement** to automatically assign VMs and scale set instances to an available host in this group.
5460
1. Select **Review + create** and then wait for validation.
@@ -64,6 +70,17 @@ Not all host SKUs are available in all regions, and availability zones. You can
6470
```azurecli-interactive
6571
az vm list-skus -l eastus2 -r hostGroups/hosts -o table
6672
```
73+
You can also verify if a VM series supports ultra disks.
74+
75+
```azurecli-interactive
76+
subscription="<mySubID>"
77+
# example value is southeastasia
78+
region="<myLocation>"
79+
# example value is Standard_E64s_v3
80+
vmSize="<myVMSize>"
81+
82+
az vm list-skus --resource-type virtualMachines --location $region --query "[?name=='$vmSize'].locationInfo[0].zoneDetails[0].Name" --subscription $subscription
83+
```
6784

6885
In this example, we'll use [az vm host group create](/cli/azure/vm/host/group#az-vm-host-group-create) to create a host group using both availability zones and fault domains.
6986

@@ -77,6 +94,8 @@ az vm host group create \
7794

7895
Add the `--automatic-placement true` parameter to have your VMs and scale set instances automatically placed on hosts, within a host group. For more information, see [Manual vs. automatic placement ](dedicated-hosts.md#manual-vs-automatic-placement).
7996

97+
Add the `--ultra-ssd-enabled true` (Preview) parameter to enable creation of VMs that can support ultra disks.
98+
8099

81100
**Other examples**
82101

@@ -99,6 +118,17 @@ az vm host group create \
99118
--platform-fault-domain-count 2
100119
```
101120

121+
The following uses [az vm host group create](/cli/azure/vm/host/group#az-vm-host-group-create) to create a host group that supports ultra SSD disks and auto placement of VMs enabled.
122+
123+
```azurecli-interactive
124+
az vm host group create \
125+
--name myFDHostGroup \
126+
-g myDHResourceGroup \
127+
-z 1 \
128+
--ultra-ssd-enabled true \
129+
--platform-fault-domain-count 2 \
130+
--automatic-placement true
131+
```
102132
### [PowerShell](#tab/powershell)
103133

104134
This example uses [New-AzHostGroup](/powershell/module/az.compute/new-azhostgroup) to create a host group in zone 1, with 2 fault domains.
@@ -110,16 +140,19 @@ $location = "EastUS"
110140
111141
New-AzResourceGroup -Location $location -Name $rgName
112142
$hostGroup = New-AzHostGroup `
113-
-Location $location `
114143
-Name myHostGroup `
115-
-PlatformFaultDomain 2 `
116144
-ResourceGroupName $rgName `
117-
-Zone 1
145+
-Location $location `
146+
-Zone 1 `
147+
-EnableUltraSSD true `
148+
-PlatformFaultDomain 2 `
149+
-SupportAutomaticPlacement true
118150
```
119151

120-
121152
Add the `-SupportAutomaticPlacement true` parameter to have your VMs and scale set instances automatically placed on hosts, within a host group. For more information, see [Manual vs. automatic placement ](dedicated-hosts.md#manual-vs-automatic-placement).
122153

154+
Add the `-EnableUltraSSD true` (Preview) parameter to enable creation of VMs that can support ultra disks.
155+
123156
---
124157

125158

@@ -177,6 +210,8 @@ $dHost = New-AzHost `
177210

178211
Now create a VM on the host.
179212

213+
If you would like to create a VM with ultra disks support, make sure the host group in which the VM will be placed is ultra SSD enabled (Preview). Once you've confirmed, create the VM in the same host group. See [Deploy an ultra disk](disks-enable-ultra-ssd.md#deploy-an-ultra-disk) for the steps to attach an ultra disk to a VM.
214+
180215
### [Portal](#tab/portal)
181216

182217
1. Choose **Create a resource** in the upper left corner of the Azure portal.

0 commit comments

Comments
 (0)