Skip to content

Commit 8c5e49a

Browse files
committed
reword retrieval policy
1 parent c86e46c commit 8c5e49a

File tree

2 files changed

+52
-41
lines changed

2 files changed

+52
-41
lines changed

articles/azure-netapp-files/includes/cool-access-workflow.md

Whitespace-only changes.

articles/azure-netapp-files/manage-cool-access.md

Lines changed: 52 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.date: 05/14/2025
8+
ms.date: 06/06/2025
99
ms.author: anfdocs
1010
ms.custom:
1111
- build-2025
@@ -29,14 +29,23 @@ There are several considerations to be aware of when using cool access.
2929
* Although cool access is available for the Standard, Premium, and Ultra service levels, how you're billed for using the feature differs from the hot tier service-level charges. For details and examples, see the [Billing section](cool-access-introduction.md#billing).
3030
* Cool access supports two tiering policies: `Auto` and `SnapshotOnly`. The `SnapshotOnly` policy limits data tiering to data in snapshots, while all data blocks associated with files in the active file system remain in the hot tier. The `Auto` policy encompasses both snapshot copy data and data in the active file system.
3131
Throughput is based on the [the service level](azure-netapp-files-service-levels.md#supported-service-levels) for both the `Auto` and `SnapshotOnly` tiering policies.
32+
* To prevent data retrieval from the cool tier to the hot tier during sequential read operations (for example, antivirus or other file scanning operations), set the cool access retrieval policy to **Default** or **Never**. For more information about the retrieval policy, see [Enable cool access on a new volume](#enable-cool-access-on-a-new-volume).
33+
* Files moved to the cool tier remains there after you disable cool access on a volume. You must perform an I/O operation on _each_ file to return it to the warm tier.
34+
* For the maximum number of volumes supported for cool access per subscription per region, see [Resource limits for Azure NetApp Files](azure-netapp-files-resource-limits.md#resource-limits).
35+
* Cool access is supported with large volumes. Confirm that you're [registered to use large volumes](large-volumes-requirements-considerations.md#register-the-feature) before creating a cool-access-enabled large volume.
36+
37+
### Considerations for cool access-enabled capacity pools
38+
3239
* You can convert an existing capacity pool into a cool-access capacity pool to create cool access volumes. After the capacity pool is enabled for cool access, you can't convert it back to a non-cool-access capacity pool.
3340
* When you enable cool access, data that satisfies the conditions set by the coolness period moves to the cool tier. For example, if the coolness period is set to 30 days, any data that has been cool for at least 30 days moves to the cool tier _when_ you enable cool access. Once the coolness period is reached, background jobs can take up to 48 hours to initiate the data transfer to the cool tier.
3441
* A cool-access capacity pool can contain both volumes with cool access enabled and volumes with cool access disabled.
35-
* To prevent data retrieval from the cool tier to the hot tier during sequential read operations (for example, antivirus or other file scanning operations), set the cool access retrieval policy to **Default** or **Never**. For more information, see [Enable cool access on a new volume](#enable-cool-access-on-a-new-volume).
3642
* After the capacity pool is configured with the option to support cool access volumes, the setting can't be disabled at the _capacity pool_ level. You can turn on or turn off the cool access setting at the _volume_ level anytime. Turning off the cool access setting at the volume level stops further tiering of data. 
37-
* Files moved to the cool tier remains there after you disable cool access on a volume. You must perform an I/O operation on _each_ file to return it to the warm tier.
38-
* For the maximum number of volumes supported for cool access per subscription per region, see [Resource limits for Azure NetApp Files](azure-netapp-files-resource-limits.md#resource-limits).
39-
* Cool access is supported with large volumes. Confirm that you're [registered to use large volumes](large-volumes-requirements-considerations.md#register-the-feature) before creating a cool-access-enabled large volume.
43+
44+
#### Considerations for moving volumes to another capacity pool
45+
46+
* Volumes enabled for cool access can be moved between capacity pools only if those capacity pools are enabled for cool access. When a volume is enabled for cool access, it can only reside in a cool access-enabled capacity pool even if cool access has been disabled on the volume.
47+
* If you [move a cool access volume to another capacity pool (service level change)](dynamic-change-volume-service-level.md), you must also enable that pool for cool access.
48+
* If you disable cool access and turn off tiering on a cool access volume (that is, the volume no longer uses cool access), you can't move it to a non-cool-access capacity pool. In a cool access capacity pool, you can move all volumes, *whether they're enabled for cool access or not*, only to another cool access capacity pool.
4049

4150
### Considerations for throughput in Premium and Ultra service level volumes with cool access
4251

@@ -56,12 +65,6 @@ There are several considerations to be aware of when using cool access.
5665
- **Data rehydration:** Data isn't rehydrated to the hot tier when the volume is deleted, ensuring the deletion process is efficient and mitigating unnecessary data movement.
5766
- The only way to rehydrate data from the cool tier to the hot tier is for the client or application to read the data block.
5867

59-
### Considerations for moving volumes to another capacity pool
60-
61-
* Volumes enabled for cool access can be moved between capacity pools only if those capacity pools are enabled for cool access. When a volume is enabled for cool access, it can only reside in a cool access-enabled capacity pool even if cool access has been disabled on the volume.
62-
* If you [move a cool access volume to another capacity pool (service level change)](dynamic-change-volume-service-level.md), you must also enable that pool for cool access.
63-
* If you disable cool access and turn off tiering on a cool access volume (that is, the volume no longer uses cool access), you can't move it to a non-cool-access capacity pool. In a cool access capacity pool, you can move all volumes, *whether they're enabled for cool access or not*, only to another cool access capacity pool.
64-
6568

6669
### Considerations for cross-region and cross-zone replication
6770

@@ -156,32 +159,37 @@ You can enable Azure NetApp Files storage with cool access during the creation o
156159
1. On the **Capacity Pools** menu, select **Volumes**. Select **+ Add volume** to create a new network file system (NFS), server message block (SMB), or dual-protocol volume.
157160
1. On the **Create a volume** page, on the **Basics** tab, set the following options to enable the volume for cool access:
158161
159-
* **Enable Cool Access**: This option specifies whether the volume supports cool access.
160-
* **Coolness Period**: The coolness period defines the minimum number of days before data is transitioned to the cold tier. Once the coolness period is reached, background jobs can take up to 48 hours to initiate the data transfer to the cool tier. The default value is 31 days. The supported values are between 2 and 183 days.
162+
* **Enable Cool Access**:
163+
164+
This option specifies whether the volume supports cool access.
165+
166+
* **Coolness Period**:
167+
168+
The coolness period defines the minimum number of days before data is transitioned to the cold tier. Once the coolness period is reached, background jobs can take up to 48 hours to initiate the data transfer to the cool tier. The default value is 31 days. The supported values are between 2 and 183 days.
161169
162170
* **Cool Access Retrieval Policy**: This option specifies under which conditions data moves back to the hot tier. You can set this option to **Default**, **On-Read**, or **Never**.
163171
164-
The following list describes the data retrieval behavior with the **Cool Access Retrieval Policy** settings:
172+
**If you don't set a value for the cool access retrieval policy, the retrieval policy is set to Default.** The following table describes each policy's data retrieval behavior:
165173
166-
* Cool access is **enabled**:
167-
* If **Cool Access Retrieval Policy** is set to **Default**: Cold data is retrieved only by performing random reads. Sequential reads are served directly from the cool tier.
168-
* If no value is set for **Cool Access Retrieval Policy**: The active retrieval policy is **Default**.
169-
* If **Cool Access Retrieval Policy** is set to **On-Read**: Cold data is retrieved by performing both sequential and random reads.
170-
* If **Cool Access Retrieval Policy** is set to **Never**: Cold data is served directly from the cool tier and isn't retrieved to the hot tier.
171-
* Cool access is **disabled**:
172-
* You can set a cool access retrieval policy if cool access is disabled only if there's existing data on the cool tier.
173-
* After you disable the cool access setting on the volume, the cool access retrieval policy remains the same.
174+
| Setting | Behavior |
175+
| - | ---- |
176+
| Default | Cold data is returned to the hot tier when performing random reads. Data is served from the cool tier with sequential reads. |
177+
| On-read | On both sequential and random reads, cold data is returned to the hot tier. |
178+
| Never | Cold data is served directly from the cool tier. After it is moved to the cool tier, it's never retrieved to the hot tier. |
174179
175180
* **Cool Access Tiering Policy**
176181
177-
Select either `SnapshotOnly` or `Auto`.
182+
The tiering policy manages what data moves to the cool tier. You can tier all data or limit tiering to snapshots. Select one of the following policies:
178183
179-
* The `SnapshotOnly` policy limits data tiering to data in snapshots, while all data blocks associated with files in the active file system remain in the hot tier.
180-
* The `Auto` policy encompasses both snapshot copy data and data in the active file system.
184+
| Policy | Description |
185+
| - | - |
186+
| `Auto` | This policy encompasses both data in the active file system and snapshot copy data. |
187+
| `SnapshotOnly` | This policy limits tiering to data in snapshots. All data blocks associated with files in the active file system remain in the hot tier. |
181188
182189
:::image type="content" source="./media/manage-cool-access/cool-access-new-volume.png" alt-text="Screenshot that shows the Create a volume page. On the Basics tab, the Enable Cool Access checkbox is selected. The options for the cool access retrieval policy are displayed. " lightbox="./media/manage-cool-access/cool-access-new-volume.png":::
183190
184-
1. Follow the steps in one of these articles to finish the volume creation:
191+
1. To complete the volume creation, follow the volume creation workflow for the relevant protocol:
192+
185193
* [Create an NFS volume](azure-netapp-files-create-volumes.md)
186194
* [Create an SMB volume](azure-netapp-files-create-volumes-smb.md)
187195
* [Create a dual-protocol volume](create-volumes-dual-protocol.md)
@@ -190,31 +198,34 @@ You can enable Azure NetApp Files storage with cool access during the creation o
190198
191199
In a capacity pool enabled for cool access, you can enable an existing volume to support cool access.
192200
201+
>[!NOTE]
202+
> If cool access is disabled, you can only set a retrieval policy if there's existing data on the cool tier.
203+
>
204+
> If you disable cool access, the cool access setting on the volume, the cool access retrieval policy remains the same.
205+
193206
1. Right-click the volume for which you want to enable the cool access.
194207
1. On the **Edit** window that appears, set the following options for the volume:
195208
* **Enable Cool Access**: The coolness period defines the minimum number of days before data is transitioned to the cold tier. The default value is 31 days. The supported values are between 2 and 183 days.
196209
>[!NOTE]
197210
> The coolness period is calculated from the time of volume creation. If any existing volumes are enabled with cool access, the coolness period is applied retroactively on those volumes. This means if certain data blocks on the volumes have been infrequently accessed for the number of days specified in the coolness period, those blocks move to the cool tier once the feature is enabled. Once the coolness period is reached, background jobs can take up to 48 hours to initiate the data transfer to the cool tier.
198211
* **Cool Access Retrieval Policy**: This option specifies under which conditions data moves back to the hot tier. You can set this option to **Default**, **On-Read**, or **Never**.
199212
200-
The following list describes the data retrieval behavior with the **Cool Access Retrieval Policy** settings:
201-
202-
* Cool access is **enabled**:
203-
* If no value is set for **Cool Access Retrieval Policy**:
204-
The retrieval policy is set to **Default**. Cold data is retrieved to the hot tier only when random reads are performed. Sequential reads are served directly from the cool tier.
205-
* If **Cool Access Retrieval Policy** is set to **Default**: Cold data is retrieved only by performing random reads.
206-
* If **Cool Access Retrieval Policy** is set to **On-Read**: Cold data is retrieved by performing both sequential and random reads.
207-
* If **Cool Access Retrieval Policy** is set to **Never**: Cold data is served directly from the cool tier and isn't retrieved to the hot tier.
208-
* Cool access is **disabled**:
209-
* You can set a cool access retrieval policy if cool access is disabled only if there's existing data on the cool tier.
210-
* After you disable the cool access setting on the volume, the cool access retrieval policy remains the same.
211-
* **Cool Access Tiering policy**
213+
**If you don't set a value for the cool access retrieval policy, the retrieval policy is set to Default.** The following table describes each policy's data retrieval behavior:
214+
215+
| Setting | Behavior |
216+
| - | ---- |
217+
| Default | Cold data is returned to the hot tier when performing random reads. Data is served from the cool tier with sequential reads. |
218+
| On-read | On both sequential and random reads, cold data is returned to the hot tier. |
219+
| Never | Cold data is served directly from the cool tier. After it is moved to the cool tier, it's never retrieved to the hot tier. |
212220
213-
Select either `SnapshotOnly` or `Auto`.
221+
* **Cool Access Tiering policy**
214222
215-
* The `SnapshotOnly` policy limits data tiering to data in snapshots, while all data blocks associated with files in the active file system remain in the hot tier.
216-
* The `Auto` policy encompasses both snapshot copy data and data in the active file system.
223+
The tiering policy manages what data moves to the cool tier. You can tier all data or limit tiering to snapshots. Select one of the following policies:
217224
225+
| Policy | Description |
226+
| - | - |
227+
| `Auto` | This policy encompasses both data in the active file system and snapshot copy data. |
228+
| `SnapshotOnly` | This policy limits tiering to data in snapshots. All data blocks associated with files in the active file system remain in the hot tier. |
218229
219230
:::image type="content" source="./media/manage-cool-access/cool-access-existing-volume.png" alt-text="Screenshot that shows the Enable Cool Access checkbox selected. " lightbox="./media/manage-cool-access/cool-access-existing-volume.png":::
220231

0 commit comments

Comments
 (0)