翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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}}`

  ビルド時にビルドの日付/時刻に解決します。
+ `- {{imagebuilder:buildVersion}}`

  ビルドバージョンに解決されます。これは、Image Builder Amazon リソースネーム (ARN) の末尾に位置する番号です。例えば、`"arn:aws:imagebuilder:us-west-2:123456789012:component/myexample-component/2019.12.02/1"` はビルドバージョンを `1` としてと表示します。

配布した Amazon マシンイメージ (AMI) を追跡できるようにするために、Image Builder は、次のタグを自動的に出力 AMI に追加します。
+ `"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
```