Skip to content

Commit 75fff9c

Browse files
Merge pull request #309955 from rachelhuhmsoft/docs-editor/soft-delete-container-overview-1767120365
Update soft-delete-container-overview.md
2 parents 78eb28f + e573b32 commit 75fff9c

2 files changed

Lines changed: 13 additions & 18 deletions

File tree

articles/storage/blobs/soft-delete-blob-overview.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,6 @@ To protect a copy operation, blob soft delete must be enabled for the destinatio
7676

7777
Blob soft delete doesn't protect against operations to write blob metadata or properties. No soft-deleted snapshot is created when a blob's metadata or properties are updated.
7878

79-
Blob soft delete doesn't afford overwrite protection for blobs in the archive tier. If a blob in the archive tier is overwritten with a new blob in any tier, then the overwritten blob is permanently deleted.
80-
8179
For premium storage accounts, soft-deleted snapshots don't count toward the per-blob limit of 100 snapshots.
8280

8381
### Restoring soft-deleted objects

articles/storage/blobs/soft-delete-container-overview.md

Lines changed: 13 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -14,39 +14,35 @@ ms.custom: references_regions
1414

1515
# Soft delete for containers
1616

17-
Container soft delete protects your data from being accidentally deleted by maintaining the deleted data in the system for a specified period of time. During the retention period, you can restore a soft-deleted container and its contents to the container's state at the time it was deleted. After the retention period has expired, the container and its contents are permanently deleted.
17+
Container soft delete protects your containers from being accidentally deleted by maintaining the deleted containers in the storage account for a specified period of time. During the retention period, you can restore a soft-deleted container and its contents to the container's state at the time it was deleted. After the retention period expires, the container and its contents are permanently deleted.
1818

1919
## Recommended data protection configuration
2020

21-
Blob soft delete is part of a comprehensive data protection strategy for blob data. For optimal protection for your blob data, Microsoft recommends enabling all of the following data protection features:
21+
Container soft delete is part of a comprehensive data protection strategy. For optimal protection for your storage account, Microsoft recommends enabling the following data protection features:
2222

23-
- Container soft delete, to restore a container that has been deleted. To learn how to enable container soft delete, see [Enable and manage soft delete for containers](soft-delete-container-enable.md).
24-
- Blob versioning, to automatically maintain previous versions of a blob. When blob versioning is enabled, you can restore an earlier version of a blob to recover your data if it's erroneously modified or deleted. To learn how to enable blob versioning, see [Enable and manage blob versioning](versioning-enable.md).
25-
- Blob soft delete, to restore a blob, snapshot, or version that has been deleted. To learn how to enable blob soft delete, see [Enable and manage soft delete for blobs](soft-delete-blob-enable.md).
23+
- Container soft delete, to restore a deleted container. To learn how to enable container soft delete, see [Enable and manage soft delete for containers](soft-delete-container-enable.md).
24+
- Blob soft delete, to restore a deleted blob, snapshot, or version. To learn how to enable blob soft delete, see [Enable and manage soft delete for blobs](soft-delete-blob-enable.md).
2625

26+
- Blob versioning, to automatically maintain previous versions of a blob. To learn how to enable blob versioning, see [Enable and manage blob versioning](versioning-enable.md).
2727
To learn more about Microsoft's recommendations for data protection, see [Data protection overview](data-protection-overview.md).
2828

29-
> [!CAUTION]
30-
> After you enable blob versioning for a storage account, every write operation to a blob in that account results in the creation of a new version. For this reason, enabling blob versioning may result in additional costs. To minimize costs, use a lifecycle management policy to automatically delete old versions. For more information about lifecycle management, see [Optimize costs by automating Azure Blob Storage access tiers](./lifecycle-management-overview.md).
31-
3229
## How container soft delete works
3330

