# Adicionar tags a um trabalho existente do Operações em Lote
<a name="put-job-tags"></a>

Você pode usar a operação de API [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutJobTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutJobTagging.html) para adicionar tags aos trabalhos existentes do Operações em Lote do Amazon S3. Para obter mais informações, veja os exemplos a seguir:

## Usar a AWS CLI
<a name="batch-ops-example-cli-job-tags-put-job-tagging"></a>

Veja a seguir um exemplo de uso de `s3control put-job-tagging` para adicionar tags aos trabalhos do Operações em Lote do S3 usando a AWS CLI. Para usar os exemplos, substitua {{`user input placeholders`}} por suas próprias informações.

**nota**  
Se você enviar essa solicitação com o conjunto de tags vazio, o Operações em Lote excluirá o conjunto de tags existente no objeto. No entanto, se você usar essa abordagem, receberá cobrança por uma solicitação de nível 1 (`PUT`). Para obter mais informações, consulte [Preço do Amazon S3](https://aws.amazon.com/s3/pricing).  
Em vez disso, para excluir tags existentes do trabalho do Operações em Lote, recomendamos usar a operação `DeleteJobTagging` porque ela consegue o mesmo resultado sem incorrer em cobranças.

1. Identifique as `TAGS` que você deseja para o trabalho. Nesse caso, você aplica duas tags, `{{department}}` e `{{FiscalYear}}`, com os valores `{{Marketing}}` e `{{2020}}`, respectivamente.

   ```
   read -d '' TAGS <<EOF
   [
     {
       "Key": "{{department}}",
       "Value": "{{Marketing}}"
     },
     {
       "Key": "{{FiscalYear}}",
       "Value": "{{2020}}"
     }
   ]
   EOF
   ```

1. Execute o seguinte comando `put-job-tagging` com os parâmetros exigidos:

   ```
   aws \
       s3control put-job-tagging \
       --account-id {{123456789012}} \
       --tags "${TAGS//$'\n'/}" \
       --job-id {{Example-e25a-4ed2-8bee-7f8ed7fc2f1c}} \
       --region {{us-east-1}}
   ```

## Usar o AWS SDK para Java
<a name="batch-ops-examples-java-job-with-tags-put"></a>

Se quiser colocar tags em um trabalho do recurso Operações em Lote do S3 usando o AWS SDK para Java, use o cliente S3Control para adicionar ou atualizar tags com pares de chave-valor para fins de organização e rastreamento.

Para ver exemplos de como inserir tags de trabalho com o AWS SDK para Java, consulte [Add tags to a batch job](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_PutJobTagging_section.html) na *Referência de API do Amazon S3*.