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

# 标记 Image Builder 输出资源
<a name="tag-resources"></a>

标记资源有助于筛选和跟踪资源成本或其他类别。您还可以基于标签来控制访问权限。有关基于标签授权的更多信息，请参阅[基于 Image Builder 标签的授权](security_iam_service-with-iam.md#security-iam-service-with-ib-tags)

Image Builder 支持以下动态标签：
+ `- {{imagebuilder:buildDate}}`

   date/time 在构建时解析为构建。
+ `- {{imagebuilder:buildVersion}}`

  解析为构建版本，这是位于 Image Builder Amazon 资源名称 (ARN) 末尾的数字。例如，`"arn:aws:imagebuilder:us-west-2:123456789012:component/myexample-component/2019.12.02/1"` 将构建版本显示为 `1`。

为了帮助您跟踪已分发的亚马逊系统映像 (AMIs)，Image Builder 会自动将以下标签添加到您的输出中 AMIs。
+ `"CreatedBy":"EC2 Image Builder"`
+ `"Ec2ImageBuilderArn":"arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0/10"`。此标签包含用于创建 AMI 的 Image Builder 映像资源的 ARN。

**Topics**
+ [标记来自的资源 AWS CLI](#cli-tag-resource)
+ [从中取消对资源的标记 AWS CLI](#cli-untag-resource)
+ [列出来自的特定资源的所有标签 AWS CLI](#cli-list-tags-for-resource)

## 标记来自的资源 AWS CLI
<a name="cli-tag-resource"></a>

以下示例展示了如何使用 **imagebuilder** CLI 命令在 EC2 Image Builder 中添加和标记资源。您必须提供 `resourceArn` 以及要为其应用的标签。

示例 `tag-resource.json` 内容如下所示：

```
{
    "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline",
    "tags": {
        "KeyName": "KeyValue"
    }
}
```

运行以下命令，该命令引用上述 `tag-resource.json` 文件。

```
aws imagebuilder tag-resource --cli-input-json file://tag-resource.json
```

## 从中取消对资源的标记 AWS CLI
<a name="cli-untag-resource"></a>

以下示例展示了如何使用 **imagebuilder** CLI 命令从资源中删除标签。您必须提供 `resourceArn` 和键以删除标签。

示例 `untag-resource.json` 内容如下所示：

```
{
    "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline",
    "tagKeys": [
        "KeyName"
    ]
}
```

运行以下命令，该命令引用上述 `untag-resource.json` 文件。

```
aws imagebuilder untag-resource --cli-input-json file://untag-resource.json
```

## 列出来自的特定资源的所有标签 AWS CLI
<a name="cli-list-tags-for-resource"></a>

以下示例展示了如何使用 **imagebuilder** CLI 命令列出特定资源的所有标签。

```
aws imagebuilder list-tags-for-resource --resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline
```