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/container-registry/container-registry-delete.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -260,7 +260,7 @@ if ($enableDelete) {
260
260
261
261
As an alternative to scripting Azure CLI commands, run an on-demand or scheduled ACR task to delete all tags that are older than a certain duration or match a specified name filter. For more information, see [Automatically purge images from an Azure container registry](container-registry-auto-purge.md).
262
262
263
-
Optionally set a [retention policy](container-registry-retention-policy.md) for each registry, to manage artifacts such as untagged manifests. When you enable a retention policy, image manifests in the registry that don't have any associated tags, and the underlying layer data, are automatically deleted after a set period.
263
+
Optionally set a [retention policy](container-registry-retention-policy.md) for each registry, to manage untagged manifests. When you enable a retention policy, image manifests in the registry that don't have any associated tags, and the underlying layer data, are automatically deleted after a set period.
Copy file name to clipboardExpand all lines: articles/container-registry/container-registry-retention-policy.md
+9-6Lines changed: 9 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Policy to retain artifacts in Azure Container Registry
3
-
description: Learn how to enable a retention policy in your Azure container registry, for automatic deletion of artifacts such as untagged manifests after a defined period.
2
+
title: Policy to retain untagged manifests in Azure Container Registry
3
+
description: Learn how to enable a retention policy in your Azure container registry, for automatic deletion of untagged manifests after a defined period.
4
4
services: container-registry
5
5
author: dlepow
6
6
manager: gwallace
@@ -10,9 +10,12 @@ ms.topic: article
10
10
ms.date: 09/16/2019
11
11
ms.author: danlep
12
12
---
13
-
# Set a retention policy for artifacts in Azure Container Registry
14
13
15
-
Azure Container Registry gives you the option to set a *retention policy* for images or other artifacts in each registry. When a retention policy is enabled, specific artifact types 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.
14
+
# Set a retention policy for untagged manifests
15
+
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
19
17
20
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.73 or later is required. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI][azure-cli].
18
21
@@ -27,15 +30,15 @@ If you want to delete single image tags or manifests using Azure CLI commands, s
27
30
## Preview limitations
28
31
29
32
* Only a **Premium** container registry can be configured with a retention policy. For information about registry service tiers, see [Azure Container Registry SKUs](container-registry-skus.md).
30
-
*Currently, you can only set a retention policy for image manifests that don't have any associated tags (*untagged manifests*). For background on container images and manifests, see [About registries, repositories, and images](container-registry-concepts.md).
33
+
*You can only set a retention policy for untagged manifests.
31
34
32
35
## Set a retention policy - CLI
33
36
34
37
The following example shows you how to use the Azure CLI to set a retention policy for untagged manifests in a registry.
35
38
36
39
### Enable a retention policy
37
40
38
-
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 enable a retention policy without specifying 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.
41
+
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.
39
42
40
43
The retention policy doesn't apply to any untagged manifest that has the `delete-enabled` attribute set to `false`. For information about locked images and manifests, see [Lock a container image in an Azure container registry](container-registry-image-lock.md).
0 commit comments