本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 共享报告组
<a name="report-groups-sharing"></a>

报告组共享允许多个 Amazon 账户或用户查看一个报告组、其未过期的报告及其报告的测试结果。在此模型中，拥有报告组的账户（拥有者）将与其他账户（使用者）共享该报告组。使用者无法编辑报告组。报告在创建后 30 天过期。

**Topics**
+ [共享报告组](#report-groups-sharing-share)
+ [相关服务](#report-groups-sharing-related)
+ [访问与您共享的报告组](report-groups-sharing-access-prereqs.md)
+ [取消共享已共享的报告组](report-groups-sharing-unshare.md)
+ [标识已共享的报告组](report-groups-sharing-identify.md)
+ [共享报告组权限](report-groups-sharing-perms.md)

## 共享报告组
<a name="report-groups-sharing-share"></a>

 共享报告组时，将向使用者授予对报告组及其报告的只读访问权限。使用者可以使用 Amazon CLI 来查看报告组、其报告以及每个报告的测试用例结果。使用者不能执行以下操作：
+  在 CodeBuild 控制台中查看共享报告组或其报告。
+  编辑共享报告组。
+  使用项目中的共享报告组的 ARN 运行报告。指定共享报告组的项目构建将失败。

您可以使用 CodeBuild 控制台向现有资源共享添加报告组。如果要将报告组添加到新的资源共享，则必须首先在 [Amazon RAM 控制台](https://console.amazonaws.cn/ram)中创建资源共享。

要与组织单位或整个组织共享报告组，您必须启用与 Amazon Organizations的共享。有关更多信息，请参阅《Amazon RAM 用户指南》中的[允许与 Amazon Organizations共享](https://docs.amazonaws.cn/ram/latest/userguide/getting-started-sharing.html)。

您可以使用 CodeBuild 控制台、 Amazon RAM 控制台或 Amazon CLI 共享您拥有的报告组。

**先决条件**  
要共享报告组，您的 Amazon 账户必须拥有该报告组。无法共享已与您共享的报告组。

**共享您拥有的报告组（CodeBuild 控制台）**

1. 在 [https://console.aws.amazon.com/codesuite/codebuild](https://console.amazonaws.cn/codesuite/codebuild/home) /home 中打开 Amazon CodeBuild 控制台。

1. 在导航窗格中，选择**报告组**。

1.  选择要共享的项目，然后选择**共享**。有关更多信息，请参阅《Amazon RAM 用户指南》中的[创建资源共享](https://docs.amazonaws.cn/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create)。

**共享您拥有的报告组（Amazon RAM 控制台）**  
请参阅《Amazon RAM 用户指南**》中的[创建资源共享](https://docs.amazonaws.cn/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create)。

**共享您拥有的报告组（Amazon RAM 命令）**  
使用 [create-resource-share](https://docs.amazonaws.cn/cli/latest/reference/ram/create-resource-share.html) 命令。

 **共享您拥有的报告组（CodeBuild 命令）** 

使用 [put-resource-policy](https://docs.amazonaws.cn/cli/latest/reference/codebuild/put-resource-policy.html) 命令：

1. 创建一个名为 `policy.json` 的文件，并将以下内容复制到该文件中。

------
#### [ 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. 使用报告组 ARN 和标识符更新 `policy.json`，以便共享该报告组。以下示例向 Alice 和 123456789012 所标识的 Amazon 账户的根用户授予对带有 ARN `arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group` 的报告组的只读访问权限。

------
#### [ 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. 运行如下命令。

   ```
   aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json
   ```

## 相关服务
<a name="report-groups-sharing-related"></a>

报告群组共享与 Amazon Resource Access Manager (Amazon RAM) 集成，该服务使您可以与任何 Amazon 账户或通过任何账户共享 Amazon 资源 Amazon Organizations。使用 Amazon RAM，您可以通过创建资源共享来共享资源，指定要与之*共享的资源*和使用者，从而共享您拥有的资源。消费者可以是个人 Amazon 帐户 Amazon Organizations、中的组织单位或中的整个组织 Amazon Organizations。

有关更多信息，请参阅 *[Amazon RAM 《用户指南》](https://docs.amazonaws.cn/ram/latest/userguide/)*。