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.
# Marquer un groupe de rapports dans AWS CodeBuild
Une *balise* est une étiquette d'attribut personnalisée que vous attribuez ou AWS assignez à une AWS ressource. 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 groupe de rapports et les restrictions sur les valeurs et clés de balise, consultez [Étiquettes](limits.md#tag-limits).
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 groupe de CodeBuild rapports que celle que vous attribuez à un compartiment Amazon S3. Pour de plus amples informations sur l'utilisation de balises, veuillez consulter le livre blanc sur les [bonnes pratiques de balisage](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf).
Dans CodeBuild, les ressources principales sont le groupe de rapports et le projet. Vous pouvez utiliser la CodeBuild console, le AWS CLI CodeBuild APIs, ou AWS SDKs pour ajouter, gérer et supprimer des balises pour un groupe de rapports. Outre l'identification, l'organisation et le suivi de votre groupe de rapports à l'aide de balises, vous pouvez utiliser des balises dans les politiques IAM pour contrôler qui peut consulter votre groupe de rapports et interagir avec celui-ci. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Utilisation de balises pour contrôler l'accès aux AWS CodeBuild ressources](auth-and-access-control-using-tags.md).
**Topics**
+ [Ajouter des balises à un groupe de rapports](how-to-tag-report-group-add.md)
+ [Afficher les balises d'un groupe de rapports](how-to-tag-report-group-list.md)
+ [Modifier les balises d'un groupe de rapports](how-to-tag-report-group-update.md)
+ [Supprimer des balises d'un groupe de rapports](how-to-tag-report-group-delete.md)
# Ajouter des balises à un groupe de rapports
L'ajout de balises à un groupe de rapports 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 groupe de rapports. N'oubliez pas qu'il y a des limites sur le nombre de balises que vous pouvez avoir dans un groupe de rapports. Il existe des restrictions sur les caractères que vous pouvez utiliser dans les champs clé et valeur. Pour de plus amples informations, veuillez consulter [Étiquettes](limits.md#tag-limits). Une fois que vous avez des balises, vous pouvez créer des politiques IAM pour gérer l'accès au groupe de rapports en fonction de ces balises. Vous pouvez utiliser la CodeBuild console ou le AWS CLI pour ajouter des balises à un groupe de rapports.
**Important**
L'ajout de balises à un groupe de rapports peut avoir un impact sur l'accès au groupe de rapports. Avant d'ajouter une balise à un groupe de rapports, assurez-vous de consulter les politiques IAM susceptibles d'utiliser des balises pour contrôler l'accès aux ressources telles que les groupes de rapports. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Utilisation de balises pour contrôler l'accès aux AWS CodeBuild ressources](auth-and-access-control-using-tags.md).
Pour plus d'informations sur l'ajout de balises à un groupe de rapports lorsque vous le créez, consultez [Créer un groupe de rapports (console)](report-group-create.md#test-report-group-create-console).
**Topics**
+ [Ajouter une balise à un groupe de rapports (console)](#how-to-tag-report-group-add-console)
+ [Ajouter une balise à un groupe de rapports (AWS CLI)](#how-to-tag-report-group-add-cli)
## Ajouter une balise à un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour ajouter une ou plusieurs balises à un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Report groups (Groupes de rapports)**, choisissez le nom du groupe de rapports auquel vous souhaitez ajouter des balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Si aucune des balises n'a été ajoutée au groupe de rapports, choisissez **Add tag (Ajouter une balise)**. Vous pouvez également choisir **Modifier**, puis **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)**.
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 une balise à un groupe de rapports (AWS CLI)
Pour ajouter une balise à un groupe de rapports lorsque vous le créez, veuillez consulter [Création d'un groupe de rapports (CLI)](report-group-create.md#test-report-group-create-cli). Dans `CreateReportGroup.json`, ajoutez vos balises.
Pour ajouter des balises à un groupe de rapports existant, veuillez consulter [Mise à jour d'un groupe de rapports (CLI)](report-group-export-settings.md#update-report-group-cli) et ajoutez vos balises dans `UpdateReportGroupInput.json`.
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).
# Afficher les balises d'un groupe de rapports
Les balises peuvent vous aider à identifier et à organiser vos AWS ressources et à gérer l'accès à celles-ci. Pour de plus amples informations sur l'utilisation de balises, veuillez consulter le livre blanc sur les [bonnes pratiques de balisage](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf). Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example).
## Afficher les balises d'un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour afficher les balises associées à un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom du groupe de rapports dans lequel vous souhaitez afficher les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
## Afficher les balises d'un groupe de rapports (AWS CLI)
Procédez comme suit pour utiliser le AWS CLI afin d'afficher les AWS balises d'un groupe de rapports. Si aucune balise n'a été ajoutée, la liste des balises renvoyées est vide.
1. Utilisez la console ou le AWS CLI pour localiser l'ARN de votre groupe de rapports. Prenez-en note.
------
#### [ AWS CLI ]
Exécutez la commande suivante.
```
aws list-report-groups
```
Cette commande renvoie des informations au format JSON semblables à ce qui suit :
```
{
"reportGroups": [
"arn:aws:codebuild:region:123456789012:report-group/report-group-1",
"arn:aws:codebuild:region:123456789012:report-group/report-group-2",
"arn:aws:codebuild:region:123456789012:report-group/report-group-3"
]
}
```
Un ARN de groupe de rapports se termine par son nom, que vous pouvez utiliser pour identifier l'ARN de votre groupe de rapports.
------
#### [ Console ]
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom de votre groupe de rapports avec les balises que vous souhaitez afficher.
1. Dans **Configuration** recherchez l'ARN de votre groupe de rapports.
------
1. Exécutez la commande suivante. Utilisez l'ARN dont vous avez fait une note pour le paramètre `--report-group-arns`.
```
aws codebuild batch-get-report-groups --report-group-arns arn:aws:codebuild:region:123456789012:report-group/report-group-name
```
En cas de succès, cette commande renvoie des informations au format JSON qui contiennent une section `tags` similaire à la suivante :
```
{
...
"tags": {
"Status": "Secret",
"Project": "TestBuild"
}
...
}
```
# Modifier les balises d'un groupe de rapports
Vous pouvez modifier la valeur d'une balise associée à un groupe de rapports. 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 de plus amples informations, veuillez consulter [Étiquettes](limits.md#tag-limits).
**Important**
La modification des balises d'un groupe de rapports peut avoir un impact sur l'accès au groupe de rapports. Avant de modifier le nom (clé) ou la valeur d'une balise pour un groupe de rapports, assurez-vous de consulter 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 groupes de rapports. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example).
## Modifier une balise pour un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour modifier les balises associées à un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom du groupe de rapports dont vous souhaitez modifier les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Choisissez **Modifier**.
1. 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 groupe de rapports (AWS CLI)
Pour ajouter, modifier ou supprimer des balises d'un groupe de rapports, veuillez consulter [Mise à jour d'un groupe de rapports (CLI)](report-group-export-settings.md#update-report-group-cli). Mettez à jour les balises dans `UpdateReportGroupInput.json`.
# Supprimer des balises d'un groupe de rapports
Vous pouvez supprimer une ou plusieurs balises associées à un groupe de rapports. La suppression d'un tag ne supprime pas le tag des autres AWS ressources associées à ce tag.
**Important**
La suppression de balises pour un groupe de rapports peut avoir un impact sur l'accès au groupe de rapports. Avant de supprimer une balise d'un groupe de rapports, 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 groupes de rapports. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Utilisation de balises pour contrôler l'accès aux AWS CodeBuild ressources](auth-and-access-control-using-tags.md).
## Supprimer une balise d'un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour supprimer l'association entre une balise et un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom du groupe de rapports dans lequel vous souhaitez supprimer les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
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 une balise d'un groupe de rapports (AWS CLI)
Procédez comme suit pour utiliser le AWS CLI pour supprimer une balise d'un groupe de CodeBuild rapports. La suppression d'une balise supprime uniquement son association au groupe de rapports, mais pas la balise en elle-même.
**Note**
Si vous supprimez un groupe de CodeBuild rapports, toutes les associations de balises sont supprimées du groupe de rapports supprimé. Vous n'avez pas besoin de supprimer les balises avant de supprimer un groupe de rapports.
Pour supprimer une ou plusieurs balises d'un groupe de rapports, reportez-vous à la section [Modifier les balises d'un groupe de rapports (AWS CLI)](how-to-tag-report-group-update.md#how-to-tag-report-group-update-cli). Mettez à jour la `tags` section dans les données formatées JSON avec une liste mise à jour de balises qui ne contient pas celles que vous souhaitez supprimer. Si vous souhaitez supprimer toutes les balises, mettez à jour la section `tags` pour :
```
"tags: []"
```