As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Compartilhar grupos de relatórios
O compartilhamento do grupo de relatórios permite que várias AWS contas ou usuários visualizem um grupo de relatórios, seus relatórios não expirados e os resultados dos testes de seus relatórios. Neste modelo, a conta que possui o grupo de relatórios (proprietário) compartilha um grupo de relatórios com outras contas (consumidores). Um consumidor não pode editar um grupo de relatórios. Um relatório expira 30 dias após a criação.
**Topics**
+ [Compartilhar um grupo de relatórios](#report-groups-sharing-share)
+ [Serviços relacionados](#report-groups-sharing-related)
+ [Acessar grupos de relatórios compartilhados com você](report-groups-sharing-access-prereqs.md)
+ [Cancelar o compartilhamento de um grupo de relatórios compartilhado](report-groups-sharing-unshare.md)
+ [Identificar um grupo de relatórios compartilhados](report-groups-sharing-identify.md)
+ [Permissões do grupo de relatórios compartilhados](report-groups-sharing-perms.md)
## Compartilhar um grupo de relatórios
Quando você compartilha um grupo de relatórios, o consumidor recebe acesso somente leitura ao grupo de relatórios e seus relatórios. O consumidor pode usar o AWS CLI para visualizar o grupo de relatórios, seus relatórios e os resultados do caso de teste de cada relatório. O consumidor não pode:
+ Visualize um grupo de relatórios compartilhado ou seus relatórios no CodeBuild console.
+ Editar um grupo de relatórios compartilhados.
+ Usar o ARN do grupo de relatórios compartilhados em um projeto para executar um relatório. Uma compilação de projeto que especifique um grupo de relatórios compartilhados falhará.
Você pode usar o CodeBuild console para adicionar um grupo de relatórios a um compartilhamento de recursos existente. Se quiser adicionar o grupo de relatórios a um novo compartilhamento de recursos, primeiro você deve criá-lo no [console do AWS RAM](https://console.aws.amazon.com/ram).
Para compartilhar um grupo de relatórios com unidades organizacionais ou toda uma organização, é necessário habilitar o compartilhamento com AWS Organizations. Para obter mais informações, consulte [Habilitar o compartilhamento com o AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) no *Guia do usuário do AWS RAM *.
Você pode usar o CodeBuild console, o AWS RAM console ou AWS CLI compartilhar grupos de relatórios que você possui.
**Pré-requisito**
Para compartilhar um grupo de relatórios, sua AWS conta precisa ser proprietária dele. Não é possível compartilhar um grupo de relatórios que tenha sido compartilhado com você.
**Para compartilhar um grupo de relatórios que você possui (CodeBuild console)**
1. Abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, escolha **Grupos de relatórios**.
1. Escolha o projeto que deseja compartilhar e selecione **Compartilhar**. Para obter mais informações, consulte [Create a resource share](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create) no *Guia do usuário do AWS RAM *.
**Para compartilhar grupos de relatórios que você possui (AWS RAM console)**
Consulte [Creating a resource share](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) no *Guia do usuário do AWS RAM *.
**Para compartilhar grupos de relatórios que você possui (AWS RAM comando)**
Use o comando [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).
**Para compartilhar um grupo de relatórios que você possui (CodeBuild comando)**
Use o comando [put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html):
1. Crie um arquivo chamado `policy.json` e copie o seguinte nele.
------
#### [ 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. Atualize `policy.json` com o ARN do grupo de relatórios e os identificadores com quais compartilhá-lo. O exemplo a seguir concede acesso somente de leitura ao grupo de relatórios com o ARN para Alice e `arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group` para o usuário raiz da conta identificada por 123456789012. AWS
------
#### [ 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. Execute o seguinte comando.
```
aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json
```
## Serviços relacionados
O compartilhamento de grupos de relatórios se integra ao AWS Resource Access Manager (AWS RAM), um serviço que possibilita que você compartilhe seus AWS recursos com qualquer AWS conta ou por meio AWS Organizations de. Com AWS RAM, você compartilha recursos de sua propriedade criando um *compartilhamento de recursos* que especifica os recursos e os consumidores com os quais compartilhá-los. Os consumidores podem ser AWS contas individuais, unidades organizacionais ou uma organização inteira em AWS Organizations. AWS Organizations
Para obter mais informações, consulte o *Guia do usuário do [AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/)*.
# Acessar grupos de relatórios compartilhados com você
Para acessar um grupo de relatórios compartilhados, a função do IAM de um consumidor requer a permissão `BatchGetReportGroups`. É possível anexar a seguinte política ao perfil do IAM:
```
{
"Effect": "Allow",
"Resource": [
"*"
],
"Action": [
"codebuild:BatchGetReportGroups"
]
}
```
Para obter mais informações, consulte [Usando políticas baseadas em identidade para AWS CodeBuild](auth-and-access-control-iam-identity-based-access-control.md).
# Cancelar o compartilhamento de um grupo de relatórios compartilhado
Um grupo de relatórios cancelado, incluindo seus relatórios e seus resultados de caso de teste, só pode ser acessado pelo proprietário. Se você cancelar o compartilhamento de um grupo de relatórios, qualquer AWS conta ou usuário com quem você o compartilhou anteriormente não poderá acessar o grupo de relatórios, seus relatórios ou os resultados dos casos de teste nos relatórios.
Para cancelar o compartilhamento de um grupo de relatórios de sua propriedade, é necessário removê-lo do compartilhamento de recursos. Você pode usar o AWS RAM console ou AWS CLI fazer isso.
**Para cancelar o compartilhamento de um grupo de relatórios compartilhado que você possui (AWS RAM console)**
Consulte [Atualização de um compartilhamento de recursos](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) no *Guia do usuário do AWS RAM *.
**Para cancelar o compartilhamento de um grupo de relatórios compartilhado de sua propriedade (AWS RAM comando)**
Use o comando [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).
**Para cancelar o compartilhamento do grupo de relatórios que você possui ( CodeBuild comando)**
Execute o [delete-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/delete-resource-policy.html)comando e especifique o ARN do grupo de relatórios que você deseja cancelar o compartilhamento:
```
aws codebuild delete-resource-policy --resource-arn report-group-arn
```
# Identificar um grupo de relatórios compartilhados
Proprietários e consumidores podem usar o AWS CLI para identificar grupos de relatórios compartilhados.
Para identificar e obter informações sobre um grupo de relatórios compartilhados e seus relatórios, use os seguintes comandos:
+ Para ver os grupos ARNs de relatórios compartilhados com você, execute`[list-shared-report-groups](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-shared-report-groups.html)`:
```
aws codebuild list-shared-report-groups
```
+ Para ver os relatórios em um grupo ARNs de relatórios, execute `[list-reports-for-report-group](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-reports-for-report-group.html)` usando o ARN do grupo de relatórios:
```
aws codebuild list-reports-for-report-group --report-group-arn report-group-arn
```
+ Para visualizar informações sobre casos de teste em um relatório, execute `[describe-test-cases](https://docs.aws.amazon.com/cli/latest/reference/codebuild/describe-test-cases.html)` usando o ARN do relatório:
```
aws codebuild describe-test-cases --report-arn report-arn
```
A saída será exibida como a seguir:
```
{
"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"
}
]
}
```
# Permissões do grupo de relatórios compartilhados
## Permissões para proprietários
Um proprietário do grupo de relatórios pode editar o grupo de relatórios e especificá-lo em um projeto para executar relatórios.
## Permissões para clientes
Um consumidor do grupo de relatórios pode visualizar um grupo de relatórios, seus relatórios e os resultados do caso de teste para os relatórios. Um consumidor não pode editar um grupo de relatórios, ou seus relatórios, e não pode usá-lo para criar relatórios.