本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 更新報告群組
<a name="report-group-export-settings"></a>

 當您更新報告群組時，您可以指定是否將原始測試結果資料匯出至 Amazon S3 儲存貯體中的檔案的相關資訊。如果您選擇匯出至 S3 儲存貯體，您可以針對報告群組指定下列項目：
+ 原始測試結果檔案是否以 ZIP 檔案壓縮。
+ 原始測試結果檔案是否加密。您可以使用下列其中一種形式來指定加密：
  +  AWS 受管金鑰 適用於 Amazon 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：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1.  在導覽窗格中，選擇 **Report groups (報告群組)**。

1. 選擇您想要更新的報告群組。

1. 選擇**編輯**。

1. 選取或清除**備份至 Amazon S3**。如果選取此選項，請指定匯出設定：

   1. 針對 **S3 bucket name (S3 儲存貯體名稱)**，輸入 S3 儲存貯體的名稱。

   1. 針對 **Path prefix (路徑前置詞)**，輸入您想要在 S3 儲存貯體中上傳測試結果的路徑。

   1. 選取 **Compress test result data in a zip file (以 zip 檔案壓縮測試結果資料)** ，以壓縮原始測試結果資料檔案。

   1. 展開 **Additional configuration (其他組態)** 以顯示加密選項。選擇下列其中一項：
      + 用於 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)。
      + **Disable artifact encryption (停用成品)** 可讓您停用加密。如果您想要共享測試結果，或發佈至靜態網站，您可以選擇此選項。(動態網站可以執行程式碼，以解密測試結果。)

## 更新報告群組 (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` 區段。以您的 S3 儲存貯體名稱取代 `bucket-name` ，並以您想要在 S3 儲存貯體中匯出檔案的路徑取代 `path`。如果您想要壓縮匯出的檔案，請為 `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
   ```