Skip to content

Commit 79deae1

Browse files
v-shilsv-shils
authored
Merge pull request #248861 from jimmart-dev/jammart-elastic-san-create-command-cleanup
elastic san create command samples refine
2 parents 1843cfa + 94afb48 commit 79deae1

File tree

1 file changed

+54
-23
lines changed

1 file changed

+54
-23
lines changed

‎articles/storage/elastic-san/elastic-san-create.md

Lines changed: 54 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to deploy an Azure Elastic SAN (preview) with the Azure p
44
author: roygara
55
ms.service: azure-elastic-san-storage
66
ms.topic: how-to
7-
ms.date: 08/16/2023
7+
ms.date: 08/21/2023
88
ms.author: rogarana
99
ms.custom: references_regions, ignite-2022, devx-track-azurepowershell, devx-track-azurecli
1010
---
@@ -42,55 +42,86 @@ This article explains how to deploy and configure an elastic storage area networ
4242

4343
# [PowerShell](#tab/azure-powershell)
4444

45-
Replace all placeholder text with your own values when assigning values to variables and use the same variables in of all the examples in this article:
45+
Use one of these sets of sample code to create an Elastic SAN that uses locally redundant storage or zone-redundant storage. Replace all placeholder text with your own values and use the same variables in of all the examples in this article:
4646

4747
| Placeholder | Description |
4848
|----------------------------------|-------------|
49-
| `<ResourceGroupName>` | The name of the resource group where the resources are to be deployed. |
50-
| `<ElasticSanName>` | The name of the Elastic SAN to be created. |
49+
| `<ResourceGroupName>` | The name of the resource group where the resources will be deployed. |
50+
| `<ElasticSanName>` | The name of the Elastic SAN to be created.<br>*The Elastic SAN name must be between 3 and 24 characters long. The name may only contain lowercase letters, numbers, hyphens and underscores, and must begin and end with a letter or a number. Each hyphen and underscore must be preceded and followed by an alphanumeric character.* |
5151
| `<ElasticSanVolumeGroupName>` | The name of the Elastic SAN Volume Group to be created. |
5252
| `<VolumeName>` | The name of the Elastic SAN Volume to be created. |
53-
| `<Location>` | The region where new resources will be created. |
53+
| `<Location>` | The region where the new resources will be created. |
54+
| `<Zone>` | The availability zone where the Elastic SAN will be created.<br> *Specify the same availability zone as the zone that will host your workload.*<br>*Use only if the Elastic SAN will use locally-redundant storage.*<br> *Must be a zone supported in the target location such as `1`, `2`, or `3`.* |
5455

55-
The following command creates an Elastic SAN that uses locally redundant storage. To create one that uses zone-redundant storage, replace `Premium_LRS` with `Premium_ZRS`.
56+
The following command creates an Elastic SAN that uses **locally-redundant** storage.
5657

5758
```azurepowershell
58-
## Variables
59-
$RgName = "<ResourceGroupName>"
60-
## Select the same availability zone as where you plan to host your workload
61-
$Zone = 1
62-
## Select the same region as your Azure virtual network
63-
$Location = "<Location>"
64-
$EsanName = "<ElasticSanName>"
59+
# Define some variables.
60+
$RgName = "<ResourceGroupName>"
61+
$EsanName = "<ElasticSanName>"
6562
$EsanVgName = "<ElasticSanVolumeGroupName>"
6663
$VolumeName = "<VolumeName>"
64+
$Location = "<Location>"
65+
$Zone = <Zone>
6766
68-
## Create the SAN, itself
67+
# Create the SAN.
6968
New-AzElasticSAN -ResourceGroupName $RgName -Name $EsanName -AvailabilityZone $Zone -Location $Location -BaseSizeTib 100 -ExtendedCapacitySizeTiB 20 -SkuName Premium_LRS
7069
```
70+
71+
The following command creates an Elastic SAN that uses **zone-redundant** storage.
72+
73+
```azurepowershell
74+
# Define some variables.
75+
$RgName = "<ResourceGroupName>"
76+
$EsanName = "<ElasticSanName>"
77+
$EsanVgName = "<ElasticSanVolumeGroupName>"
78+
$VolumeName = "<VolumeName>"
79+
$Location = "<Location>"
80+
81+
# Create the SAN
82+
New-AzElasticSAN -ResourceGroupName $RgName -Name $EsanName -Location $Location -BaseSizeTib 100 -ExtendedCapacitySizeTiB 20 -SkuName Premium_ZRS
83+
```
84+
7185
# [Azure CLI](#tab/azure-cli)
7286

