

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Tag: Image Builder-Ausgaberessourcen
<a name="tag-resources"></a>

Das Markieren Ihrer Ressourcen kann nützlich sein, um Ressourcenkosten oder andere Kategorien zu filtern und nachzuverfolgen. Sie können den Zugriff auch anhand von Stichwörtern steuern. Weitere Informationen zur tagbasierten Autorisierung finden Sie unter [Autorisierung basierend auf Image Builder Builder-Tags](security_iam_service-with-iam.md#security-iam-service-with-ib-tags)

Image Builder unterstützt die folgenden dynamischen Tags:
+ `- {{imagebuilder:buildDate}}`

  Löst den Build date/time bei der Erstellung auf.
+ `- {{imagebuilder:buildVersion}}`

  Wird in eine Build-Version aufgelöst, bei der es sich um eine Zahl handelt, die sich am Ende eines Image Builder Builder-Amazon-Ressourcennamens (ARN) befindet. `"arn:aws:imagebuilder:us-west-2:123456789012:component/myexample-component/2019.12.02/1"`Zeigt die Build-Version beispielsweise als`1`.

Damit Sie den Überblick über Amazon Machine Images (AMIs) behalten, die Sie verteilt haben, fügt Image Builder Ihrer Ausgabe automatisch die folgenden Tags hinzu AMIs.
+ `"CreatedBy":"EC2 Image Builder"`
+ `"Ec2ImageBuilderArn":"arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0/10"`. Dieses Tag enthält den ARN der Image Builder Builder-Image-Ressource, die zur Erstellung des AMI verwendet wurde.

**Topics**
+ [Kennzeichnen Sie eine Ressource aus dem AWS CLI](#cli-tag-resource)
+ [Trennen Sie die Markierung einer Ressource aus dem AWS CLI](#cli-untag-resource)
+ [Listet alle Tags für eine bestimmte Ressource aus dem AWS CLI](#cli-list-tags-for-resource)

## Kennzeichnen Sie eine Ressource aus dem AWS CLI
<a name="cli-tag-resource"></a>

Das folgende Beispiel zeigt, wie Sie einen **imagebuilder** CLI-Befehl verwenden, um eine Ressource in EC2 Image Builder hinzuzufügen und zu kennzeichnen. Sie müssen die Tags `resourceArn` und die Tags angeben, die darauf angewendet werden sollen.

Der `tag-resource.json` Inhalt des Beispiels lautet wie folgt:

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

Führen Sie den folgenden Befehl aus, der auf die vorherige `tag-resource.json` Datei verweist.

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

## Trennen Sie die Markierung einer Ressource aus dem AWS CLI
<a name="cli-untag-resource"></a>

Das folgende Beispiel zeigt, wie ein **imagebuilder** CLI-Befehl verwendet wird, um ein Tag aus einer Ressource zu entfernen. Sie müssen die Schlüssel `resourceArn` und die Schlüssel angeben, um das Tag zu entfernen.

Der `untag-resource.json` Inhalt des Beispiels lautet wie folgt:

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

Führen Sie den folgenden Befehl aus, der auf die vorherige `untag-resource.json` Datei verweist.

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

## Listet alle Tags für eine bestimmte Ressource aus dem AWS CLI
<a name="cli-list-tags-for-resource"></a>

Das folgende Beispiel zeigt, wie Sie einen **imagebuilder** CLI-Befehl verwenden, um alle Tags für eine bestimmte Ressource aufzulisten.

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