

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Marquer vos tâches AWS DataSync
<a name="tagging-tasks"></a>

Les *balises* sont des paires clé-valeur qui vous aident à gérer, filtrer et rechercher vos AWS DataSync ressources. Vous pouvez ajouter jusqu'à 50 balises à chaque DataSync tâche et à son exécution.

Par exemple, vous pouvez créer une tâche pour une migration de données volumineuse et lui attribuer la clé **Project** et la valeur**Large Migration**. Pour mieux organiser la migration, vous pouvez étiqueter une exécution de la tâche avec la clé **Transfer Date** et la valeur **May 2021** (les exécutions de tâches suivantes peuvent être balisées **June 2021****July 2021**, etc.).

## Marquer votre tâche DataSync
<a name="tagging-tasks-console"></a>

Vous ne pouvez étiqueter votre DataSync tâche que lors de sa création.

### Utilisation de la DataSync console
<a name="tagging-tasks-console-steps"></a>

1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Tâches**, puis choisissez **Créer une tâche**.

1. Configurez les emplacements source et de destination de votre tâche.

   Pour de plus amples informations, consultez [Où puis-je transférer mes données AWS DataSync ?](working-with-locations.md).

1. Sur la page **Configurer les paramètres**, choisissez **Ajouter une nouvelle balise** pour étiqueter votre tâche.

### À l'aide du AWS CLI
<a name="tagging-tasks-cli-steps"></a>

1. Copiez la `create-task` commande suivante :

   ```
   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. Spécifiez les paramètres suivants dans la commande :
   + `--source-location-arn`— Spécifiez le nom de ressource Amazon (ARN) de l'emplacement source lors de votre transfert.
   + `--destination-location-arn`— Spécifiez l'ARN du lieu de destination lors de votre transfert.
   + `--tags`— Spécifiez les balises que vous souhaitez appliquer à la tâche.

     Pour plusieurs balises, séparez chaque paire clé-valeur par un espace.

1. (Facultatif) Spécifiez d'autres paramètres adaptés à votre scénario de transfert.

   Pour une liste de`--options`, voir la commande [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html).

1. Exécutez la commande `create-task`.

   Vous obtenez une réponse qui indique la tâche que vous venez de créer.

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

Pour afficher les balises que vous avez ajoutées à cette tâche, vous pouvez utiliser la [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)commande.

## Marquer l'exécution de vos DataSync tâches
<a name="tagging-task-executions-console"></a>

Vous pouvez étiqueter chaque exécution de votre DataSync tâche.

Si votre tâche possède déjà des balises, n'oubliez pas ce qui suit concernant l'utilisation de balises lors de l'exécution des tâches :
+ Si vous démarrez votre tâche avec la console, ses balises créées par l'utilisateur sont automatiquement appliquées à l'exécution de la tâche. Toutefois, les balises créées par le système qui commencent par ne `aws:` sont pas appliquées.
+ Si vous démarrez votre tâche avec l' DataSync API ou AWS CLI si ses balises ne sont pas appliquées automatiquement à l'exécution de la tâche.

### Utilisation de la DataSync console
<a name="tagging-task-executions-console"></a>

Pour ajouter, modifier ou supprimer des balises lors de l'exécution d'une tâche, vous devez démarrer la tâche avec des options de remplacement.

1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Tâches**.

1. Choisissez la tâche.

1. Choisissez **Démarrer**, puis choisissez l'une des options suivantes : 
   + **Commencez par les valeurs par défaut** : applique toutes les balises associées à votre tâche.
   + **Commencez par remplacer les options** : vous permet d'ajouter, de modifier ou de supprimer des balises pour l'exécution de cette tâche particulière.

### À l'aide du AWS CLI
<a name="tagging-task-executions-cli"></a>

1. Copiez la `start-task-execution` commande suivante :

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

1. Spécifiez les paramètres suivants dans la commande :
   + `--task-arn`— Spécifiez l'ARN de la tâche que vous souhaitez démarrer.
   + `--tags`— Spécifiez les balises que vous souhaitez appliquer à cette exécution spécifique de la tâche.

     Pour plusieurs balises, séparez chaque paire clé-valeur par un espace.

1. (Facultatif) Spécifiez d'autres paramètres adaptés à votre situation.

   Pour plus d’informations, consultez la commande [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html).

1. Exécutez la commande `start-task-execution`.

   Vous obtenez une réponse qui indique l'exécution de la tâche que vous venez de démarrer.

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

Pour afficher les balises que vous avez ajoutées à cette tâche, vous pouvez utiliser la [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)commande.