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

# 更新报告组
<a name="report-group-export-settings"></a>

 当您更新报告组时，您可以指定是否将原始测试结果数据导出到 Amazon S3 存储桶中的文件的相关信息。如果您选择导出到 S3 存储桶，可以为报告组指定以下内容：
+ 是否将原始测试结果文件压缩为 ZIP 文件。
+ 是否对原始测试结果文件进行加密。您可以使用以下选项之一指定加密：
  +  AWS 托管式密钥 适用于亚马逊 S3。
  + 您创建和配置的客户托管密钥。

有关更多信息，请参阅 [数据加密](security-encryption.md)。

如果您使用更新报告组，则还可以更新或添加标签。 AWS CLI 有关更多信息，请参阅 [在中标记报告组 AWS CodeBuild标记报告组](how-to-tag-report-group.md)。

**注意**  
项目中指定的 CodeBuild 服务角色用于授予上传到 S3 存储桶的权限。

**Topics**
+ [更新报告组（控制台）](#update-report-group-console)
+ [更新报告组（CLI）](#update-report-group-cli)

## 更新报告组（控制台）
<a name="update-report-group-console"></a>

按照以下过程使用 AWS 管理控制台更新报告组。

**更新报告组的步骤**

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

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

1. 选择要更新的报告组。

1. 选择**编辑**。

1. 选择或清除**备份到 Amazon S3**。如果选择此选项，请指定您的导出设置：

   1. 对于 **S3 存储桶名称**，请输入 S3 存储桶的名称。

   1. 对于**路径前缀**，请输入要上传测试结果的 S3 存储桶中的路径。

   1. 选择**将测试结果数据压缩为 zip 文件**以便压缩原始测试结果数据文件。

   1. 展开**其他配置**以显示加密选项。选择下列选项之一：
      + 用 AWS 托管式密钥 于 Amazon S3 的@@ **默认 AWS 托管密钥**。有关更多信息，请参阅《*AWS Key Management Service 用户指南*》 CMKs中的[客户管理](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk)。这是默认加密选项。
      + **选择自定义密钥**将使用您创建和配置的客户托管密钥。对于**AWS KMS 加密密钥**，请输入加密密钥的 ARN。其格式为 ` arn:aws:kms:<region-id>: <aws-account-id>:key/<key-id> `。有关更多信息，请参阅《AWS Key Management Service 用户指南》**中的[创建 KMS 密钥](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html)。
      + **禁用构件加密**将禁用加密。如果要共享测试结果或将其发布到静态网站，则可以选择此选项。（动态网站可以运行代码来解密测试结果。）

## 更新报告组（CLI）
<a name="update-report-group-cli"></a>

按照以下过程使用 AWS CLI更新报告组。

**更新报告组的步骤**

1. 创建一个名为 `UpdateReportGroupInput.json`的文件。

1. 将以下内容复制到 `UpdateReportGroupInput.json`。

   ```
   {
       "arn": "",
       "exportConfig": {
           "exportConfigType": "S3",
           "s3Destination": {
               "bucket": "bucket-name", 
               "path": "path", 
               "packaging": "NONE | ZIP",
               "encryptionDisabled": "false",
               "encryptionKey": "your-key"
            }
        },
        "tags": [
           {
               "key": "tag-key",
               "value": "tag-value"
           }
        ]
   }
   ```

1. 在 `arn` 行中输入报告组的 ARN，例如 `"arn":"arn:aws:codebuild:region:123456789012:report-group/report-group-1")`。

1. 使用要应用到报告组的更新来更新 `UpdateReportGroupInput.json`。
   + 如果要更新报告组以将原始测试结果文件导出到 S3 存储桶，请更新 `exportConfig` 部分。将 `bucket-name` 替换为 S3 存储桶名称，并将 `path` 替换为 S3 存储桶中您要将文件导出到的路径。如果要压缩导出的文件，对于 `packaging`，请指定 `ZIP`。否则，请指定 `NONE`。使用 `encryptionDisabled` 指定是否要加密导出的文件。如果要加密导出的文件，请输入客户托管密钥。
   + 如果要更新报告组，以使其不会将原始测试结果文件导出到 S3 存储桶，请使用以下 JSON 更新 `exportConfig` 部分：

     ```
     { 
       "exportConfig": {
           "exportConfigType": "NO_EXPORT"
       }
     }
     ```
   + 如果要更新报告组的标签，请更新 `tags` 部分。您可以更改、添加或删除标签。如果要删除所有标签，请使用以下 JSON 来更新：

     ```
     "tags": []
     ```

1.  运行如下命令：

   ```
   aws codebuild update-report-group \
   --cli-input-json file://UpdateReportGroupInput.json
   ```