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

# 在 中標記報告群組 AWS CodeBuild
<a name="how-to-tag-report-group"></a>

*標籤*是您或 AWS 指派給 AWS 資源的自訂屬性標籤。每個 AWS 標籤有兩個部分：
+ *標籤鍵* (例如，`CostCenter`、`Environment`、`Project` 或 `Secret` )。標籤鍵會區分大小寫。
+ 一個名為*標籤值* (例如，`111122223333`、`Production` 或團隊名稱) 的選用欄位。忽略標籤值基本上等同於使用空字串。與標籤鍵相同，標籤值會區分大小寫。

這些合稱為鍵值組。對於報告群組上標籤數目的限制，以及標籤金鑰和值的限制，請參閱[Tags (標籤)](limits.md#tag-limits)。

標籤可協助您識別和組織 AWS 資源。許多 AWS 服務支援標記，因此您可以將相同的標籤指派給來自不同 服務的資源，以指出資源相關。例如，您可以將相同的標籤指派給指派給 Amazon S3 儲存貯體的 CodeBuild 報告群組。如需使用標籤的詳細資訊，請參閱[標記最佳實務](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf)白皮書。

在 CodeBuild 中，主要資源是報告群組和專案。您可以使用 CodeBuild 主控台、 AWS CLI、CodeBuild APIs或 AWS SDKs 來新增、管理和移除報告群組的標籤。除了識別、組織和追蹤具有標籤的報告群組之外，您還可以在 IAM 政策中使用標籤，以協助控制誰可以檢視報告群組並與之互動。如需以標籤為基礎的存取政策範例，請參閱[使用標籤控制對 AWS CodeBuild 資源的存取](auth-and-access-control-using-tags.md)。

**Topics**
+ [將標籤新增至報告群組](how-to-tag-report-group-add.md)
+ [檢視報告群組的標籤](how-to-tag-report-group-list.md)
+ [編輯報表群組的標籤](how-to-tag-report-group-update.md)
+ [從報告群組移除標籤](how-to-tag-report-group-delete.md)

# 將標籤新增至報告群組
<a name="how-to-tag-report-group-add"></a>

將標籤新增至報告群組可協助您識別和組織資源，並管理對這些 AWS 資源的存取。首先，將一或多個標籤 (金鑰值對) 新增到報告群組。請記住，報告群組的標籤數目有所限制。金鑰和值欄位可使用的字數有所限制。如需詳細資訊，請參閱[Tags (標籤)](limits.md#tag-limits)。擁有標籤後，您可以建立 IAM 政策，以根據這些標籤管理對報告群組的存取。您可以使用 CodeBuild 主控台或 AWS CLI 將標籤新增至報告群組。

**重要**  
將標籤新增到報告群組可能會影響該報告群組的存取權。將標籤新增至報告群組之前，請務必檢閱任何可能使用標籤來控制對報告群組等資源的存取的 IAM 政策。如需以標籤為基礎的存取政策範例，請參閱[使用標籤控制對 AWS CodeBuild 資源的存取](auth-and-access-control-using-tags.md)。

如需在建立政策時，將標籤新增至報告群組的詳細資訊，請參閱[建立報告群組 (主控台)](report-group-create.md#test-report-group-create-console)。

**Topics**
+ [將標籤新增至報告群組 (主控台)](#how-to-tag-report-group-add-console)
+ [將標籤新增至報告群組 (AWS CLI)](#how-to-tag-report-group-add-cli)

## 將標籤新增至報告群組 (主控台)
<a name="how-to-tag-report-group-add-console"></a>

您可以使用 CodeBuild 主控台，將一或多個標籤新增至 CodeBuild 報告群組。

1. 前往 [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/) 開啟 CodeBuild 主控台。

1. 在 **Report groups (報告群組)** 中，選擇您要新增標籤的報告群組名稱。

1. 在導覽窗格中，選擇**設定**。

1. 如果沒有任何標籤新增至報告群組，請選擇 **Add tag (新增標籤)**。您也可以選擇 **Edit (編輯)**，然後選擇 **Add tag (新增標籤)**。

1. 在 **Key (金鑰)** 中，輸入標籤的名稱。您可以在 **Value (值)** 中為標籤新增選用值。

1. (選用) 若要新增另一個標籤，再選擇 **Add tag (新增標籤)** 一次。

1. 當您完成新增標籤的作業時，請選擇 **Submit (提交)**。

## 將標籤新增至報告群組 (AWS CLI)
<a name="how-to-tag-report-group-add-cli"></a>

若要在建立政策時，將標籤新增至報告群組，請參閱[建立報告群組 (CLI)](report-group-create.md#test-report-group-create-cli)。在 `CreateReportGroup.json` 中，新增您的標籤。

 若要將標籤新增至現有的報告群組，請參閱[更新報告群組 (CLI)](report-group-export-settings.md#update-report-group-cli)，並在 `UpdateReportGroupInput.json` 中新增標籤。

在這些步驟中，我們假設您已經安裝新版 AWS CLI 或更新到最新版本。如需詳細資訊，請參閱[安裝 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。

# 檢視報告群組的標籤
<a name="how-to-tag-report-group-list"></a>

標籤可協助您識別和組織 AWS 資源，並管理對資源的存取。如需使用標籤的詳細資訊，請參閱[標記最佳實務](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf)白皮書。如需以標籤為基礎的存取政策範例，請參閱[Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example)。

## 檢視報告群組的標籤 (主控台)
<a name="how-to-tag-report-group-list-console"></a>

您可以使用 CodeBuild 主控台來檢視與 CodeBuild 報告群組相關聯的標籤。

1. 前往 [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/) 開啟 CodeBuild 主控台。

1. 在 **Report groups (報告群組)** 中，選擇您要檢視標籤的報告群組名稱。

1. 在導覽窗格中，選擇**設定**。

## 檢視報告群組的標籤 (AWS CLI)
<a name="how-to-tag-report-group-list-cli"></a>

請依照下列步驟使用 AWS CLI 檢視報告群組的 AWS 標籤。如果未新增任何標籤，會傳回空白的標籤清單。

1.  使用 主控台或 AWS CLI 來尋找報告群組的 ARN。記下該 ARN。

------
#### [ AWS CLI ]

    執行下列命令。

   ```
   aws list-report-groups
   ```

    此命令會傳回類似如下的 JSON 格式資訊：

   ```
   {
       "reportGroups": [
           "arn:aws:codebuild:region:123456789012:report-group/report-group-1",
           "arn:aws:codebuild:region:123456789012:report-group/report-group-2",
           "arn:aws:codebuild:region:123456789012:report-group/report-group-3"
       ]
   }
   ```

   報告群組 ARN 以其名稱結尾，您可以用來識別報告群組的 ARN。

------
#### [ Console ]

   1. 前往 [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/) 開啟 CodeBuild 主控台。

   1. 在 **Report groups (報告群組)** 中，選擇帶有您要檢視之標籤的報告群組名稱。

   1.  在 **Configuration (組態)** 中，找出報告群組的 ARN。

------

1.  執行下列命令。使用您針對 `--report-group-arns` 參數記下的 ARN。

   ```
   aws codebuild batch-get-report-groups --report-group-arns arn:aws:codebuild:region:123456789012:report-group/report-group-name
   ```

    如果成功，此命令會傳回 JSON 格式的資訊，其包含類似如下的 `tags` 區段：

   ```
   {
       ...                        
       "tags": {
           "Status": "Secret",
           "Project": "TestBuild"
       }
       ...
   }
   ```

# 編輯報表群組的標籤
<a name="how-to-tag-report-group-update"></a>

您可以變更與報告群組相關聯標籤的值。您也可以變更金鑰的名稱，這相當於移除目前的標籤，並新增具有新名稱和與其他金鑰相同值的不同標籤。請記住金鑰和值欄位可使用的字元有所限制。如需詳細資訊，請參閱[Tags (標籤)](limits.md#tag-limits)。

**重要**  
編輯報告群組的謙可能會影響該報告群組的存取權。在編輯報告群組標籤的名稱 （索引鍵） 或值之前，請務必檢閱任何可能使用標籤索引鍵或值的 IAM 政策，以控制對報告群組等資源的存取。如需以標籤為基礎的存取政策範例，請參閱[Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example)。

## 編輯報告群組的標籤 (主控台)
<a name="how-to-tag-report-group-update-console"></a>

您可以使用 CodeBuild 主控台來編輯與 CodeBuild 報告群組相關聯的標籤。

1. 前往 [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/) 開啟 CodeBuild 主控台。

1. 在 **Report groups (報告群組)** 中，選擇您要編輯標籤的報告群組名稱。

1. 在導覽窗格中，選擇**設定**。

1. 選擇**編輯**。

1. 執行以下任意一項：
   + 若要變更標籤，請在 **Key (金鑰)** 輸入新的名稱。變更標籤名稱等於移除標籤並使用新的金鑰名稱新增一個新的標籤。
   + 若要變更標籤的值，請輸入新的值。如果您想要變更值為沒有，請刪除目前的值並保留欄位空白。

1. 當您完成編輯標籤，選擇 **Submit (提交)**。

## 編輯報表群組的標籤 (AWS CLI)
<a name="how-to-tag-report-group-update-cli"></a>

 若要新增、變更或刪除報告群組的標籤，請參閱[更新報告群組 (CLI)](report-group-export-settings.md#update-report-group-cli)。更新 `UpdateReportGroupInput.json` 中的標籤。

# 從報告群組移除標籤
<a name="how-to-tag-report-group-delete"></a>

您可以移除一或多個與報告群組相關聯的標籤。移除標籤不會從與該標籤相關聯的其他 AWS 資源中刪除標籤。

**重要**  
移除報表群組的標籤可能會影響該報表群組的存取權。從報告群組移除標籤之前，請務必檢閱任何可能使用標籤金鑰或值的 IAM 政策，以控制對報告群組等資源的存取。如需以標籤為基礎的存取政策範例，請參閱[使用標籤控制對 AWS CodeBuild 資源的存取](auth-and-access-control-using-tags.md)。

## 從報告群組移除標籤 (主控台)
<a name="how-to-tag-report-group-delete-console"></a>

您可以使用 CodeBuild 主控台來移除標籤與 CodeBuild 報告群組之間的關聯。

1. 前往 [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/) 開啟 CodeBuild 主控台。

1. 在 **Report groups (報告群組)** 中，選擇您要移除標籤的報告群組名稱。

1. 在導覽窗格中，選擇**設定**。

1. 選擇**編輯**。

1. 尋找您想要移除的標籤，然後選擇 **Remove tag (移除標籤)**。

1. 當您完成移除標籤，請選擇 **Submit (提交)**。

## 從報告群組移除標籤 (AWS CLI)
<a name="how-to-tag-report-group-delete-cli"></a>

請依照下列步驟，使用 從 CodeBuild 報告群組 AWS CLI 中移除標籤。移除標籤並不會將其刪除，只會移除標籤和報告群組之間的關聯。

**注意**  
如果您刪除 CodeBuild 報告群組，所有標籤關聯都會從已刪除的報告群組中移除。您不需要在刪除報告群組之前移除標籤。

 若要將一或多個標籤從報告群組中刪除，請參閱[編輯報表群組的標籤 (AWS CLI)](how-to-tag-report-group-update.md#how-to-tag-report-group-update-cli)。使用未包含您要刪除之標籤的已更新標籤清單，來更新 JSON 格式資料中的 `tags` 區段。如果您要刪除所有標籤，請將 `tags` 區段更新為：

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