Skip to content

Commit 1e48015

Browse files
committed
Incorp'd Steve's review
1 parent b2fbc08 commit 1e48015

File tree

1 file changed

+4
-6
lines changed

1 file changed

+4
-6
lines changed

articles/container-registry/container-registry-retention-policy.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,13 @@ manager: gwallace
77

88
ms.service: container-registry
99
ms.topic: article
10-
ms.date: 09/23/2019
10+
ms.date: 09/25/2019
1111
ms.author: danlep
1212
---
1313

1414
# Set a retention policy for untagged manifests
1515

16-
Azure Container Registry gives you the option to set a *retention policy* for stored image manifests that don't have any associated tags (*untagged manifests*). When a retention policy is enabled, untagged manifests in the registry are automatically deleted after a number of days you set. This feature prevents the registry from filling up with artifacts that aren't needed and helps you save on storage costs.
17-
18-
For background on container images and manifests, see [About registries, repositories, and images](container-registry-concepts.md).
16+
Azure Container Registry gives you the option to set a *retention policy* for stored image manifests that don't have any associated tags (*untagged manifests*). When a retention policy is enabled, untagged manifests in the registry are automatically deleted after a number of days you set. This feature prevents the registry from filling up with artifacts that aren't needed and helps you save on storage costs. If the `delete-enabled` attribute of an untagged manifest is set to `false`, the manifest can't be deleted, and the retention policy doesn't apply.
1917

2018
You can use the Azure Cloud Shell or a local installation of the Azure CLI to run the command examples in this article. If you'd like to use it locally, version 2.0.74 or later is required. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI][azure-cli].
2119

@@ -40,8 +38,6 @@ The following example shows you how to use the Azure CLI to set a retention poli
4038

4139
By default, no retention policy is set in a container registry. To set or update a retention policy, run the [az acr config retention update][az-acr-config-retention-update] command in the Azure CLI. You can specify a number of days between 0 and 365 to retain the untagged manifests. If you don't specify a number of days, the command sets a default of 7 days. After the retention period, all untagged manifests in the registry are automatically deleted.
4240

43-
The retention policy doesn't apply to any untagged manifest that has the `delete-enabled` attribute set to `false`, or the `write-enabled` attribute set to `true`. For information about locked images and manifests, see [Lock a container image in an Azure container registry](container-registry-image-lock.md).
44-
4541
The following example sets a retention policy of 30 days for untagged manifests in the registry *myregistry*:
4642

4743
```azurecli
@@ -91,6 +87,8 @@ You can also set a registry's retention policy in the [Azure portal](https://por
9187

9288
* Learn how to [automatically purge](container-registry-auto-purge.md) selected images and manifests from a registry
9389

90+
* Learn more about options to [lock images and manifests](container-registry-image-lock.md) in a registry
91+
9492
<!-- LINKS - external -->
9593
[terms-of-use]: https://azure.microsoft.com/support/legal/preview-supplemental-terms/
9694

0 commit comments

Comments
 (0)