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.
# Partager des groupes de rapports
Le partage de groupes de rapports permet à plusieurs AWS comptes ou utilisateurs de consulter un groupe de rapports, ses rapports non expirés et les résultats des tests de ses rapports. Dans ce modèle, le compte propriétaire du groupe de rapports (propriétaire) partage un groupe de rapports avec d'autres comptes (consommateurs). Un consommateur ne peut pas modifier un groupe de rapports. Un rapport expire 30 jours après sa création.
**Topics**
+ [Partager un groupe de rapports](#report-groups-sharing-share)
+ [Services connexes](#report-groups-sharing-related)
+ [Accédez aux groupes de rapports partagés avec vous](report-groups-sharing-access-prereqs.md)
+ [Annuler le partage d'un groupe de rapports partagé](report-groups-sharing-unshare.md)
+ [Identifier un groupe de rapports partagé](report-groups-sharing-identify.md)
+ [Autorisations de groupe de rapports partagés](report-groups-sharing-perms.md)
## Partager un groupe de rapports
Lorsque vous partagez un groupe de rapports, le consommateur dispose d'un accès en lecture seule au groupe de rapports et à ses rapports. Le consommateur peut utiliser le AWS CLI pour consulter le groupe de rapports, ses rapports et les résultats des scénarios de test pour chaque rapport. Le consommateur ne peut pas :
+ Consultez un groupe de rapports partagé ou ses rapports dans la CodeBuild console.
+ Modifier un groupe de rapports partagé.
+ Utiliser l'ARN du groupe de rapports partagé dans un projet pour exécuter un rapport. Une génération de projet qui spécifie un groupe de rapports partagé échoue.
Vous pouvez utiliser la CodeBuild console pour ajouter un groupe de rapports à un partage de ressources existant. Si vous souhaitez ajouter le groupe de rapports à un nouveau partage de ressources, vous devez d'abord le créer dans la [console AWS RAM](https://console.aws.amazon.com/ram).
Pour partager un groupe de rapports avec des unités organisationnelles ou une organisation entière, vous devez activer le partage avec AWS Organizations. Pour de plus amples informations, veuillez consulter [Activer le partage avec AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) dans le *Guide de l'utilisateur AWS RAM *.
Vous pouvez utiliser la CodeBuild console, la AWS RAM console ou AWS CLI pour partager des groupes de rapports dont vous êtes propriétaire.
**Prérequis**
Pour partager un groupe de rapports, votre AWS compte doit en être le propriétaire. Vous ne pouvez pas partager un groupe de rapports qui a été partagé avec vous.
**Pour partager un groupe de rapports dont vous êtes le propriétaire (CodeBuild console)**
1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Dans le panneau de navigation, sélectionnez **Groupes de rapports**.
1. Choisissez le projet que vous souhaitez partager, puis choisissez **Partager**. Pour de plus amples informations, veuillez consulter [Création d'un partage de ressources](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create) dans le *Guide de l'utilisateur AWS RAM *.
**Pour partager des groupes de rapports dont vous êtes propriétaire (AWS RAM console)**
Consultez [Création d’un partage de ressources](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) dans le *Guide de l’utilisateur AWS RAM *.
**Pour partager des groupes de rapports dont vous êtes propriétaire (AWS RAM commande)**
Utilisez la commande [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).
**Pour partager un groupe de rapports dont vous êtes le propriétaire (CodeBuild commande)**
Utilisez la commande [put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html) :
1. Créez un fichier nommé `policy.json` et copiez ce qui suit dans celui-ci.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[{
"Effect":"Allow",
"Principal":{
"AWS":"111122223333"
},
"Action":[
"codebuild:BatchGetReportGroups",
"codebuild:BatchGetReports",
"codebuild:ListReportsForReportGroup",
"codebuild:DescribeTestCases"],
"Resource":"arn:aws:iam::*:role/Service*"
}]
}
```
------
1. Mettez à jour `policy.json` avec l'ARN du groupe de rapports et les identificateurs avec lesquels vous le partagez. L'exemple suivant accorde un accès en lecture seule au groupe de rapports avec l'ARN `arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group` à Alice et à l'utilisateur root pour le AWS compte identifié par 123456789012.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[{
"Effect":"Allow",
"Principal":{
"AWS": [
"arn:aws:iam::123456789012:user/Alice",
"123456789012"
]
},
"Action":[
"codebuild:BatchGetReportGroups",
"codebuild:BatchGetReports",
"codebuild:ListReportsForReportGroup",
"codebuild:DescribeTestCases"],
"Resource":"arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group"
}]
}
```
------
1. Exécutez la commande suivante.
```
aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json
```
## Services connexes
Le partage de groupes de rapports s'intègre à AWS Resource Access Manager (AWS RAM), un service qui vous permet de partager vos AWS ressources avec n'importe quel AWS compte ou via AWS Organizations. Avec AWS RAM, vous partagez les ressources que vous possédez en créant un *partage de ressources* qui spécifie les ressources et les consommateurs avec lesquels les partager. Les consommateurs peuvent être AWS des comptes individuels AWS Organizations, des unités organisationnelles ou une organisation entière AWS Organizations.
Pour plus d’informations, consultez le *Guide de l’utilisateur [AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/)*.
# Accédez aux groupes de rapports partagés avec vous
Pour accéder à un groupe de rapports partagé, le rôle IAM d'un consommateur requiert l'autorisation `BatchGetReportGroups`. Vous pouvez associer la politique suivante à leur rôle IAM :
```
{
"Effect": "Allow",
"Resource": [
"*"
],
"Action": [
"codebuild:BatchGetReportGroups"
]
}
```
Pour de plus amples informations, veuillez consulter [Utilisation de politiques basées sur l'identité pour AWS CodeBuild](auth-and-access-control-iam-identity-based-access-control.md).
# Annuler le partage d'un groupe de rapports partagé
Un groupe de rapports non partagé, y compris ses rapports et leurs résultats de cas de test, est accessible uniquement par son propriétaire. Si vous résiliez le partage d'un groupe de rapports, les AWS comptes ou utilisateurs avec lesquels vous l'avez précédemment partagé ne peuvent pas accéder au groupe de rapports, à ses rapports ou aux résultats des tests figurant dans les rapports.
Pour annuler le partage d'un groupe de rapports partagé qui vous appartient, vous devez le supprimer du partage de ressources. Vous pouvez utiliser la AWS RAM console ou AWS CLI effectuer cette opération.
**Pour annuler le partage d'un groupe de rapports partagé dont vous êtes le propriétaire (AWS RAM console)**
Consultez la section [Mise à jour d'un partage de ressources](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) du *Guide de l'utilisateur AWS RAM *.
**Pour annuler le partage d'un groupe de rapports partagé dont vous êtes le propriétaire (AWS RAM commande)**
Utilisez la commande [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).
**Pour annuler le partage du groupe de rapports dont vous êtes le propriétaire ( CodeBuild commande)**
Exécutez la [delete-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/delete-resource-policy.html)commande et spécifiez l'ARN du groupe de rapports dont vous souhaitez annuler le partage :
```
aws codebuild delete-resource-policy --resource-arn report-group-arn
```
# Identifier un groupe de rapports partagé
Les propriétaires et les consommateurs peuvent utiliser le AWS CLI pour identifier les groupes de rapports partagés.
Pour identifier et obtenir des informations sur un groupe de rapports partagé et ses rapports, utilisez les commandes suivantes :
+ Pour voir les groupes ARNs de rapports partagés avec vous, exécutez `[list-shared-report-groups](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-shared-report-groups.html)` :
```
aws codebuild list-shared-report-groups
```
+ Pour voir les rapports ARNs d'un groupe de rapports, exécutez-le à `[list-reports-for-report-group](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-reports-for-report-group.html)` l'aide de l'ARN du groupe de rapports :
```
aws codebuild list-reports-for-report-group --report-group-arn report-group-arn
```
+ Pour afficher des informations sur les cas de test dans un rapport, exécutez `[describe-test-cases](https://docs.aws.amazon.com/cli/latest/reference/codebuild/describe-test-cases.html)` à l'aide de l'ARN de rapport :
```
aws codebuild describe-test-cases --report-arn report-arn
```
Le résultat se présente comme suit :
```
{
"testCases": [
{
"status": "FAILED",
"name": "Test case 1",
"expired": 1575916770.0,
"reportArn": "report-arn",
"prefix": "Cucumber tests for agent",
"message": "A test message",
"durationInNanoSeconds": 1540540,
"testRawDataPath": "path-to-output-report-files"
},
{
"status": "SUCCEEDED",
"name": "Test case 2",
"expired": 1575916770.0,
"reportArn": "report-arn",
"prefix": "Cucumber tests for agent",
"message": "A test message",
"durationInNanoSeconds": 1540540,
"testRawDataPath": "path-to-output-report-files"
}
]
}
```
# Autorisations de groupe de rapports partagés
## Autorisations accordées aux propriétaires
Un propriétaire de groupe de rapports peut modifier le groupe de rapports et le spécifier dans un projet pour exécuter des rapports.
## Autorisations accordées aux consommateurs
Un consommateur de groupe de rapports peut afficher un groupe de rapports, ses rapports et les résultats de cas de test pour ses rapports. Un consommateur ne peut pas modifier un groupe de rapports ou ses rapports, et ne peut pas l'utiliser pour créer des rapports.