You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/storage/files/storage-snapshots-files.md
+9-8Lines changed: 9 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,15 +4,16 @@ description: A share snapshot is a read-only, point-in-time copy of an Azure fil
4
4
author: khdownie
5
5
ms.service: azure-file-storage
6
6
ms.topic: how-to
7
-
ms.date: 10/22/2024
7
+
ms.date: 10/23/2024
8
8
ms.author: kendownie
9
9
---
10
10
11
11
# Use share snapshots with Azure Files
12
12
13
13
Azure Files provides the capability to take snapshots of SMB and NFS file shares. Share snapshots capture the share state at that point in time. This article describes the capabilities that file share snapshots provide and how you can use them to recover previous versions of files.
14
14
15
-
Share snapshots provide only file-level protection. They don't prevent fat-finger deletions on a file share or storage account. To help protect a storage account from accidental deletions, you can either [enable soft delete](storage-files-prevent-file-share-deletion.md), or lock the storage account and/or the resource group.
15
+
> [!IMPORTANT]
16
+
> Share snapshots provide only file-level protection. They don't prevent fat-finger deletions on a file share or storage account. To help protect a storage account from accidental deletion, you can either [enable soft delete](storage-files-prevent-file-share-deletion.md), or lock the storage account and/or the resource group.
16
17
17
18
## Applies to
18
19
@@ -62,13 +63,13 @@ To conserve space, you can delete the share snapshot for the period when the chu
62
63
63
64
Even though share snapshots are saved incrementally, you need to retain only the most recent share snapshot in order to restore the share. When you delete a share snapshot, only the data unique to that share snapshot is removed. Active snapshots contain all the information that you need to browse and restore your data (from the time the share snapshot was taken) to the original location or an alternate location. You can restore at the item level.
64
65
65
-
Snapshots don't count towards the maximum share size limit, which is 100 TiB for premium and standard file shares. There's no limit to how much space share snapshots occupy in total. Storage account limits still apply.
66
+
Snapshots don't count towards the maximum share size limit of 100 TiB. There's no limit to how much space share snapshots occupy in total, or that share snapshots of a particular file share can consume. Storage account limits still apply.
66
67
67
68
## Limits
68
69
69
70
The maximum number of share snapshots that Azure Files allows is 200 per share. After 200 share snapshots, you must delete older share snapshots in order to create new ones. You can retain snapshots for up to 10 years.
70
71
71
-
There's no limit to the simultaneous calls for creating share snapshots. There's no limit to the amount of space that share snapshots of a particular file share can consume.
72
+
There's no limit to the simultaneous calls for creating share snapshots.
72
73
73
74
Only file management APIs (`AzRmStorageShare`) are supported for NFS Azure file share snapshots. File data plane APIs (`AzStorageShare`) aren't supported.
74
75
@@ -92,7 +93,7 @@ Before you deploy the share snapshot scheduler, carefully consider your share sn
92
93
93
94
## SMB file share snapshots
94
95
95
-
Customers using SMB Azure file shares can create, list, and delete share snapshots.
96
+
Customers using SMB Azure file shares can create, list, delete, and restore from share snapshots.
You can list all the snapshots for a file share using the Azure portal, Azure PowerShell, or Azure CLI.
131
132
@@ -266,7 +267,7 @@ After you've created the file share snapshot, follow these instructions to mount
266
267
:::image type="content" source="media/storage-snapshots-files/mount-smb-snapshot-on-linux.png" alt-text="Screenshot showing how to locate a file share snapshot name and timestamp in the Azure portal." border="true" :::
267
268
268
269
4. Convert the timestamp to the format expected by the `mount` command, which is **@GMT-year.month.day-hour.minutes.seconds**. In this example, you'd convert **2023-01-05T00:08:20.0000000Z** to **@GMT-2023.01.05-00.08.20**.
269
-
5. Run the `mount` command using the GMT time to specify the `snapshot` value. Be sure to replace `<storage-account-name>`, `<file-share-name>`, and the GMT timestamp with your values. The .cred file contains the credentials to be used to mount the share (see [Automatically mount file shares](#automatically-mount-file-shares)).
270
+
5. Run the `mount` command using the GMT time to specify the `snapshot` value. Be sure to replace `<storage-account-name>`, `<file-share-name>`, and the GMT timestamp with your values. The .cred file contains the credentials to be used to mount the share.
270
271
271
272
```bash
272
273
sudo mount -t cifs //<storage-account-name>.file.core.windows.net/<file-share-name> /media/<file-share-name>/snapshot1 -o credentials=/etc/smbcredentials/snapshottestlinux.cred,[email protected]
@@ -278,7 +279,7 @@ If the mount fails, see [Troubleshoot Azure Files connectivity and access issues
278
279
279
280
## NFS file share snapshots
280
281
281
-
Customers using NFS Azure file shares can create, list, and delete share snapshots.
282
+
Customers using NFS Azure file shares can create, list, delete, and restore from share snapshots.
282
283
283
284
> [!IMPORTANT]
284
285
> You should mount your file share before creating snapshots. If you create a new NFS file share and take snapshots before mounting the share, attempting to list the snapshots for the share will return an empty list. We recommend deleting any snapshots taken before the first mount and re-creating them after you've mounted the share.
0 commit comments