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/)*.