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.
# Marquage des référentiels dans AWS CodeCommit
Une *balise* est une étiquette d'attribut personnalisée que vous attribuez ou AWS assignez à une AWS ressource. AWS les balises sont différentes des balises Git, qui peuvent être appliquées aux validations. Chaque AWS étiquette comporte deux parties :
+ Une *clé de balise* (par exemple, `CostCenter`, `Environment`, `Project` ou `Secret`). Les touches de tag distinguent les majuscules et minuscules.
+ Un champ facultatif appelé *valeur de balise* (par exemple, `111122223333`, `Production` ou le nom d’une équipe). Omettre la valeur de balise équivaut à l’utilisation d’une chaîne vide. Les valeurs de balise sont sensibles à la casse, tout comme les clés de balise.
Ensemble, ces éléments sont connus sous le nom de paires clé-valeur. Pour les limites sur le nombre de balises que vous pouvez avoir dans un référentiel et les restrictions sur les valeurs et clés de balise, consultez [Limites](limits.md#limits-tags).
Les balises vous aident à identifier et à organiser vos AWS ressources. De nombreux AWS services prennent en charge le balisage. Vous pouvez donc attribuer le même tag aux ressources de différents services pour indiquer que les ressources sont liées. Par exemple, vous pouvez attribuer la même balise à un CodeCommit référentiel que celle que vous attribuez à un compartiment Amazon S3. Pour plus d'informations sur les stratégies de balisage, consultez la section Ressources de [balisage. AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)
Dans CodeCommit, la ressource principale est un référentiel. Vous pouvez utiliser la CodeCommit console, le AWS CLI CodeCommit APIs, ou AWS SDKs pour ajouter, gérer et supprimer des balises pour un référentiel. Outre l'identification, l'organisation et le suivi de votre référentiel à l'aide de balises, vous pouvez utiliser des balises dans les politiques IAM pour contrôler les personnes autorisées à consulter votre référentiel et à interagir avec celui-ci. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Exemple 5 : refuser ou autoriser des actions sur des référentiels contenant des balises](customer-managed-policies.md#identity-based-policies-example-5).
**Topics**
+ [
# Ajout d’une balise à un référentiel
](how-to-tag-repository-add.md)
+ [
# Affichage des balises pour un référentiel
](how-to-tag-repository-list.md)
+ [
# Affichage des balises pour un référentiel
](how-to-tag-repository-update.md)
+ [
# Supprimer un tag d'un référentiel
](how-to-tag-repository-delete.md)
# Ajout d’une balise à un référentiel
L'ajout de balises à un référentiel peut vous aider à identifier et à organiser vos AWS ressources et à gérer l'accès à celles-ci. Tout d'abord, vous ajoutez une ou plusieurs balises (paires clé-valeur) à un référentiel. N'oubliez pas qu'il y a des limites sur le nombre de balises que vous pouvez avoir dans un référentiel. Il existe des restrictions sur les caractères que vous pouvez utiliser dans les champs clé et valeur. Pour plus d’informations, consultez [Limites ](limits.md#limits-tags). Une fois que vous avez des balises, vous pouvez créer des politiques IAM pour gérer l'accès au référentiel en fonction de ces balises. Vous pouvez utiliser la CodeCommit console ou le AWS CLI pour ajouter des balises à un référentiel.
**Important**
L'ajout de balises à un référentiel peut avoir un impact sur l'accès à ce référentiel. Avant d'ajouter une balise à un référentiel, assurez-vous de passer en revue les politiques IAM susceptibles d'utiliser des balises pour contrôler l'accès aux ressources telles que les référentiels. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Exemple 5 : refuser ou autoriser des actions sur des référentiels contenant des balises](customer-managed-policies.md#identity-based-policies-example-5).
Pour plus d'informations sur l'ajout de balises à un référentiel lorsque vous le créez, consultez [Création d'un référentiel (console)](how-to-create-repository.md#how-to-create-repository-console).
**Topics**
+ [
## Ajouter une balise à un référentiel (console)
](#how-to-tag-repository-add-console)
+ [
## Ajouter un tag à un dépôt (AWS CLI)
](#how-to-tag-repository-add-cli)
## Ajouter une balise à un référentiel (console)
Vous pouvez utiliser la CodeCommit console pour ajouter une ou plusieurs balises à un CodeCommit référentiel.
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Dans **Repositories (Référentiels)**, sélectionnez le nom du référentiel dans lequel vous souhaitez afficher les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres). Choisissez **Repository tags (Balises du référentiel)**.
1. Si aucune des balises n'a été ajoutée au référentiel, choisissez **Add tag (Ajouter une balise)**. Sinon, choisissez **Edit 5modifier)**, puis choisissez **Add tag (Ajouter une balise)**.
1. Dans **Key (Clé)**, entrez un nom de balise. Vous pouvez ajouter une valeur en option pour la balise dans **Value (Valeur)**.
![\[Ajout d’une balise à un référentiel\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-repository-tags-edit.png)
1. (Facultatif) Pour ajouter une autre balise, choisissez à nouveau **Add tag (Ajouter une balise)**.
1. Lorsque vous avez fini d'ajouter des balises, choisissez **Submit (Envoyer)**.
## Ajouter un tag à un dépôt (AWS CLI)
Procédez comme suit pour utiliser le AWS CLI pour ajouter une balise à un CodeCommit référentiel. Pour ajouter une balise à un référentiel lorsque vous le créez, consultez [Création d'un référentiel (AWS CLI)](how-to-create-repository.md#how-to-create-repository-cli).
Dans ces étapes, nous supposons que vous avez déjà installé une version récente de l’ AWS CLI ou que vous avez procédé à une mise à jour vers la version actuelle. Pour plus d’informations, consultez [Installing the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) (Installation de).
Depuis le terminal ou la ligne de commande, exécutez la commande **tag-resource**, en spécifiant l'ARN (Amazon Resource Name) du référentiel dans lequel vous souhaitez ajouter des balises ainsi que la clé et la valeur de la balise que vous souhaitez ajouter. Vous pouvez ajouter plusieurs balises à un référentiel. Par exemple, pour baliser un référentiel nommé *MyDemoRepo* avec deux balises, une clé de balise nommée *Status* avec la valeur de *Secret* balise et une clé de balise nommée *Team* avec la valeur de balise de *Saanvi* :
```
aws codecommit tag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tags Status=Secret,Team=Saanvi
```
Si elle aboutit, cette commande ne renvoie rien.
# Affichage des balises pour un référentiel
Les balises peuvent vous aider à identifier et à organiser vos AWS ressources, ainsi qu'à gérer l'accès à celles-ci. Pour plus d'informations sur les stratégies de balisage, consultez la section Ressources de [balisage. AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Exemple 5 : refuser ou autoriser des actions sur des référentiels contenant des balises](customer-managed-policies.md#identity-based-policies-example-5).
## Afficher les balises d'un référentiel (console)
Vous pouvez utiliser la CodeCommit console pour afficher les balises associées à un CodeCommit référentiel.
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Dans **Repositories** (Référentiels), sélectionnez le nom du référentiel dans lequel vous souhaitez afficher les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres). Choisissez **Repository tags (Balises du référentiel)**.
![\[Affichage des balises d'un référentiel\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-repository-tags-view.png)
## Afficher les balises d'un référentiel (AWS CLI)
Procédez comme suit pour utiliser le AWS CLI afin d'afficher les AWS balises d'un CodeCommit référentiel. Si aucune balise n’a été ajoutée, la liste renvoyée est vide.
Depuis le terminal ou la ligne de commande, exécutez la commande **list-tags-for-resource**. Par exemple, pour afficher une liste des clés et des valeurs de balise pour un référentiel nommé *MyDemoRepo* avec l’ARN *arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo* :
```
aws codecommit list-tags-for-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo
```
Si elle aboutit, cette commande renvoie des informations similaires à ce qui suit :
```
{
"tags": {
"Status": "Secret",
"Team": "Saanvi"
}
}
```
# Affichage des balises pour un référentiel
Vous pouvez modifier la valeur d'une balise associée à un référentiel. Vous pouvez également modifier le nom de la clé, ce qui équivaut à supprimer la balise et à ajoutant une carte différente avec le nouveau nom et la même valeur que l’autre clé. N'oubliez pas qu'il y a des limites sur les caractères que vous pouvez utiliser dans les champs clé et valeur. Pour plus d’informations, consultez [Limites ](limits.md#limits-tags).
**Important**
La modification des balises pour un référentiel peut avoir un impact sur l'accès à ce référentiel. Avant de modifier le nom (clé) ou la valeur d'une balise pour un référentiel, assurez-vous de passer en revue les politiques IAM susceptibles d'utiliser la clé ou la valeur d'une balise pour contrôler l'accès aux ressources telles que les référentiels. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Exemple 5 : refuser ou autoriser des actions sur des référentiels contenant des balises](customer-managed-policies.md#identity-based-policies-example-5).
## Modifier une balise pour un dépôt (console)
Vous pouvez utiliser la CodeCommit console pour modifier les balises associées à un CodeCommit référentiel.
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Dans **Repositories (Référentiels)**, sélectionnez le nom du référentiel dans lequel vous souhaitez modifier les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres). Choisissez **Repository tags (Balises du référentiel)**.
1. Choisissez **Modifier**.
1.
![\[Modification de la valeur d'une balise pour un référentiel\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-repository-tags-edit2.png)
Effectuez l’une des actions suivantes :
+ Pour modifier la balise, entrez un nouveau nom dans **Key (Clé)**. La modification du nom de la balise est l'équivalent de la suppression d'une balise et de l'ajout d'une nouvelle balise avec le nouveau nom de clé.
+ Pour modifier la valeur d'une balise, saisissez une nouvelle valeur. Si vous souhaitez modifier la valeur en valeur nulle, supprimez la valeur actuelle et laissez le champ vide.
1. Lorsque vous avez terminé de modifier des balises, choisissez **Submit (Soumettre)**.
## Modifier les balises d'un référentiel (AWS CLI)
Procédez comme suit pour utiliser le tag AWS CLI pour mettre à jour une balise pour un CodeCommit référentiel. Vous pouvez modifier la valeur d’une clé existante ou ajouter une autre clé.
Depuis le terminal ou la ligne de commande, exécutez la commande **tag-resource**, en spécifiant l'ARN (Amazon Resource Name) du référentiel dans lequel vous souhaitez mettre à jour une balise et spécifiez la clé de balise et la valeur de balise :
```
aws codecommit tag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tags Team=Li
```
# Supprimer un tag d'un référentiel
Vous pouvez supprimer une ou plusieurs balises associées à un référentiel. La suppression d'un tag ne supprime pas le tag des autres AWS ressources associées à ce tag.
**Important**
La suppression des balises pour un référentiel peut avoir un impact sur l'accès à ce référentiel. Avant de supprimer une balise d'un référentiel, assurez-vous de passer en revue les politiques IAM susceptibles d'utiliser la clé ou la valeur d'une balise pour contrôler l'accès aux ressources telles que les référentiels. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Exemple 5 : refuser ou autoriser des actions sur des référentiels contenant des balises](customer-managed-policies.md#identity-based-policies-example-5).
## Supprimer une balise d'un référentiel (console)
Vous pouvez utiliser la CodeCommit console pour supprimer l'association entre une balise et un CodeCommit référentiel.
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Dans **Repositories (Référentiels)**, sélectionnez le nom du référentiel dans lequel vous souhaitez supprimer les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres). Choisissez **Repository tags (Balises du référentiel)**.
1. Choisissez **Modifier**.
1. Trouvez la balise que vous voulez supprimer, puis choisissez **Remove tag (Supprimer une balise)**.
1. Lorsque vous avez terminé de supprimer les balises, choisissez **Submit (Envoyer)**.
## Supprimer un tag d'un dépôt (AWS CLI)
Procédez comme suit pour utiliser le AWS CLI pour supprimer une balise d'un CodeCommit référentiel. La suppression d’une balise supprime uniquement son association au référentiel, mais pas la balise en elle-même.
**Note**
Si vous supprimez un CodeCommit référentiel, toutes les associations de balises sont supprimées du référentiel supprimé. Vous n'avez pas besoin de supprimer les balises avant de supprimer un référentiel.
Depuis le terminal ou la ligne de commande, exécutez la commande **untag-resource**, en spécifiant l'ARN (Amazon Resource Name) du référentiel dans lequel vous souhaitez supprimer des balises et la clé de balise de la balise que vous souhaitez supprimer. Par exemple, pour supprimer une balise sur un référentiel nommé *MyDemoRepo* avec la clé de balise *Status* :
```
aws codecommit untag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tag-keys Status
```
Si elle aboutit, cette commande ne renvoie rien. Pour vérifier quelles balises sont associées au référentiel, exécutez la commande **list-tags-for-resource**.