73-
Replace all placeholder text with your own values when assigning values to variables and use the same variables in of all the examples in this article:
87+
Use one of these sets of sample code to create an Elastic SAN that uses locally redundant storage or zone-redundant storage. Replace all placeholder text with your own values and use the same variables in of all the examples in this article:
7488

7589
| Placeholder | Description |
7690
|----------------------------------|-------------|
77-
| `<ResourceGroupName>` | The name of the resource group where the resources are to be deployed. |
78-
| `<ElasticSanName>` | The name of the Elastic SAN to be created. |
91+
| `<ResourceGroupName>` | The name of the resource group where the resources will be deployed. |
92+
| `<ElasticSanName>` | The name of the Elastic SAN to be created.<br>*The Elastic SAN name must be between 3 and 24 characters long. The name may only contain lowercase letters, numbers, hyphens and underscores, and must begin and end with a letter or a number. Each hyphen and underscore must be preceded and followed by an alphanumeric character.* |
7993
| `<ElasticSanVolumeGroupName>` | The name of the Elastic SAN Volume Group to be created. |
8094
| `<VolumeName>` | The name of the Elastic SAN Volume to be created. |
81-
| `<Location>` | The region where new resources will be created. |
95+
| `<Location>` | The region where the new resources will be created. |
96+
| `<Zone>` | The availability zone where the Elastic SAN will be created.<br> *Specify the same availability zone as the zone that will host your workload.*<br>*Use only if the Elastic SAN will use locally-redundant storage.*<br> *Must be a zone supported in the target location such as `1`, `2`, or `3`.* |
97+
98+
The following command creates an Elastic SAN that uses **locally-redundant** storage.
8299

83-
The following command creates an Elastic SAN that uses locally redundant storage. To create one that uses zone-redundant storage, replace `Premium_LRS` with `Premium_ZRS`.
100+
```azurecli
101+
# Define some variables.
102+
RgName="<ResourceGroupName>"
103+
EsanName="<ElasticSanName>"
104+
EsanVgName="<ElasticSanVolumeGroupName>"
105+
VolumeName="<VolumeName>"
106+
Location="<Location>"
107+
Zone=<Zone>
108+
109+
az elastic-san create -n $EsanName -g $RgName -l $Location --base-size-tib 100 --extended-capacity-size-tib 20 --sku "{name:Premium_LRS,tier:Premium}" --availability-zones $Zone
110+
```
111+
112+
The following command creates an Elastic SAN that uses **zone-redundant** storage.
84113

85114
```azurecli
86-
## Variables
115+
# Define some variables.
87116
RgName="<ResourceGroupName>"
88117
EsanName="<ElasticSanName>"
89118
EsanVgName="<ElasticSanVolumeGroupName>"
119+
VolumeName="<VolumeName>"
90120
Location="<Location>"
91121
92-
az elastic-san create -n $EsanName -g $RgName -l $Location --base-size-tib 100 --extended-capacity-size-tib 20 --sku "{name:Premium_LRS,tier:Premium}"
122+
az elastic-san create -n $EsanName -g $RgName -l $Location --base-size-tib 100 --extended-capacity-size-tib 20 --sku "{name:Premium_ZRS,tier:Premium}"
93123
```
124+
94125
---
95126

96127
## Create volume groups
@@ -109,7 +140,7 @@ Now that you've configured the basic settings and provisioned your storage, you
109140
The following sample command creates an Elastic SAN volume group in the Elastic SAN you created previously. Use the same variables and values you defined when you [created the Elastic SAN](#create-the-san).
110141

111142
```azurepowershell
112-
## Create the volume group, this script only creates one.
143+
# Create the volume group, this script only creates one.
113144
New-AzElasticSanVolumeGroup -ResourceGroupName $RgName -ElasticSANName $EsanName -Name $EsanVgName
114145
```
115146

@@ -147,7 +178,7 @@ The following sample command creates a single volume in the Elastic SAN volume g
147178
Use the same variables you set for , then run the following script:
148179

149180
```azurepowershell
150-
## Create the volume, this command only creates one.
181+
# Create the volume, this command only creates one.
151182
New-AzElasticSanVolume -ResourceGroupName $RgName -ElasticSanName $EsanName -VolumeGroupName $EsanVgName -Name $VolumeName -sizeGiB 2000
152183
```
153184

0 commit comments

Comments
 (0)