本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在中标记报告组 AWS CodeBuild
*标签*是您或 AWS 分配给 AWS 资源的自定义属性标签。每个 AWS 标签分为两部分：
+ *标签键* （例如，`CostCenter`、`Environment`、`Project` 或 `Secret`）。标签键区分大小写。
+ 一个称为*标签值*的可选字段（例如，`111122223333`、`Production` 或团队名称）。省略标签值与使用空字符串效果相同。与标签键一样，标签值区分大小写。
这些被统称为键-值对。有关报告组可拥有的标签数量限制以及标签键和值的限制，请参阅[Tags](limits.md#tag-limits)。
标签可帮助您识别和整理 AWS 资源。许多 AWS 服务都支持标记，因此您可以为来自不同服务的资源分配相同的标签，以表明这些资源是相关的。例如，您可以为 CodeBuild 报告组分配与分配给 Amazon S3 存储桶相同的标签。有关使用标签的更多信息，请参阅[标记最佳实践](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)
# 为报告组添加标签
向报告组添加标签可以帮助您识别和整理 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)
## 为报告组添加标签（控制台）
您可以使用 CodeBuild 控制台向 CodeBuild 报告组添加一个或多个标签。
1. 打开 CodeBuild 控制台，网址为[https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)。
1. 在**报告组**中，选择要在其中添加标签的报告组的名称。
1. 在导航窗格中，选择**设置**。
1. 如果此报告组中尚未添加标签，请选择**添加标签**。您也可以选择**编辑**，然后选择**添加标签**。
1. 在**键**中，输入标签的名称。您可以在**值**中添加可选的标签值。
1. （可选）要添加其他标签，请再次选择**添加标签**。
1. 添加完标签后，选择**提交**。
## 为报告组添加标签（AWS CLI）
要在创建报告组时为其添加标签，请参阅[创建报告组（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)。
# 查看报告组的标签
标签可以帮助您识别和整理 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)。
## 查看报告组的标签（控制台）
您可以使用 CodeBuild 控制台查看与 CodeBuild 报告组关联的标签。
1. 打开 CodeBuild 控制台，网址为[https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)。
1. 在**报告组**中，选择要在其中查看标签的报告组的名称。
1. 在导航窗格中，选择**设置**。
## 查看报告组的标签（AWS CLI）
按照以下步骤使用 AWS CLI 来查看报告组的 AWS 标签。如果尚未添加标签，则返回的标签列表为空。
1. 使用控制台或 AWS CLI 查找您的报告组的 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. 打开 CodeBuild 控制台，网址为[https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)。
1. 在**报告组**中，选择带有您要查看的标签的报告组的名称。
1. 在**配置**中，找到您的报告组的 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"
}
...
}
```
# 编辑报告组的标签
您可以更改与报告组关联的标签值。您也可以更改键的名称，这相当于移除当前的标签并使用新名称和与另一个键相同的值添加一个不同的标签。请记住，键和值字段中可以使用的字符有限制。有关更多信息，请参阅 [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)。
## 编辑报告组的标签（控制台）
您可以使用 CodeBuild 控制台编辑与 CodeBuild 报告组关联的标签。
1. 打开 CodeBuild 控制台，网址为[https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)。
1. 在**报告组**中，选择要在其中编辑标签的报告组的名称。
1. 在导航窗格中，选择**设置**。
1. 选择**编辑**。
1. 请执行以下操作之一：
+ 要更改标签，则在**键**中输入新名称。更改标签的名称相当于删除标签并使用新的键名添加新标签。
+ 要更改标签的值，则输入新值。如果您想将标签值清空，请删除当前的值并将字段保留为空白。
1. 编辑完标签后，选择**提交**。
## 编辑报告组的标签（AWS CLI）
要添加、更改或移除报告组中的标签，请参阅[更新报告组（CLI）](report-group-export-settings.md#update-report-group-cli)。更新 `UpdateReportGroupInput.json` 中的标签。
# 从报告组中移除标签
您可以移除与报告组关联的一个或多个标签。移除标签不会从与该标签关联的其他 AWS 资源中删除该标签。
**重要**
删除报告组的标签会影响对该报告组的访问。从报告组中移除标签之前，请务必查看是否存在任何 IAM 策略可能使用标签的键或值来控制对资源（如报告组）的访问。有关基于标签的访问策略示例，请参阅[使用标签控制对 AWS CodeBuild 资源的访问权限](auth-and-access-control-using-tags.md)。
## 从报告组中删除标签（控制台）
您可以使用 CodeBuild 控制台删除标签和 CodeBuild报告组之间的关联。
1. 打开 CodeBuild 控制台，网址为[https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)。
1. 在**报告组**中，选择要从其中移除标签的报告组的名称。
1. 在导航窗格中，选择**设置**。
1. 选择**编辑**。
1. 找到要移除的标签，然后选择**移除标签**。
1. 移除标签之后，选择**提交**。
## 从报告组中移除标签（AWS CLI）
按照以下步骤使用 AWS CLI 从 CodeBuild 报告组中移除标签。移除标签并不会删除标签，而只是删除它和报告组之间的关联。
**注意**
如果删除 CodeBuild 报告组，则会从已删除的报告组中移除所有标签关联。您无需在删除报告组之前移除标签。
要从报告组中删除一个或多个标签，请参阅[编辑报告组的标签（AWS CLI）](how-to-tag-report-group-update.md#how-to-tag-report-group-update-cli)。使用不包含待删除标签的更新标签列表来更新采用 JSON 格式数据的 `tags` 部分。如果要删除所有标签，请将 `tags` 部分更新为：
```
"tags: []"
```