Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso compartido de grupos de informes
El uso compartido de grupos de informes permite a varias AWS cuentas o usuarios ver un grupo de informes, sus informes no vencidos y los resultados de las pruebas de sus informes. En este modelo, la cuenta que posee el grupo de informes (propietario) comparte un grupo de informes con otras cuentas (consumidores). Un consumidor no puede editar un grupo de informes. Un informe caduca 30 días después de su creación.
**Topics**
+ [Uso compartido de un grupo de informes](#report-groups-sharing-share)
+ [Servicios relacionados](#report-groups-sharing-related)
+ [Acceso a los grupos de informes compartidos con usted](report-groups-sharing-access-prereqs.md)
+ [Cómo dejar de compartir un grupo de informes compartido](report-groups-sharing-unshare.md)
+ [Identificación de un grupo de informes compartido](report-groups-sharing-identify.md)
+ [Permisos de un grupo de informes compartido](report-groups-sharing-perms.md)
## Uso compartido de un grupo de informes
Cuando comparte un grupo de informes, al consumidor se le concede acceso de solo lectura al grupo de informes y a sus informes. El consumidor puede utilizar el AWS CLI para ver el grupo de informes, sus informes y los resultados de los casos de prueba de cada informe. El consumidor no puede:
+ Vea un grupo de informes compartido o sus informes en la CodeBuild consola.
+ Editar un grupo de informes compartido.
+ Utilice el ARN del grupo de informes compartido en un proyecto para ejecutar un informe. Se produce un error en una compilación de proyecto que especifica un grupo de informes compartido.
Puede usar la CodeBuild consola para agregar un grupo de informes a un recurso compartido existente. Si desea añadir el grupo de informes a un nuevo recurso compartido, primero debe crearlo en la [consola de AWS RAM](https://console.aws.amazon.com/ram).
Para compartir un grupo de informes con unidades organizativas o con toda la organización, debe permitir el uso compartido con AWS Organizations. Para obtener más información, consulte [Habilitar el uso compartido con AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) en la *Guía del usuario de AWS RAM *.
Puede usar la CodeBuild consola, la AWS RAM consola o AWS CLI compartir los grupos de informes de su propiedad.
**Requisito previo**
Para compartir un grupo de informes, su AWS cuenta debe ser la propietaria del mismo. No puede compartir un grupo de informes que se haya compartido con usted.
**Para compartir un grupo de informes de tu propiedad (CodeBuild consola)**
1. Abre la AWS CodeBuild consola en [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. En el panel de navegación, elija **Report groups (Grupos de informes)**.
1. Elija el proyecto que desea compartir y, a continuación, elija **Share (Compartir)**. Para obtener más información, consulte [Crear un recurso compartido](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create) en la *Guía del usuario de AWS RAM *.
**Para compartir grupos de informes de tu propiedad (consola)AWS RAM**
Consulte [Creación de un uso compartido de recursos](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) en la *Guía del usuario de AWS RAM *.
**Para compartir los grupos de informes de su propiedad (AWS RAM comando)**
Utilice el comando [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).
**Para compartir un grupo de informes de su propiedad (CodeBuild comando)**
Utilice el comando [put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html):
1. Cree un archivo llamado `policy.json` y copie lo siguiente en él.
------
#### [ 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. Actualice `policy.json` con el ARN del grupo de informes y los identificadores para compartirlo. En el siguiente ejemplo, se concede acceso de solo lectura al grupo de informes con el ARN `arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group` a Alice y al usuario raíz de la AWS cuenta identificada con 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. Ejecute el comando siguiente.
```
aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json
```
## Servicios relacionados
El uso compartido de grupos de informes se integra con AWS Resource Access Manager (AWS RAM), un servicio que le permite compartir sus AWS recursos con cualquier cuenta o a través de ella. AWS AWS Organizations Con AWS RAM, puede compartir los recursos de su propiedad mediante la creación de un *recurso compartido* que especifique los recursos y los consumidores con los que compartirlos. Los consumidores pueden ser AWS cuentas individuales, unidades organizativas o toda una organización AWS Organizations. AWS Organizations
Para obtener más información, consulte la *Guía del usuario de [AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/)*.
# Acceso a los grupos de informes compartidos con usted
Para tener acceso a un grupo de informes compartido, el rol de IAM de un consumidor requiere el permiso `BatchGetReportGroups`. Puede adjuntar la siguiente política a su rol de IAM:
```
{
"Effect": "Allow",
"Resource": [
"*"
],
"Action": [
"codebuild:BatchGetReportGroups"
]
}
```
Para obtener más información, consulte [Uso de políticas basadas en la identidad para AWS CodeBuild](auth-and-access-control-iam-identity-based-access-control.md).
# Cómo dejar de compartir un grupo de informes compartido
Solo el propietario puede obtener acceso a un grupo de informes no compartido, incluidos sus informes y los resultados de los casos de prueba. Si deja de compartir un grupo de informes, cualquier AWS cuenta o usuario con el que lo haya compartido anteriormente no podrá acceder al grupo de informes, a sus informes ni a los resultados de los casos de prueba incluidos en los informes.
Para dejar de compartir un grupo de informes compartido que posee, debe quitarlo del recurso compartido. Puedes usar la AWS RAM consola o AWS CLI hacer esto.
**Para dejar de compartir un grupo de informes compartido de tu propiedad (AWS RAM consola)**
Consulte [Actualización de un recurso compartido](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) en la *Guía del usuario de AWS RAM *.
**Para dejar de compartir un grupo de informes compartido de su propiedad (comando)AWS RAM**
Utilice el comando [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).
**Para dejar de compartir un grupo de informes del que es propietario CodeBuild (comando)**
Ejecute el [delete-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/delete-resource-policy.html)comando y especifique el ARN del grupo de informes que desea dejar de compartir:
```
aws codebuild delete-resource-policy --resource-arn report-group-arn
```
# Identificación de un grupo de informes compartido
Los propietarios y los consumidores pueden utilizarlos AWS CLI para identificar los grupos de informes compartidos.
Para identificar y obtener información acerca de un grupo de informes compartido y sus informes, utilice los siguientes comandos:
+ Para ver los grupos ARNs de informes que se han compartido con usted, ejecute`[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 los informes ARNs de un grupo de informes, ejecute `[list-reports-for-report-group](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-reports-for-report-group.html)` con el grupo de informes ARN:
```
aws codebuild list-reports-for-report-group --report-group-arn report-group-arn
```
+ Para ver la información sobre los casos de prueba en un informe, ejecute `[describe-test-cases](https://docs.aws.amazon.com/cli/latest/reference/codebuild/describe-test-cases.html)` con el ARN de informe:
```
aws codebuild describe-test-cases --report-arn report-arn
```
El resultado es similar al siguiente:
```
{
"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"
}
]
}
```
# Permisos de un grupo de informes compartido
## Permisos de los propietarios
Un propietario de un grupo de informes puede editarlo y especificarlo en un proyecto para ejecutar informes.
## Permisos de los consumidores
Un consumidor de grupo de informes puede ver un grupo de informes, sus informes y los resultados de los casos de prueba de sus informes. Un consumidor no puede editar un grupo de informes ni sus informes y no puede usarlo para crear informes.