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

# 標記 Image Builder 輸出資源
<a name="tag-resources"></a>

標記您的資源對於篩選和追蹤資源成本或其他類別很有用。您也可以根據標籤控制存取。如需標籤型授權的詳細資訊，請參閱 [以映像建置器標籤為基礎的授權](security_iam_service-with-iam.md#security-iam-service-with-ib-tags)

Image Builder 支援下列動態標籤：
+ `- {{imagebuilder:buildDate}}`

  解決建置時間的建置日期/時間。
+ `- {{imagebuilder:buildVersion}}`

  解決建置版本的問題，這是一個位於映像建置器 Amazon Resource Name (ARN) 結尾的數字。例如， 會將建置版本`"arn:aws:imagebuilder:us-west-2:123456789012:component/myexample-component/2019.12.02/1"`顯示為 `1`。

為了協助您追蹤已分發的 Amazon Machine Image (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 之映像建置器映像資源的 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
```