As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Marcar recursos de saída do Image Builder
<a name="tag-resources"></a>

Marcar seus recursos pode ser útil para filtrar e monitorar os custos dos recursos ou outras categorias. Você também pode controlar o acesso com base em tags. Para obter mais informações sobre a autorização baseada em tags, consulte [Autorização baseada em tags do construtor de imagens do construtor](security_iam_service-with-iam.md#security-iam-service-with-ib-tags).

O Image Builder oferece suporte às seguintes tags dinâmicas:
+ `- {{imagebuilder:buildDate}}`

  Resolve para a compilação date/time no momento da construção.
+ `- {{imagebuilder:buildVersion}}`

  Será resolvido como versão de compilação, que é um número localizado no final de um nome de recurso da Amazon (ARN) do Image Builder. Por exemplo, `"arn:aws:imagebuilder:us-west-2:123456789012:component/myexample-component/2019.12.02/1"` mostra a versão de compilação como `1`.

Para ajudá-lo a acompanhar as Amazon Machine Images (AMIs) que você distribuiu, o Image Builder adiciona automaticamente as seguintes tags à sua saída AMIs.
+ `"CreatedBy":"EC2 Image Builder"`
+ `"Ec2ImageBuilderArn":"arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0/10"`: essa tag contém o ARN do recurso de imagem do Image Builder que foi usado para criar a AMI.

**Topics**
+ [Marque um recurso do AWS CLI](#cli-tag-resource)
+ [Desmarque um recurso do AWS CLI](#cli-untag-resource)
+ [Liste todas as tags de um recurso específico do AWS CLI](#cli-list-tags-for-resource)

## Marque um recurso do AWS CLI
<a name="cli-tag-resource"></a>

O exemplo a seguir mostra como usar um comando CLI do **imagebuilder** para adicionar e marcar um recurso no EC2 Image Builder. Você deve fornecer os `resourceArn` e as tags que serão aplicadas a eles.

O conteúdo do `tag-resource.json` de exemplo é o seguinte:

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

Execute o seguinte comando, que faz referência ao arquivo anterior do `tag-resource.json`.

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

## Desmarque um recurso do AWS CLI
<a name="cli-untag-resource"></a>

O seguinte exemplo mostra como usar um comando da CLI do **imagebuilder** para desmarcar um recurso. Você deve fornecer as `resourceArn` e as chaves para desmarcar.

O conteúdo do `untag-resource.json` de exemplo é o seguinte:

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

Execute o seguinte comando, que faz referência ao arquivo anterior do `untag-resource.json`.

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

## Liste todas as tags de um recurso específico do AWS CLI
<a name="cli-list-tags-for-resource"></a>

O exemplo a seguir mostra como usar um comando da CLI do **imagebuilder** para indicar todas as tags de um recurso específico.

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