Skip to content

Commit 9e9933f

Browse files
authored
Merge pull request #161813 from andyzhangx/patch-15
Update use-ultra-disks.md
2 parents 7b12016 + fcf7fce commit 9e9933f

File tree

1 file changed

+6
-30
lines changed

1 file changed

+6
-30
lines changed

articles/aks/use-ultra-disks.md

Lines changed: 6 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -18,30 +18,6 @@ This feature can only be set at cluster creation or node pool creation time.
1818
> [!IMPORTANT]
1919
> Azure ultra disks require nodepools deployed in availability zones and regions that support these disks as well as only specific VM series. See the [**Ultra disks GA scope and limitations**](../virtual-machines/disks-enable-ultra-ssd.md#ga-scope-and-limitations).
2020
21-
### Register the `EnableUltraSSD` preview feature
22-
23-
To create an AKS cluster or a node pool that can leverage Ultra disks, you must enable the `EnableUltraSSD` feature flag on your subscription.
24-
25-
Register the `EnableUltraSSD` feature flag using the [az feature register][az-feature-register] command as shown in the following example:
26-
27-
```azurecli-interactive
28-
az feature register --namespace "Microsoft.ContainerService" --name "EnableUltraSSD"
29-
```
30-
31-
It takes a few minutes for the status to show *Registered*. You can check on the registration status using the [az feature list][az-feature-list] command:
32-
33-
```azurecli-interactive
34-
az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/EnableUltraSSD')].{Name:name,State:properties.state}"
35-
```
36-
37-
When ready, refresh the registration of the *Microsoft.ContainerService* resource provider using the [az provider register][az-provider-register] command:
38-
39-
```azurecli-interactive
40-
az provider register --namespace Microsoft.ContainerService
41-
```
42-
43-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
44-
4521
### Install aks-preview CLI extension
4622

4723
To create an AKS cluster or a node pool that can use Ultra Disks, you need the latest *aks-preview* CLI extension. Install the *aks-preview* Azure CLI extension using the [az extension add][az-extension-add] command, or install any available updates using the [az extension update][az-extension-update] command:
@@ -60,7 +36,7 @@ az extension update --name aks-preview
6036

6137
## Create a new cluster that can use Ultra disks
6238

63-
Create an AKS cluster that is able to leverage Ultra Disks by using the following CLI commands. Use the `--aks-custom-headers` flag to set the `EnableUltraSSD` feature.
39+
Create an AKS cluster that is able to leverage Ultra Disks by using the following CLI commands. Use the `--enable-ultra-ssd` flag to set the `EnableUltraSSD` feature.
6440

6541
Create an Azure resource group:
6642

@@ -73,20 +49,20 @@ Create the AKS cluster with support for Ultra Disks.
7349

7450
```azurecli-interactive
7551
# Create an AKS-managed Azure AD cluster
76-
az aks create -g MyResourceGroup -n MyManagedCluster -l westus2 --node-vm-size Standard_L8s_v2 --zones 1 2 --node-count 2 --aks-custom-headers EnableUltraSSD=true
52+
az aks create -g MyResourceGroup -n MyManagedCluster -l westus2 --node-vm-size Standard_D2s_v3 --zones 1 2 --node-count 2 --enable-ultra-ssd
7753
```
7854

79-
If you want to create clusters without ultra disk support, you can do so by omitting the custom `--aks-custom-headers` parameter.
55+
If you want to create clusters without ultra disk support, you can do so by omitting the `--enable-ultra-ssd` parameter.
8056

8157
## Enable Ultra disks on an existing cluster
8258

83-
You can enable ultra disks on existing clusters by adding a new node pool to your cluster that support ultra disks. Configure a new node pool to use ultra disks by using the `--aks-custom-headers` flag.
59+
You can enable ultra disks on existing clusters by adding a new node pool to your cluster that support ultra disks. Configure a new node pool to use ultra disks by using the `--enable-ultra-ssd` flag.
8460

8561
```azurecli
86-
az aks nodepool add --name ultradisk --cluster-name myAKSCluster --resource-group myResourceGroup --node-vm-size Standard_L8s_v2 --zones 1 2 --node-count 2 --aks-custom-headers EnableUltraSSD=true
62+
az aks nodepool add --name ultradisk --cluster-name myAKSCluster --resource-group myResourceGroup --node-vm-size Standard_D2s_v3 --zones 1 2 --node-count 2 --enable-ultra-ssd
8763
```
8864

89-
If you want to create new node pools without support for ultra disks, you can do so by omitting the custom `--aks-custom-headers` parameter.
65+
If you want to create new node pools without support for ultra disks, you can do so by omitting the `--enable-ultra-ssd` parameter.
9066

9167
## Use ultra disks dynamically with a storage class
9268

0 commit comments

Comments
 (0)