Skip to content

Commit 81005ea

Browse files
committed
move registration details
1 parent cd272a1 commit 81005ea

7 files changed

+36
-22
lines changed

articles/azure-netapp-files/azure-netapp-files-create-volumes-smb.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -118,13 +118,11 @@ Before creating an SMB volume, you need to create an Active Directory connection
118118
* Select your **Active Directory** connection from the drop-down list.
119119
120120
* Specify a unique **share name** for the volume. This share name is used when you create mount targets. The requirements for the share name are as follows:
121-
- For volumes not in an availability zone or volumes in the same availability zone, it must be unique within each subnet in the region.
122-
- For volumes in availability zones, it must be unique within each availability zone.*
121+
- For volumes not in an availability zone or volumes in the same availability zone, it must be unique within each subnet in the region.
122+
- For volumes in availability zones, it must be unique within each availability zone. This feature is currently in **preview** and requires you to register the feature. For more information and, see [Manage availability zone volume placement](manage-availability-zone-volume-placement.md#file-path-uniqueness).
123123
- It can contain only letters, numbers, or dashes (`-`).
124124
- The length must not exceed 80 characters.
125125
126-
[!INCLUDE [File path uniqueness preview registration](./includes/file-path-uniqueness.md)]
127-
128126
* <a name="smb3-encryption"></a>If you want to enable encryption for SMB3, select **Enable SMB3 Protocol Encryption**.
129127
130128
This feature enables encryption for in-flight SMB3 data. SMB clients not using SMB3 encryption will not be able to access this volume. Data at rest is encrypted regardless of this setting.

articles/azure-netapp-files/azure-netapp-files-create-volumes.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -113,14 +113,12 @@ This article shows you how to create an NFS volume. For SMB volumes, see [Create
113113
* Select **NFS** as the protocol type for the volume.
114114

115115
* Specify a unique **file path** for the volume. This path is used when you create mount targets. The requirements for the path are as follows:
116-
- For volumes not in an availability zone or volumes in the same availability zone, it must be unique within each subnet in the region.
116+
- For volumes not in an availability zone or volumes in the same availability zone, it must be unique within each subnet in the region. This feature is currently in **preview** and requires you to register the feature. For more information and, see [Manage availability zone volume placement](manage-availability-zone-volume-placement.md#file-path-uniqueness).
117117
- For volumes in availability zones, it must be unique within each availability zone.*
118118
- It must start with an alphabetical character.
119119
- It can contain only letters, numbers, or dashes (`-`).
120120
- The length must not exceed 80 characters.
121121

122-
[!INCLUDE [File path uniqueness preview registration](./includes/file-path-uniqueness.md)]
123-
124122
* Select the **Version** (**NFSv3** or **NFSv4.1**) for the volume.
125123

126124
* If you are using NFSv4.1, indicate whether you want to enable **Kerberos** encryption for the volume.

articles/azure-netapp-files/create-volumes-dual-protocol.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -152,14 +152,12 @@ You can also use [Azure CLI commands](/cli/azure/feature) `az feature register`
152152
153153
* Specify a unique **Volume Path**. This path is used when you create mount targets. The requirements for the path are as follows:
154154
155-
- For volumes not in an availability zone or volumes in the same availability zone, it must be unique within each subnet in the region.
156-
- For volumes in availability zones, it must be unique within each availability zone.*
155+
- For volumes not in an availability zone or volumes in the same availability zone, the volume path must be unique within each subnet in the region.
156+
- For volumes in availability zones, the volume path must be unique within each availability zone. This feature is currently in **preview** and requires you to register the feature. For more information and, see [Manage availability zone volume placement](manage-availability-zone-volume-placement.md#file-path-uniqueness).
157157
- It must start with an alphabetical character.
158158
- It can contain only letters, numbers, or dashes (`-`).
159159
- The length must not exceed 80 characters.
160160
161-
[!INCLUDE [File path uniqueness preview registration](./includes/file-path-uniqueness.md)]
162-
163161
* Specify the **versions** to use for dual protocol: **NFSv4.1 and SMB**, or **NFSv3 and SMB**.
164162
165163
* Specify the **Security Style** to use: NTFS (default) or UNIX.

articles/azure-netapp-files/faq-nfs.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,13 @@ To avoid any issues with clients mounting NFSv4.2 and to comply with supportabil
3737

3838
You can specify whether the root account can access the volume or not by using the volume’s export policy. See [Configure export policy for an NFS volume](azure-netapp-files-configure-export-policy.md) for details.
3939

40-
## Can I use the same file path (volume creation token) for multiple volumes?
40+
## Can I use the same file path for multiple volumes?
4141

42-
For volumes not in an availability zone or volumes in the same availability zone, you can use the same file path (creation token). However, the file path must be unique within each delegated subnet.
42+
For volumes not in an availability zone or volumes in the same availability zone, you can use the same file path. However, the file path must be unique within each delegated subnet.
4343

44-
For volumes deployed to different availability zones within the same region, the same file path (creation token) can be used.
44+
For volumes deployed to different availability zones within the same region, the same file path can be used.
4545

46-
For volumes deployed to different regions, the same file path (creation token) can be used.
46+
For volumes deployed to different regions, the same file path can be used.
4747

4848
For more information, see [Create an NFS volume for Azure NetApp Files](azure-netapp-files-create-volumes.md) or [Create a dual-protocol volume for Azure NetApp Files](create-volumes-dual-protocol.md).
4949

articles/azure-netapp-files/faq-smb.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -80,13 +80,13 @@ See [Modify SMB share permissions](azure-netapp-files-create-volumes-smb.md#modi
8080

8181
Azure NetApp Files also supports [access-based enumeration](azure-netapp-files-create-volumes-smb.md#access-based-enumeration) and [non-browsable shares](azure-netapp-files-create-volumes-smb.md#non-browsable-share) on SMB and dual-protocol volumes. You can enable these features during or after the creation of an SMB or dual-protocol volume.
8282

83-
## Can I use the same share name (volume creation token) for multiple volumes?
83+
## Can I use the same share name for multiple volumes?
8484

85-
For volumes not in an availability zone or volumes in the same availability zone, you can use the same file path (creation token). However, the share name must be unique within each delegated subnet.
85+
For volumes not in an availability zone or volumes in the same availability zone, you can use the same file path. However, the share name must be unique within each delegated subnet.
8686

87-
For volumes deployed to different availability zones within the same region, the same share name (creation token) can be used.
87+
For volumes deployed to different availability zones within the same region, the same share name can be used.
8888

89-
For volumes deployed to different regions, the same share name (creation token) can be used.
89+
For volumes deployed to different regions, the same share name can be used.
9090

9191
For more information, see For more information, see [Create an SMB volume for Azure NetApp Files](azure-netapp-files-create-volumes-smb.md) or [Create a dual-protocol volume for Azure NetApp Files](create-volumes-dual-protocol.md).
9292

articles/azure-netapp-files/manage-availability-zone-volume-placement.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,28 @@ You can deploy new volumes in the logical availability zone of your choice. You
3434

3535
* VMs and Azure NetApp Files volumes are to be deployed separately, within the same logical availability zone to create zone alignment between VMs and Azure NetApp Files. The availability zone volume placement feature doesn't create zonal VMs upon volume creation, or vice versa.
3636

37-
[!INCLUDE [Availability Zone volumes have the same level of support as other volumes in the subscription](includes/availability-zone-service-callout.md)]
37+
* <a name="file-path-uniqueness"></a> For volumes in the same availability zone, Azure NetApp Files allows you to create volumes with the same file path (NFS), share name (SMB), or volume path (dual-protocol). This feature is currently in preview.
38+
39+
You need to register the feature before using it for the first time. After registration, the feature is enabled and works in the background. No UI control is required.
40+
41+
1. Register the feature:
42+
43+
```azurepowershell-interactive
44+
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFFilePathUniquenessInAz
45+
```
46+
47+
2. Check the status of the feature registration:
48+
49+
> [!NOTE]
50+
> The **RegistrationState** may be in the `Registering` state for up to 60 minutes before changing to`Registered`. Wait until the status is **Registered** before continuing.
51+
52+
```azurepowershell-interactive
53+
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFFilePathUniquenessInAz
54+
```
55+
You can also use [Azure CLI commands](/cli/azure/feature) `az feature register` and `az feature show` to register the feature and display the registration status.
56+
57+
58+
[!INCLUDE [Availability Zone volumes have the same level of support as other volumes in the subscription](includes/availability-zone-service-calvlout.md)]
3859
3960
>[!IMPORTANT]
4061
>It's not recommended that you use availability zones for Terraform-managed volumes. If you do, you must [add the zone property to your volume](#populate-availability-zone-for-terraform-managed-volumes).

articles/azure-netapp-files/whats-new.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,7 @@ ms.author: anfdocs
2121

2222
Azure NetApp Files is updated regularly. This article provides a summary about the latest new features and enhancements.
2323

24-
[Volume enhancement: create volumes with the same file path, share name, or volume path in different availability zones]
25-
(Preview)
24+
* [Volume enhancement: create volumes with the same file path, share name, or volume path in different availability zones](manage-availability-zone-volume-placement.md#file-path-uniqueness) (Preview)
2625

2726
Azure NetApp Files now allows you to create volumes with the same file path (NFS), share name (SMB), or volume path (dual-protocol) as long as they are in different availability zones. For more information, see [Create an NFS volume for Azure NetApp Files](azure-netapp-files-create-volumes.md), [Create an SMB volume for Azure NetApp Files](azure-netapp-files-create-volumes-smb.md), or [Create a dual-protocol volume for Azure NetApp Files](create-volumes-dual-protocol.md). This enhancement is currently in preview.
2827

0 commit comments

Comments
 (0)