34-
When you enable container soft delete, you can specify a retention period for deleted containers that is between 1 and 365 days. The default retention period is seven days. During the retention period, you can recover a deleted container by calling the **Restore Container** operation.
31+
When you enable container soft delete, you can specify a retention period for deleted containers that is between 1 and 365 days. The default retention period is seven days. We recommend a minimum of seven days and increasing the retention period as needed based on data volume and how long it may take to detect and respond to data‑loss events.
3532

36-
When you restore a container, the container's blobs and any blob versions and snapshots are also restored. However, you can only use container soft delete to restore blobs if the container itself was deleted. To a restore a deleted blob when its parent container hasn't been deleted, you must use blob soft delete or blob versioning.
33+
During the retention period, you can recover a deleted container by calling the **Restore Container** operation. When you restore a container, the container's blobs and any blob versions and snapshots are also restored.
3734

3835
> [!WARNING]
39-
> Container soft delete can restore only whole containers and their contents at the time of deletion. You cannot restore a deleted blob within a container by using container soft delete. Microsoft recommends also enabling blob soft delete and blob versioning to protect individual blobs in a container.
40-
>
41-
> When you restore a container, you must restore it to its original name. If the original name has been used to create a new container, then you will not be able to restore the soft-deleted container.
36+
> Container soft delete can restore only whole containers and their contents at the time of deletion. To restore a deleted blob when its parent container hasn't been deleted, you must use blob soft delete or blob versioning.
37+
> When you restore a container, you must restore it to its original name. If the original name is used to create a new container, then you cannot restore the soft-deleted container.
4238
4339
The following diagram shows how a deleted container can be restored when container soft delete is enabled:
4440

4541
:::image type="content" source="media/soft-delete-container-overview/container-soft-delete-diagram.png" alt-text="Diagram showing how a soft-deleted container may be restored":::
4642

47-
After the retention period has expired, the container is permanently deleted from Azure Storage and can't be recovered. The clock starts on the retention period at the point that the container is deleted. You can change the retention period at any time, but keep in mind that an updated retention period applies only to newly deleted containers. Previously deleted containers will be permanently deleted based on the retention period that was in effect at the time that the container was deleted.
43+
After the retention period expires, the container is permanently deleted from Azure Storage and cannot be recovered. The clock starts on the retention period at the point that the container is deleted. You can change the retention period at any time, but the new setting applies only to containers deleted *after* the update. Containers that were already deleted will be permanently removed based on the retention period that was in effect when they were originally deleted.
4844

49-
Disabling container soft delete doesn't result in permanent deletion of containers that were previously soft-deleted. Any soft-deleted containers will be permanently deleted at the expiration of the retention period that was in effect at the time that the container was deleted.
45+
Turning off container soft delete doesn't cause existing soft‑deleted containers to be permanently deleted. They will be permanently deleted based on the retention period that applied at the time they were deleted.
5046

5147
Container soft delete is available for the following types of storage accounts:
5248

@@ -59,7 +55,7 @@ Storage accounts with a hierarchical namespace enabled for use with Azure Data L
5955
Version 2019-12-12 or higher of the Azure Storage REST API supports container soft delete.
6056

6157
> [!IMPORTANT]
62-
> Container soft delete does not protect against the deletion of a storage account, but only against the deletion of containers in that account. To protect a storage account from deletion, configure a lock on the storage account resource. For more information about locking Azure Resource Manager resources, see [Lock resources to prevent unexpected changes](../../azure-resource-manager/management/lock-resources.md).
58+
> Container soft delete doesn't protect against the deletion of a storage account, but only against the deletion of containers in that account. To protect a storage account from deletion, configure a lock on the storage account resource. For more information about locking Azure Resource Manager resources, see [Lock resources to prevent unexpected changes](../../azure-resource-manager/management/lock-resources.md).
6359
6460
## Feature support
6561

@@ -73,4 +69,5 @@ There's no additional charge to enable container soft delete. Data in soft-delet
7369

7470
- [Configure container soft delete](soft-delete-container-enable.md)
7571
- [Soft delete for blobs](soft-delete-blob-overview.md)
72+
7673
- [Blob versioning](versioning-overview.md)

0 commit comments

Comments
 (0)