

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á.

# Marcando suas tarefas AWS DataSync
<a name="tagging-tasks"></a>

As *tags* são pares de valores-chave que ajudam você a gerenciar, filtrar e pesquisar seus AWS DataSync recursos. Você pode adicionar até 50 tags a cada DataSync tarefa e execução de tarefas.

Por exemplo, você pode criar uma tarefa para uma grande migração de dados e marcar a tarefa com a chave **Project** e o valor **Large Migration**. Para organizar ainda mais a migração, você pode marcar uma execução da tarefa com a chave **Transfer Date** e o valor **May 2021** (as execuções de tarefas subsequentes podem ser marcadas **June 2021**, **July 2021** e assim por diante).

## Marcando sua tarefa DataSync
<a name="tagging-tasks-console"></a>

Você pode marcar sua DataSync tarefa somente ao criar a tarefa.

### Usando o DataSync console
<a name="tagging-tasks-console-steps"></a>

1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. No painel de navegação esquerdo, expanda **Transferência de dados**, escolha **Tarefas** e, em seguida, escolha **Criar tarefa**.

1. Configure os locais de origem e destino da sua tarefa.

   Para obter mais informações, consulte [Para onde posso transferir meus dados AWS DataSync?](working-with-locations.md).

1. Na página **Definir configurações**, escolha **Adicionar tag** para marcar a tarefa.

### Usando o AWS CLI
<a name="tagging-tasks-cli-steps"></a>

1. Copie o seguinte comando `create-task`:

   ```
   aws datasync create-task \
       --source-location-arn 'arn:aws:datasync:region:account-id:location/source-location-id' \
       --destination-location-arn 'arn:aws:datasync:region:account-id:location/destination-location-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. Especifique os seguintes parâmetros no comando:
   + `--source-location-arn`: especifique o nome do recurso da Amazon (ARN) do local de origem na transferência.
   + `--destination-location-arn`: especifique o ARN do local de destino na transferência.
   + `--tags`: especifique as tags que você deseja aplicar à tarefa.

     Para mais de uma tag, separe cada par de valores-chave com um espaço.

1. (Opcional) Especifique outros parâmetros que façam sentido para o cenário de transferência.

   Para obter uma lista de `--options`, consulte o comando [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html).

1. Execute o comando `create-task`.

   Você recebe uma resposta que mostra a tarefa que você acabou de criar.

   ```
   {
       "TaskArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

Para ver as tags que você adicionou a essa tarefa, você pode usar o [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.

## Marcando sua execução de DataSync tarefas
<a name="tagging-task-executions-console"></a>

Você pode marcar cada execução da sua DataSync tarefa.

Se sua tarefa já tiver tags, lembre-se do seguinte sobre o uso de tags com execuções de tarefas:
+ Se você iniciar sua tarefa com o console, as tags criadas pelo usuário serão aplicadas automaticamente à execução da tarefa. No entanto, as tags criadas pelo sistema que começam com `aws:` não são aplicadas.
+ Se você iniciar sua tarefa com a DataSync API ou AWS CLI, suas tags não serão aplicadas automaticamente à execução da tarefa.

### Usando o DataSync console
<a name="tagging-task-executions-console"></a>

Para adicionar, editar ou remover tags da execução de uma tarefa, você deve iniciar a tarefa com opções de substituição.

1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. No painel de navegação esquerdo, expanda **Transferência de dados** e selecione **Tarefas**.

1. Escolha a tarefa.

1. Escolha **Iniciar** e, em seguida, uma das seguintes opções: 
   + **Iniciar com padrões**: aplica todas as tags associadas à tarefa.
   + **Iniciar com opções de substituição**: permite adicionar, editar ou remover tags para a execução dessa tarefa específica.

### Usando o AWS CLI
<a name="tagging-task-executions-cli"></a>

1. Copie o seguinte comando `start-task-execution`:

   ```
   aws datasync start-task-execution \
       --task-arn 'arn:aws:datasync:region:account-id:task/task-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. Especifique os seguintes parâmetros no comando:
   + `--task-arn`: especifique o ARN da tarefa que você deseja iniciar.
   + `--tags`: especifique as tags que você deseja aplicar a essa execução específica da tarefa.

     Para mais de uma tag, separe cada par de valores-chave com um espaço.

1. (Opcional) Especifique outros parâmetros que façam sentido para a sua situação.

   Para obter mais informações, consulte o comando [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html).

1. Execute o comando `start-task-execution`.

   Você recebe uma resposta que mostra a execução da tarefa que você acabou de iniciar.

   ```
   {
       "TaskExecutionArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

Para ver as tags que você adicionou a essa tarefa, você pode usar o [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.