

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Propriétés de la politique de cycle de vie dans Amazon ECR
<a name="lifecycle_policy_parameters"></a>

Les politiques de cycle de vie présentent les propriétés suivantes. 

Pour consulter des exemples de politiques relatives au cycle de vie, consultez[Exemples de politiques de cycle de vie dans Amazon ECR](lifecycle_policy_examples.md). Pour obtenir des instructions sur la création d'une politique de cycle de vie à l'aide du AWS CLI, consultez[Créer une politique de cycle de vie (AWS CLI)](lp_creation.md#lp-creation-cli).

## Priorité de la règle
<a name="lp_rule_priority"></a>

`rulePriority`  
Type : entier  
Obligatoire : oui  
Définit l'ordre dans lequel les règles sont évaluées, de la priorité la plus basse à la plus haute. Une règle de politique de cycle de vie avec une priorité de `1` est appliquée en premier, une règle avec une priorité de `2` est appliquée ensuite, et ainsi de suite. Lorsque vous ajoutez des règles à une politique de cycle de vie, vous devez attribuer à chacune une valeur unique de `rulePriority`. Les valeurs n'ont pas besoin d'être séquentielles entre les règles d'une politique. Une règle avec une valeur `tagStatus` de `any` doit avoir la valeur la plus élevée pour `rulePriority` et être évaluée en dernier.

## Description
<a name="lp_description"></a>

`description`  
Type : chaîne  
Obligatoire : non  
(Facultatif) Décrit l'objectif d'une règle dans une politique de cycle de vie.

## État de l'étiquetage
<a name="lp_tag_status"></a>

`tagStatus`  
Type : chaîne  
Obligatoire : oui  
Détermine si la règle de la politique de cycle de vie que vous ajoutez précise une étiquette pour une image. Les options acceptables sont `tagged`, `untagged` ou `any`. Si vous précisez `any`, la règle s'appliquera à toutes les images évaluées par la règle. Si vous spécifiez`tagged`, vous devez également spécifier une `tagPrefixList` valeur ou une `tagPatternList` valeur. Si vous le spécifiez`untagged`, vous devez omettre à la fois `tagPrefixList` et`tagPatternList`.

## Liste des modèles de balises
<a name="lp_tag_pattern_list"></a>

`tagPatternList`  
Type : list[string]  
Obligatoire : oui, si `tagStatus` est défini sur balisé et `tagPrefixList` n’est pas spécifiée  
Lors de la création d’une politique de cycle de vie pour les images balisées, il est recommandé d’utiliser une `tagPatternList` pour spécifier les balises à expirer. Précisez une liste séparée par des virgules de modèles de balises d’image pouvant contenir des caractères génériques (`*`) sur lesquels exécuter une action avec votre politique de cycle de vie. Par exemple, si vos images sont balisées comme `prod`, `prod1`, `prod2`, et ainsi de suite, vous devrez utiliser le modèle de balise `prod*` pour les spécifier toutes. Si vous précisez plusieurs étiquettes, seules les images portant toutes les étiquettes précisées seront sélectionnées.  
Il existe une limite maximale de quatre caractères génériques (`*`) par chaîne. Par exemple, `["*test*1*2*3", "test*1*2*3*"]` est valide mais `["test*1*2*3*4*5*6"]` ne l’est pas.

## Liste des préfixes d'étiquette
<a name="lp_tag_prefix_list"></a>

`tagPrefixList`  
Type : list[string]  
Obligatoire : oui, si `tagStatus` est défini sur balisé et `tagPatternList` n’est pas spécifiée  
Uniquement utilisé si vous avez spécifié `"tagStatus": "tagged"` et que vous ne spécifiez pas une `tagPatternList`. Vous devez préciser une liste séparée par des virgules de préfixes d'étiquette d'image sur lesquels exécuter une action avec votre politique de cycle de vie. Par exemple, si vos images sont étiquetées comme `prod`, `prod1`, `prod2`, et ainsi de suite, vous devrez utiliser le préfixe d'étiquette `prod` pour toutes les préciser. Si vous précisez plusieurs étiquettes, seules les images portant toutes les étiquettes précisées seront sélectionnées.

## Classe de stockage
<a name="lp_storage_class"></a>

`storageClass`  
Type : chaîne  
Obligatoire : oui, si `countType` c'est le cas `sinceImageTransitioned`  
La règle ne sélectionnera que les images de cette classe de stockage. Lorsque vous utilisez un `countType` of `imageCountMoreThan``sinceImagePushed`, ou`sinceImagePulled`, la seule valeur prise en charge est`standard`. Lorsque vous utilisez un type de comptage de`sinceImageTransitioned`, cela est obligatoire et la seule valeur prise en charge est`archive`. Si vous l'omettez, la valeur de `standard` sera utilisée.

## Type de décompte
<a name="lp_count_type"></a>

`countType`  
Type : chaîne  
Obligatoire : oui  
Indiquez un type de décompte à appliquer aux images.   
Si `countType` est défini sur `imageCountMoreThan`, vous précisez également `countNumber` pour créer une règle qui définit une limite sur le nombre d'images existant dans votre référentiel. `countType`Il est défini sur`sinceImagePushed`, ou `sinceImagePulled``sinceImageTransitioned`, vous spécifiez également `countUnit` et `countNumber` pour spécifier une limite de temps pour les images qui existent dans votre référentiel.

## Unité de décompte
<a name="lp_count_unit"></a>

`countUnit`  
Type : chaîne  
Obligatoire : oui, uniquement s'`countType`il est défini sur `sinceImagePushed``sinceImagePulled`, ou `sinceImageTransitioned`  
Précisez une unité de décompte `days` pour indiquer celle-ci comme unité de temps, en plus de `countNumber`, qui est le nombre de jours.   
Cela ne doit être spécifié que lorsque `countType` est `sinceImagePushed``sinceImagePulled`, ou `sinceImageTransitioned` ; une erreur se produira si vous spécifiez une unité de comptage alors qu'il `countType` s'agit d'une autre valeur.

## Chiffre du décompte
<a name="lp_count_number"></a>

`countNumber`  
Type : entier  
Obligatoire : oui  
Précisez un chiffre de décompte. Les valeurs acceptables sont des entiers positifs (`0` n'est pas une valeur acceptée).   
Si le paramètre `countType` utilisé est `imageCountMoreThan`, la valeur sera le nombre maximal d'images que vous souhaitez conserver dans votre référentiel. Si le paramètre `countType` utilisé est `sinceImagePushed`, la valeur sera la limite d'ancienneté maximale pour vos images. Si c'`countType`est le cas`sinceImagePulled`, la valeur est le nombre maximum de jours écoulés depuis la dernière extraction de l'image. Si c'`countType`est le cas`sinceImageTransitioned`, la valeur est le nombre maximal de jours écoulés depuis l'archivage de l'image.

## Action
<a name="lp_action"></a>

`type`  
Type : chaîne  
Obligatoire : oui  
Précisez un type d'action. Les valeurs prises en charge sont `expire` (pour supprimer des images) et `transition` (pour déplacer les images vers le stockage d'archives).

`targetStorageClass`  
Type : chaîne  
Obligatoire : oui, si `type` c'est le cas `transition`  
Classe de stockage vers laquelle vous souhaitez que la politique de cycle de vie transfère l'image. `archive`est la seule valeur prise en charge.