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.
# Création d'une tâche pour le transfert de vos données
Une *tâche* décrit où et comment les données sont AWS DataSync transférées. Une tâche comprend les éléments suivants :
+ [**Emplacement de la source**](working-with-locations.md) : système ou service de stockage à partir duquel DataSync les données sont transférées.
+ [**Lieu de destination**](working-with-locations.md) : système ou service de stockage DataSync vers lequel les données sont transférées.
+ [**Options des tâches**](task-options.md) : paramètres tels que les fichiers à transférer, le mode de vérification des données, le moment d'exécution de la tâche, etc.
+ [**Exécutions de tâches**](run-task.md) : lorsque vous exécutez une tâche, cela s'appelle une *exécution de tâche*.
## Création de votre tâche
Lorsque vous créez une DataSync tâche, vous spécifiez vos emplacements source et de destination. Vous pouvez également personnaliser votre tâche en choisissant les fichiers à transférer, la manière dont les métadonnées sont traitées, en établissant un calendrier, etc.
Avant de créer votre tâche, assurez-vous de comprendre le [fonctionnement des DataSync transferts](how-datasync-transfer-works.md#transferring-files) et vérifiez les [quotas de tâches](datasync-limits.md#task-hard-limits).
**Important**
Si vous prévoyez de transférer des données depuis ou vers un site Amazon S3, examinez [comment cela DataSync peut affecter les frais de votre demande S3](create-s3-location.md#create-s3-location-s3-requests) et la [page de DataSync tarification](https://aws.amazon.com/datasync/pricing/) avant de commencer.
### Utilisation de la DataSync console
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Assurez-vous que vous vous trouvez dans l'un des Régions AWS endroits où vous prévoyez de transférer des données.
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. Sur la page **Configurer l'emplacement de la source**, [créez](transferring-data-datasync.md) ou choisissez un emplacement source, puis choisissez **Suivant**.
1. Sur la page **Configurer l'emplacement de destination**, [créez](transferring-data-datasync.md) ou choisissez un emplacement de destination, puis choisissez **Suivant**.
1. (Recommandé) Sur la page **Configurer les paramètres**, attribuez à votre tâche un nom dont vous vous souviendrez.
1. Tout en restant sur la page **Configurer les paramètres**, choisissez les options de vos tâches ou utilisez les paramètres par défaut.
Certaines des options suivantes pourraient vous intéresser :
+ Spécifiez le [mode de tâche](choosing-task-mode.md) que vous souhaitez utiliser.
+ Spécifiez les données à transférer à l'aide d'un [manifeste](transferring-with-manifest.md) ou de [filtres](filtering.md).
+ Configurez le mode de [gestion des métadonnées des fichiers](configure-metadata.md) et de [vérification de l'intégrité des données](configure-data-verification-options.md).
+ Surveillez votre transfert à l'aide de [rapports de tâches](task-reports.md) ou [d'Amazon CloudWatch](monitor-datasync.md). Nous vous recommandons de configurer une sorte de surveillance pour votre tâche.
Lorsque vous avez terminé, sélectionnez **Next**.
1. Vérifiez la configuration de vos tâches, puis choisissez **Créer une tâche**.
Vous êtes prêt à [commencer votre tâche](run-task.md).
### À l'aide du AWS CLI
Une fois que vous avez [créé vos emplacements DataSync source et de destination](transferring-data-datasync.md), vous pouvez créer votre tâche.
1. Dans vos AWS CLI paramètres, assurez-vous que vous utilisez l'un des emplacements Régions AWS où vous prévoyez de transférer des données.
1. Copiez la `create-task` commande suivante :
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name"
```
1. Pour`--source-location-arn`, spécifiez l'Amazon Resource Name (ARN) de votre emplacement source.
1. Pour`--destination-location-arn`, spécifiez l'ARN de votre position de destination.
Si vous transférez plusieurs Régions AWS comptes, assurez-vous que l'ARN inclut l'autre région ou l'autre identifiant de compte.
1. (Recommandé) Pour`--name`, spécifiez un nom mémorisable pour votre tâche.
1. Spécifiez les autres options de tâche selon vos besoins. Certaines des options suivantes pourraient vous intéresser :
+ Spécifiez les données à transférer à l'aide d'un [manifeste](transferring-with-manifest.md) ou de [filtres](filtering.md).
+ Configurez le mode de [gestion des métadonnées des fichiers](configure-metadata.md) et de [vérification de l'intégrité des données](configure-data-verification-options.md).
+ Surveillez votre transfert à l'aide de [rapports de tâches](task-reports.md) ou [d'Amazon CloudWatch](monitor-datasync.md). Nous vous recommandons de configurer une sorte de surveillance pour votre tâche.
Pour plus d'options, voir [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Voici un exemple de `create-task` commande qui spécifie plusieurs options :
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--cloud-watch-log-group-arn "arn:aws:logs:region:account-id" \
--name "task-name" \
--options VerifyMode=NONE,OverwriteMode=NEVER,Atime=BEST_EFFORT,Mtime=PRESERVE,Uid=INT_VALUE,Gid=INT_VALUE,PreserveDevices=PRESERVE,PosixPermissions=PRESERVE,PreserveDeletedFiles=PRESERVE,TaskQueueing=ENABLED,LogLevel=TRANSFER
```
1. Exécutez la commande `create-task`.
Si la commande aboutit, vous obtenez une réponse indiquant l'ARN de la tâche que vous avez créée. Par exemple :
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
Vous êtes prêt à [commencer votre tâche](run-task.md).
## Statuts des tâches
Lorsque vous créez une DataSync tâche, vous pouvez vérifier son statut pour voir si elle est prête à être exécutée.
| État de la console | État de l'API | Description |
| --- | --- | --- |
| Available | `AVAILABLE` | La tâche est prête à démarrer le transfert de données. |
| En cours d’exécution | `RUNNING` | L'exécution d'une tâche est en cours. Pour de plus amples informations, veuillez consulter [Statuts d'exécution des tâches](run-task.md#understand-task-execution-statuses). |
| Unavailable | `UNAVAILABLE` | Un DataSync agent utilisé par la tâche est hors ligne. Pour de plus amples informations, consultez [Que dois-je faire si mon agent est hors ligne ?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline). |
| En file d’attente | `QUEUED` | Une autre exécution de tâche utilisant le même DataSync agent est en cours. Pour de plus amples informations, veuillez consulter [Savoir quand votre tâche est en file d'attente](run-task.md#queue-task-execution). |
## Partitionnement de grands ensembles de données avec plusieurs tâches
Si vous transférez un ensemble de données volumineux, par exemple si vous [migrez](datasync-large-migration.md) des millions de fichiers ou d'objets, nous vous recommandons d'utiliser le mode DataSync amélioré pour votre transfert, qui permet de transférer des ensembles de données contenant un nombre pratiquement illimité de fichiers. Pour les ensembles de données très volumineux, contenant des milliards de fichiers, vous devez envisager de partitionner votre ensemble de données en plusieurs DataSync tâches. Le partitionnement de vos données entre plusieurs tâches (et éventuellement entre plusieurs [agents](do-i-need-datasync-agent.md#multiple-agents), en fonction de vos sites) permet de réduire le temps nécessaire DataSync à la préparation et au transfert de vos données.
Examinez les différentes manières de partitionner un ensemble de données volumineux entre plusieurs DataSync tâches :
+ Créez des tâches qui transfèrent des dossiers distincts. Par exemple, vous pouvez créer deux tâches qui ciblent `/FolderA` et`/FolderB`, respectivement, dans votre stockage source.
+ Créez des tâches qui transfèrent des sous-ensembles de fichiers, d'objets et de dossiers à l'aide d'un [manifeste](transferring-with-manifest.md) ou de [filtres](filtering.md).
Sachez que cette approche peut augmenter les I/O opérations sur votre stockage et affecter la bande passante de votre réseau. Pour plus d'informations, consultez le blog [Comment accélérer vos transferts de données grâce à des architectures DataSync évolutives](https://aws.amazon.com/blogs/storage/how-to-accelerate-your-data-transfers-with-aws-datasync-scale-out-architectures/).
## Segmentation des données transférées avec plusieurs tâches
Si vous transférez différents ensembles de données vers la même destination, vous pouvez créer plusieurs tâches pour segmenter les données que vous transférez.
Par exemple, si vous effectuez un transfert vers le même compartiment S3 nommé`MyBucket`, vous pouvez créer différents préfixes dans le compartiment correspondant à chaque tâche. Cette approche évite les conflits de noms de fichiers entre les ensembles de données et vous permet de définir des autorisations différentes pour chaque préfixe. Voici comment vous pouvez le configurer :
1. Créez trois préfixes dans la destination `MyBucket` nommée `task1``task2`, et `task3` :
+ `s3://MyBucket/task1`
+ `s3://MyBucket/task2`
+ `s3://MyBucket/task3`
1. Créez trois DataSync tâches nommées `task1``task2`, et `task3` transférez-les vers le préfixe correspondant dans`MyBucket`.
# Choix d'un mode de tâche pour le transfert de données
Votre AWS DataSync tâche peut être exécutée dans l'un des modes suivants :
+ **Mode amélioré** : transférez un nombre pratiquement illimité de fichiers ou d'objets avec des performances supérieures à celles du mode de base. Les tâches en mode amélioré optimisent le processus de transfert de données en listant, préparant, transférant et vérifiant les données en parallèle. Le mode amélioré est actuellement disponible pour les transferts entre les sites Amazon S3, les transferts entre Azure Blob et Amazon S3 sans agent, les transferts entre d'autres clouds et Amazon S3 sans agent, et les transferts entre des serveurs de fichiers NFS ou SMB et Amazon S3 à l'aide d'un agent en mode amélioré.
+ **Mode de base** : transférez des fichiers ou des objets entre le AWS stockage et tous les autres DataSync emplacements pris en charge. Les tâches en mode de base sont soumises à [des quotas](datasync-limits.md) sur le nombre de fichiers, d'objets et de répertoires dans un ensemble de données. Le mode de base prépare, transfère et vérifie les données de manière séquentielle, ce qui le rend plus lent que le mode amélioré pour la plupart des charges de travail.
## Comprendre les différences entre les modes de tâche
Les informations suivantes peuvent vous aider à déterminer le mode de tâche à utiliser.
| Capacité | Comportement en mode amélioré | Comportement du mode de base |
| --- | --- | --- |
| [Performances](how-datasync-transfer-works.md#transferring-files) | DataSync répertorie, prépare, transfère et vérifie vos données en parallèle. Fournit des performances supérieures à celles du mode de base pour la plupart des charges de travail (telles que le transfert d'objets volumineux) | DataSync prépare, transfère et vérifie vos données de manière séquentielle. Les performances sont plus lentes que le mode amélioré pour la plupart des charges de travail |
| Nombre d'éléments d'un ensemble de données qui DataSync peuvent être utilisés par exécution de tâche | Un nombre pratiquement illimité d'objets | [Des quotas](datasync-limits.md#task-hard-limits) s'appliquent |
| [Compteurs](transfer-performance-counters.md) [et métriques de transfert de données](monitor-datasync.md) | Plus de compteurs et de mesures que le mode de base, tels que le nombre d'objets trouvés DataSync à votre emplacement source, le nombre d'objets préparés lors de chaque exécution de tâche et les compteurs de dossiers similaires aux compteurs de fichiers et d'objets | Moins de compteurs et de métriques que le mode amélioré |
| [Journalisation](configure-logging.md) | Journaux structurés (format JSON) | Journaux non structurés |
| [Emplacements pris en charge](working-with-locations.md) | Actuellement, pour les transferts entre les sites Amazon S3, les transferts entre Azure Blob et Amazon S3 sans agent, les transferts entre d'autres clouds et Amazon S3 sans agent, et les transferts entre des serveurs de fichiers NFS ou SMB et Amazon S3 à l'aide d'un agent en mode amélioré. | Pour les transferts entre tous les sites DataSync compatibles |
| [Options de vérification des données](configure-data-verification-options.md) | DataSync vérifie uniquement les données transférées | DataSync vérifie toutes les données par défaut |
| Cost | Pour plus d'informations, consultez la page de [DataSync tarification](https://aws.amazon.com/datasync/pricing) | Pour plus d'informations, consultez la page de [DataSync tarification](https://aws.amazon.com/datasync/pricing) |
| Gestion des défaillances pour les balises d'objet non prises en charge | Pour les transferts de stockage dans le cloud vers ou depuis des emplacements qui ne prennent pas en charge le balisage d'objets, l'exécution de la tâche échouera immédiatement si l'ObjectTagsoption n'est pas spécifiée ou si elle est définie sur. PRESERVE | Pour les transferts de stockage dans le cloud vers ou depuis des emplacements qui ne prennent pas en charge le balisage d'objets, l'exécution des tâches s'exécutera normalement, mais les échecs par objet seront signalés pour les objets balisés si l'ObjectTagsoption n'est pas spécifiée ou si elle est définie sur. PRESERVE |
## Choix d'un mode de tâche
Vous pouvez choisir le mode amélioré uniquement pour les transferts entre les sites Amazon S3, les transferts entre Azure Blob et Amazon S3 sans agent, les transferts entre d'autres clouds et Amazon S3 sans agent, et les transferts entre des serveurs de fichiers NFS ou SMB et Amazon S3 à l'aide d'un agent en mode amélioré. Dans le cas contraire, vous devez utiliser le mode de base. Par exemple, un transfert d'un emplacement [HDFS sur site vers un emplacement](create-hdfs-location.md) S3 nécessite le mode Basic.
Les options et les performances de vos tâches peuvent varier en fonction du mode de tâche que vous choisissez. Une fois que vous avez créé votre tâche, vous ne pouvez pas modifier le mode de tâche.
**Autorisations requises**
Pour créer une tâche en mode amélioré, le rôle IAM que vous utilisez doit disposer DataSync de l'`iam:CreateServiceLinkedRole`autorisation.
Pour vos autorisations DataSync d'utilisateur, pensez à utiliser [AWSDataSyncFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-awsdatasyncfullaccess). Il s'agit d'une politique AWS gérée qui fournit à l'utilisateur un accès complet DataSync et un accès minimal à ses dépendances.
### Utilisation de la DataSync console
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. Pour **le mode tâche**, choisissez l'une des options suivantes :
+ **Amélioré**
+ **Base**
Pour de plus amples informations, veuillez consulter [Comprendre les différences entre les modes de tâche](#task-mode-differences).
1. Tout en restant sur la page **Configurer les paramètres**, choisissez d'autres options de tâche ou utilisez les paramètres par défaut.
Certaines des options suivantes pourraient vous intéresser :
+ Spécifiez les données à transférer à l'aide d'un [manifeste](transferring-with-manifest.md) ou de [filtres](filtering.md).
+ Configurez le mode de [gestion des métadonnées des fichiers](configure-metadata.md) et de [vérification de l'intégrité des données](configure-data-verification-options.md).
+ Surveillez votre transfert à l'aide de [rapports de tâches](task-reports.md) ou [d'Amazon CloudWatch Logs](monitor-datasync.md).
Lorsque vous avez terminé, sélectionnez **Next**.
1. Vérifiez la configuration de vos tâches, puis choisissez **Créer une tâche**.
### À l'aide du AWS CLI
1. Dans vos AWS CLI paramètres, assurez-vous que vous utilisez l'un des emplacements Régions AWS où vous prévoyez de transférer des données.
1. Copiez la `create-task` commande suivante :
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--task-mode "ENHANCED-or-BASIC"
```
1. Pour`--source-location-arn`, spécifiez l'Amazon Resource Name (ARN) de votre emplacement source.
1. Pour`--destination-location-arn`, spécifiez l'ARN de votre position de destination.
Si vous transférez plusieurs Régions AWS comptes, assurez-vous que l'ARN inclut l'autre région ou l'autre identifiant de compte.
1. Pour`--task-mode`, spécifiez `ENHANCED` ou`BASIC`.
Pour de plus amples informations, veuillez consulter [Comprendre les différences entre les modes de tâche](#task-mode-differences).
1. Spécifiez les autres options de tâche selon vos besoins. Certaines des options suivantes pourraient vous intéresser :
+ Spécifiez les données à transférer à l'aide d'un [manifeste](transferring-with-manifest.md) ou de [filtres](filtering.md).
+ Configurez le mode de [gestion des métadonnées des fichiers](configure-metadata.md) et de [vérification de l'intégrité des données](configure-data-verification-options.md).
+ Surveillez votre transfert à l'aide de [rapports de tâches](task-reports.md) ou [d'Amazon CloudWatch Logs](monitor-datasync.md).
Pour plus d'options, voir [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Voici un exemple de `create-task` commande qui spécifie le mode amélioré et plusieurs autres options :
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name" \
--task-mode "ENHANCED" \
--options TransferMode=CHANGED,VerifyMode=ONLY_FILES_TRANSFERRED,ObjectTags=PRESERVE,LogLevel=TRANSFER
```
1. Exécutez la commande `create-task`.
Si la commande aboutit, vous obtenez une réponse indiquant l'ARN de la tâche que vous avez créée. Par exemple :
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
### Utilisation de l' DataSync API
Vous pouvez définir le mode de DataSync tâche en configurant le `TaskMode` paramètre dans l'[CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)opération.
# Choisir quels AWS DataSync transferts
AWS DataSync vous permet de choisir les éléments à transférer et la manière dont vous souhaitez que vos données soient traitées. Certaines options incluent :
+ Transférer une liste exacte de fichiers ou d'objets à l'aide d'un manifeste.
+ Incluez ou excluez certains types de données dans votre transfert à l'aide d'un filtre.
+ Pour les transferts récurrents, déplacer uniquement les données modifiées depuis le dernier transfert
+ Remplacer les données de l'emplacement de destination pour qu'elles correspondent à celles de l'emplacement source.
+ Choix des métadonnées de fichier ou d'objet à conserver entre vos emplacements de stockage.
**Topics**
+ [Transfert de fichiers ou d'objets spécifiques à l'aide d'un manifeste](transferring-with-manifest.md)
+ [Transfert de fichiers, d'objets et de dossiers spécifiques à l'aide de filtres](filtering.md)
+ [Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets](metadata-copied.md)
+ [Liens et répertoires copiés par AWS DataSync](special-files-copied.md)
+ [Configuration du mode de gestion des fichiers, des objets et des métadonnées](configure-metadata.md)
# Transfert de fichiers ou d'objets spécifiques à l'aide d'un manifeste
Un *manifeste* est une liste de fichiers ou d'objets que vous AWS DataSync souhaitez transférer. Par exemple, au lieu de tout transférer dans un compartiment S3 contenant potentiellement des millions d'objets, il ne DataSync transfère que les objets que vous listez dans votre manifeste.
Les manifestes sont similaires aux [filtres](filtering.md), mais ils vous permettent d'identifier exactement les fichiers ou les objets à transférer plutôt que les données correspondant à un modèle de filtre.
**Note**
La taille maximale autorisée pour un fichier manifeste contenant des tâches en mode amélioré est de 20 Go.
## Création de votre manifeste
Un manifeste est un fichier au format CSV (valeurs séparées par des virgules) qui répertorie les fichiers ou les objets que vous souhaitez transférer dans votre emplacement source. DataSync Si votre source est un compartiment S3, vous pouvez également indiquer la version d'un objet à transférer.
**Topics**
+ [Consignes](#transferring-with-manifest-guidelines)
+ [Exemples de manifestes](#manifest-examples)
### Consignes
Utilisez ces directives pour vous aider à créer un manifeste compatible avec DataSync.
------
#### [ Do ]
+ Spécifiez le chemin complet de chaque fichier ou objet que vous souhaitez transférer.
Vous ne pouvez pas spécifier uniquement un répertoire ou un dossier dans le but de transférer tout son contenu. Dans ces situations, pensez à utiliser un [filtre d'inclusion](filtering.md) au lieu d'un manifeste.
+ Assurez-vous que le chemin de chaque fichier ou objet est relatif au chemin de montage, au dossier, au répertoire ou au préfixe que vous avez spécifié lors de la configuration de votre emplacement DataSync source.
Supposons, par exemple, que vous [configurez un emplacement S3](create-s3-location.md#create-s3-location-how-to) avec un préfixe nommé`photos`. Ce préfixe inclut un objet `my-picture.png` que vous souhaitez transférer. Dans le manifeste, il suffit alors de spécifier l'objet (`my-picture.png`) au lieu du préfixe et de l'objet (`photos/my-picture.png`).
+ Pour spécifier la version de l'objet Amazon S3 IDs, séparez le chemin et l'ID de version de l'objet à l'aide d'une virgule.
L'exemple suivant montre une entrée de manifeste comportant deux champs. Le premier champ inclut un objet nommé`picture1.png`. Le deuxième champ est séparé par une virgule et inclut un ID de version de `111111` :
```
picture1.png,111111
```
+ Utilisez des guillemets dans les situations suivantes :
+ Lorsqu'un chemin contient des caractères spéciaux (virgules, guillemets et fins de ligne) :
`"filename,with,commas.txt"`
+ Lorsqu'un chemin s'étend sur plusieurs lignes :
```
"this
is
a
filename.txt"
```
+ Lorsqu'un chemin inclut des guillemets :
`filename""with""quotes.txt`
Cela représente un chemin nommé`filename"with"quotes.txt`.
Ces règles de devis s'appliquent également aux champs d'ID de version. En général, si un champ de manifeste contient un guillemet, vous devez y échapper par un autre guillemet.
+ Séparez chaque entrée de fichier ou d'objet par une nouvelle ligne.
Vous pouvez séparer les lignes en utilisant des sauts de ligne de style Linux (alimentation en ligne ou retour en chariot) ou Windows (retour en chariot suivi d'une alimentation en ligne).
+ Enregistrez votre manifeste (par exemple, `my-manifest.csv` ou`my-manifest.txt`).
+ Téléchargez le manifeste dans un compartiment S3 auquel il est [DataSync possible d'accéder](#transferring-with-manifest-access).
Il n'est pas nécessaire que ce compartiment se trouve dans le même compte Région AWS ou dans le même compte que celui que vous utilisez DataSync.
------
#### [ Don't ]
+ Spécifiez uniquement un répertoire ou un dossier dans le but de transférer tout son contenu.
Un manifeste ne peut inclure que les chemins complets vers les fichiers ou les objets que vous souhaitez transférer. Si vous configurez votre emplacement source pour utiliser un chemin de montage, un dossier, un répertoire ou un préfixe spécifique, vous n'êtes pas obligé de l'inclure dans votre manifeste.
+ Spécifiez un chemin de fichier ou d'objet de plus de 4 096 caractères.
+ Spécifiez un chemin de fichier, un chemin d'objet ou un ID de version d'objet Amazon S3 supérieur à 1 024 octets.
+ Spécifiez les chemins de fichiers ou d'objets dupliqués.
+ Incluez un ID de version d'objet si votre emplacement source n'est pas un compartiment S3.
+ Incluez plus de deux champs dans une entrée de manifeste.
Une entrée ne peut inclure qu'un chemin de fichier ou d'objet et (le cas échéant) un ID de version d'objet Amazon S3.
+ Incluez des caractères non conformes au codage UTF-8.
+ Incluez des espaces involontaires dans vos champs de saisie en dehors des guillemets.
------
### Exemples de manifestes
Utilisez ces exemples pour vous aider à créer un manifeste qui fonctionne avec DataSync.
**Manifeste avec chemins complets de fichiers ou d'objets**
L'exemple suivant montre un manifeste avec les chemins complets des fichiers ou des objets à transférer.
```
photos/picture1.png
photos/picture2.png
photos/picture3.png
```
**Manifeste avec uniquement des clés d'objet**
L'exemple suivant montre un manifeste contenant des objets à transférer depuis un emplacement source Amazon S3. L'[emplacement étant configuré](create-s3-location.md#create-s3-location-how-to) avec le préfixe`photos`, seules les clés de l'objet sont spécifiées.
```
picture1.png
picture2.png
picture3.png
```
**Manifeste avec chemins d'objets et version IDs**
Les deux premières entrées de l'exemple de manifeste suivant incluent des versions d'objets Amazon S3 spécifiques à transférer.
```
photos/picture1.png,111111
photos/picture2.png,121212
photos/picture3.png
```
**Manifeste avec caractères UTF-8**
L'exemple suivant montre un manifeste contenant des fichiers contenant des caractères UTF-8.
```
documents/résumé1.pdf
documents/résumé2.pdf
documents/résumé3.pdf
```
## Fournir DataSync l'accès à votre manifeste
Vous avez besoin d'un rôle Gestion des identités et des accès AWS (IAM) qui donne DataSync accès à votre manifeste dans son compartiment S3. Ce rôle doit inclure les autorisations suivantes :
+ `s3:GetObject`
+ `s3:GetObjectVersion`
Vous pouvez générer ce rôle automatiquement dans la DataSync console ou le créer vous-même.
**Note**
Si votre manifeste se trouve dans un autre Compte AWS format, vous devez créer ce rôle manuellement.
### Création automatique du rôle IAM
Lorsque vous créez ou lancez une tâche de transfert dans la console, vous DataSync pouvez créer un rôle IAM avec les `s3:GetObjectVersion` autorisations `s3:GetObject` et les autorisations dont vous avez besoin pour accéder à votre manifeste.
**Autorisations requises pour créer automatiquement le rôle**
Pour créer automatiquement le rôle, assurez-vous que le rôle que vous utilisez pour accéder à la DataSync console dispose des autorisations suivantes :
+ `iam:CreateRole`
+ `iam:CreatePolicy`
+ `iam:AttachRolePolicy`
### Création du rôle IAM (même compte)
Vous pouvez créer manuellement le rôle IAM qui DataSync doit accéder à votre manifeste. Les instructions suivantes supposent que vous vous trouvez dans le même Compte AWS emplacement que celui que vous utilisez DataSync et que le compartiment S3 de votre manifeste se trouve.
1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le volet de navigation de gauche, sous **Gestion des accès**, sélectionnez **Rôles**, puis sélectionnez **Créer un rôle**.
1. Sur la page **Sélectionner une entité de confiance**, pour **Type d'entité de confiance**, sélectionnez **Service AWS**.
1. Pour **Cas d'utilisation**, choisissez **DataSync**dans la liste déroulante et sélectionnez **DataSync**. Choisissez **Suivant**.
1. Sur la page **Add permissions** (Ajouter des autorisations), sélectionnez **Next** (Suivant). Donnez un nom à votre rôle et choisissez **Créer un rôle**.
1. Sur la page **Rôles**, recherchez le rôle que vous venez de créer et choisissez son nom.
1. Sur la page de détails du rôle, choisissez l'onglet **Autorisations**. Choisissez **Ajouter des autorisations**, puis **Créer une politique en ligne**.
1. Choisissez l'onglet **JSON** et collez l'exemple de politique suivant dans l'éditeur de politiques :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. Dans l'exemple de politique que vous venez de coller, remplacez les valeurs suivantes par les vôtres :
1. `amzn-s3-demo-bucket`Remplacez-le par le nom du compartiment S3 qui héberge votre manifeste.
1. `my-manifest.csv`Remplacez-le par le nom de fichier de votre manifeste.
1. Choisissez **Suivant**. Donnez un nom à votre politique et choisissez **Create policy**.
1. (Recommandé) Pour éviter le [problème de confusion entre les services adjoints](cross-service-confused-deputy-prevention.md), procédez comme suit :
1. Sur la page de détails du rôle, choisissez l'onglet **Relations de confiance**. Choisissez **Modifier la politique d’approbation**.
1. Mettez à jour la politique de confiance en utilisant l'exemple suivant, qui inclut les clés de contexte de condition `aws:SourceAccount` globale `aws:SourceArn` et globale :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "555555555555"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:555555555555:*"
}
}
}
]
}
```
------
+ Remplacez chaque instance `account-id` par l' Compte AWS ID que vous utilisez DataSync.
+ `region`Remplacez-le Région AWS par celui que vous utilisez DataSync.
1. Choisissez **Mettre à jour une politique**.
Vous avez créé un rôle IAM qui permet d'accéder DataSync à votre manifeste. Spécifiez ce rôle lors de [la création](#manifest-creating-task) ou [du démarrage](#manifest-starting-task) de votre tâche.
### Création du rôle IAM (compte différent)
Si votre manifeste se trouve dans un compartiment S3 appartenant à un autre compartiment Compte AWS, vous devez créer manuellement le rôle IAM qui permet DataSync d'accéder au manifeste. Ensuite, dans l' Compte AWS endroit où se trouve votre manifeste, vous devez inclure le rôle dans la politique du compartiment S3.
#### Création du rôle
1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le volet de navigation de gauche, sous **Gestion des accès**, sélectionnez **Rôles**, puis sélectionnez **Créer un rôle**.
1. Sur la page **Sélectionner une entité de confiance**, pour **Type d'entité de confiance**, sélectionnez **Service AWS**.
1. Pour **Cas d'utilisation**, choisissez **DataSync**dans la liste déroulante et sélectionnez **DataSync**. Choisissez **Suivant**.
1. Sur la page **Add permissions** (Ajouter des autorisations), sélectionnez **Next** (Suivant). Donnez un nom à votre rôle et choisissez **Créer un rôle**.
1. Sur la page **Rôles**, recherchez le rôle que vous venez de créer et choisissez son nom.
1. Sur la page de détails du rôle, choisissez l'onglet **Autorisations**. Choisissez **Ajouter des autorisations**, puis **Créer une politique en ligne**.
1. Choisissez l'onglet **JSON** et collez l'exemple de politique suivant dans l'éditeur de politiques :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. Dans l'exemple de politique que vous venez de coller, remplacez les valeurs suivantes par les vôtres :
1. `amzn-s3-demo-bucket`Remplacez-le par le nom du compartiment S3 qui héberge votre manifeste.
1. `my-manifest.csv`Remplacez-le par le nom de fichier de votre manifeste.
1. Choisissez **Suivant**. Donnez un nom à votre politique et choisissez **Create policy**.
1. (Recommandé) Pour éviter le [problème de confusion entre les services adjoints](cross-service-confused-deputy-prevention.md), procédez comme suit :
1. Sur la page de détails du rôle, choisissez l'onglet **Relations de confiance**. Choisissez **Modifier la politique d’approbation**.
1. Mettez à jour la politique de confiance en utilisant l'exemple suivant, qui inclut les clés de contexte de condition `aws:SourceAccount` globale `aws:SourceArn` et globale :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "000000000000"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:000000000000:*"
}
}
}
]
}
```
------
+ Remplacez chaque instance `account-id` de par l' Compte AWS ID que vous utilisez DataSync.
+ `region`Remplacez-le Région AWS par celui que vous utilisez DataSync.
1. Choisissez **Mettre à jour une politique**.
Vous avez créé le rôle IAM que vous pouvez inclure dans votre politique de compartiment S3.
#### Mettre à jour votre politique de compartiment S3 avec le rôle
Une fois que vous avez créé le rôle IAM, vous devez l'ajouter à la politique du compartiment S3 dans l'autre Compte AWS endroit où se trouve votre manifeste.
1. Dans le AWS Management Console, passez au compte contenant le compartiment S3 de votre manifeste.
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Sur la page détaillée du bucket, choisissez l'onglet **Permissions**.
1. Sous **Politique de compartiment**, choisissez **Modifier** et procédez comme suit pour modifier votre politique de compartiment S3 :
1. Mettez à jour le contenu de l'éditeur pour inclure les déclarations de politique suivantes :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DataSyncAccessManifestBucket",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket"
}
]
}
```
------
1. `account-id`Remplacez-le par l' Compte AWS identifiant du compte que vous utilisez DataSync .
1. `datasync-role`Remplacez-le par le rôle IAM que vous venez de créer et qui permet d'accéder DataSync à votre manifeste.
1. `amzn-s3-demo-bucket`Remplacez-le par le nom du compartiment S3 qui héberge votre manifeste dans l'autre Compte AWS.
1. Sélectionnez **Enregistrer les modifications**.
Vous avez créé un rôle IAM qui permet d'accéder DataSync à votre manifeste dans l'autre compte. Spécifiez ce rôle lors de [la création](#manifest-creating-task) ou [du démarrage](#manifest-starting-task) de votre tâche.
## Spécifier votre manifeste lors de la création d'une tâche
Vous pouvez spécifier le manifeste que vous DataSync souhaitez utiliser lors de la création d'une tâche.
### Utilisation de la DataSync console
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, choisissez **Tâches**, puis sélectionnez **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. Pour **le contenu à analyser**, sélectionnez **Fichiers, objets et dossiers spécifiques**, puis sélectionnez **Utiliser un manifeste**.
1. Pour l'**URI S3**, choisissez votre manifeste hébergé sur un compartiment S3.
Vous pouvez également saisir l'URI (par exemple,`s3://bucket/prefix/my-manifest.csv`).
1. Pour **la version de l'objet**, choisissez la version du manifeste que vous DataSync souhaitez utiliser.
Par défaut, DataSync utilise la dernière version de l'objet.
1. Pour le **rôle d'accès au manifeste**, effectuez l'une des opérations suivantes :
+ Choisissez **Autogenerate** pour DataSync créer automatiquement un rôle IAM doté des autorisations requises pour accéder à votre manifeste dans son compartiment S3.
+ Choisissez un rôle IAM existant qui peut accéder à votre manifeste.
Pour de plus amples informations, veuillez consulter [Fournir DataSync l'accès à votre manifeste](#transferring-with-manifest-access).
1. Configurez les autres paramètres de tâche dont vous avez besoin, puis choisissez **Next**.
1. Choisissez **Créer tâche**.
### En utilisant le AWS CLI
1. Copiez la `create-task` commande suivante :
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. Pour le `--source-location-arn` paramètre, spécifiez l'Amazon Resource Name (ARN) de l'emplacement à partir duquel vous transférez les données.
1. Pour le `--destination-location-arn` paramètre, spécifiez l'ARN de l'emplacement vers lequel vous transférez les données.
1. Pour le `--manifest-config` paramètre, procédez comme suit :
+ `ManifestObjectPath`— Spécifiez la clé d'objet S3 de votre manifeste.
+ `BucketAccessRoleArn`— Spécifiez le rôle IAM qui permet d'accéder DataSync à votre manifeste dans son compartiment S3.
Pour de plus amples informations, veuillez consulter [Fournir DataSync l'accès à votre manifeste](#transferring-with-manifest-access).
+ `S3BucketArn`— Spécifiez l'ARN du compartiment S3 qui héberge votre manifeste.
+ `ManifestObjectVersionId`— Spécifiez la version du manifeste que vous DataSync souhaitez utiliser.
Par défaut, DataSync utilise la dernière version de l'objet.
1. Exécutez la `create-task` commande pour créer votre tâche.
Lorsque vous êtes prêt, vous pouvez [commencer votre tâche de transfert](run-task.md).
## Spécifier votre manifeste lors du démarrage d'une tâche
Vous pouvez spécifier le manifeste que vous DataSync souhaitez utiliser lors de l'exécution d'une tâche.
### Utilisation de la DataSync console
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, choisissez **Tâches**, puis choisissez la tâche que vous souhaitez démarrer.
1. Sur la page d'aperçu des tâches, choisissez **Démarrer**, puis sélectionnez **Démarrer avec des options de remplacement**.
1. Pour **le contenu à analyser**, sélectionnez **Fichiers, objets et dossiers spécifiques**, puis sélectionnez **Utiliser un manifeste**.
1. Pour l'**URI S3**, choisissez votre manifeste hébergé sur un compartiment S3.
Vous pouvez également saisir l'URI (par exemple,`s3://bucket/prefix/my-manifest.csv`).
1. Pour **la version de l'objet**, choisissez la version du manifeste que vous DataSync souhaitez utiliser.
Par défaut, DataSync utilise la dernière version de l'objet.
1. Pour le **rôle d'accès au manifeste**, effectuez l'une des opérations suivantes :
+ Choisissez **Autogenerate** pour DataSync créer automatiquement un rôle IAM afin d'accéder à votre manifeste dans son compartiment S3.
+ Choisissez un rôle IAM existant qui peut accéder à votre manifeste.
Pour de plus amples informations, veuillez consulter [Fournir DataSync l'accès à votre manifeste](#transferring-with-manifest-access).
1. Choisissez **Démarrer** pour commencer votre transfert.
### En utilisant le AWS CLI
1. Copiez la `start-task-execution` commande suivante :
```
aws datasync start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. Pour le `--task-arn` paramètre, spécifiez l'Amazon Resource Name (ARN) de la tâche que vous lancez.
1. Pour le `--manifest-config` paramètre, procédez comme suit :
+ `ManifestObjectPath`— Spécifiez la clé d'objet S3 de votre manifeste.
+ `BucketAccessRoleArn`— Spécifiez le rôle IAM qui permet d'accéder DataSync à votre manifeste dans son compartiment S3.
Pour de plus amples informations, veuillez consulter [Fournir DataSync l'accès à votre manifeste](#transferring-with-manifest-access).
+ `S3BucketArn`— Spécifiez l'ARN du compartiment S3 qui héberge votre manifeste.
+ `ManifestObjectVersionId`— Spécifiez la version du manifeste que vous DataSync souhaitez utiliser.
Par défaut, DataSync utilise la dernière version de l'objet.
1. Exécutez la `start-task-execution` commande pour commencer le transfert.
## Limitations
+ Vous ne pouvez pas utiliser un manifeste avec des [filtres](filtering.md).
+ Vous ne pouvez pas spécifier uniquement un répertoire ou un dossier dans le but de transférer tout son contenu. Dans ces situations, pensez à utiliser un [filtre d'inclusion](filtering.md) au lieu d'un manifeste.
+ Vous ne pouvez pas utiliser l'option de tâche **Conserver les fichiers supprimés** (`PreserveDeletedFiles`dans l'[API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)) pour [conserver des fichiers ou des objets dans la destination qui ne figurent pas dans la source](configure-metadata.md). DataSync transfère uniquement ce qui est répertorié dans votre manifeste et ne supprime rien dans la destination.
## Résolution des problèmes
**Erreurs liées à `HeadObject` ou `GetObjectTagging`**
Si vous transférez des objets dotés d'une version spécifique IDs depuis un compartiment S3, il se peut qu'une erreur liée à `HeadObject` ou s'affiche`GetObjectTagging`. Par exemple, voici une erreur liée à `GetObjectTagging` :
```
[WARN] Failed to read metadata for file /picture1.png (versionId: 111111): S3 Get Object Tagging Failed
[ERROR] S3 Exception: op=GetObjectTagging photos/picture1.png, code=403, type=15, exception=AccessDenied,
msg=Access Denied req-hdrs: content-type=application/xml, x-amz-api-version=2006-03-01 rsp-hdrs: content-type=application/xml,
date=Wed, 07 Feb 2024 20:16:14 GMT, server=AmazonS3, transfer-encoding=chunked,
x-amz-id-2=IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km, x-amz-request-id=79104EXAMPLEB723
```
Si l'une de ces erreurs s'affiche, vérifiez que le rôle IAM DataSync utilisé pour accéder à votre emplacement source S3 dispose des autorisations suivantes :
+ `s3:GetObjectVersion`
+ `s3:GetObjectVersionTagging`
Si vous devez mettre à jour votre rôle avec ces autorisations, consultez[Création d'un rôle IAM pour accéder DataSync à votre position Amazon S3](create-s3-location.md#create-role-manually).
**Erreur: `ManifestFileDoesNotExist`**
Cette erreur indique qu'aucun fichier du manifeste n'a été trouvé à la source. Consultez les [instructions relatives](#transferring-with-manifest-guidelines) à la création d'un manifeste.
## Étapes suivantes
Si ce n'est pas déjà fait, [commencez votre tâche](run-task.md). Sinon, [surveillez l'activité de votre tâche](monitoring-overview.md).
# Transfert de fichiers, d'objets et de dossiers spécifiques à l'aide de filtres
AWS DataSync vous permet d'appliquer des filtres pour inclure ou exclure des données de votre emplacement source lors d'un transfert. Par exemple, si vous ne souhaitez pas transférer des fichiers temporaires se terminant par`.tmp`, vous pouvez créer un filtre d'exclusion afin que ces fichiers ne soient pas acheminés vers votre emplacement de destination.
Vous pouvez utiliser une combinaison de filtres d'exclusion et d'inclusion dans la même tâche de transfert. Si vous modifiez les filtres d'une tâche, ces modifications seront appliquées lors de la prochaine exécution de la tâche.
## Termes, définitions et syntaxe de filtrage
Familiarisez-vous avec les concepts liés au DataSync filtrage :
**Filtre **
La chaîne complète qui constitue un filtre particulier (par exemple, `*.tmp` `|` `*.temp` ou`/folderA|/folderB`).
Les filtres sont constitués de motifs délimités à l'aide d'un tube (\$1). Vous n'avez pas besoin de délimiteur lorsque vous ajoutez des modèles dans la DataSync console, car vous ajoutez chaque modèle séparément.
Les filtres font la distinction majuscules/minuscules. Par exemple, le filtre `/folderA` ne correspondra pas`/FolderA`.
**Modèle**
Modèle interne à un filtre. Par exemple, `*.tmp` il s'agit d'un motif qui fait partie du `*.tmp` `|` `*.temp` filtre. Si votre filtre comporte plusieurs modèles, vous délimitez chaque motif à l'aide d'un tube (\$1).
**Dossiers**
+ Tous les filtres se rapportent au chemin de l'emplacement source. Supposons, par exemple, que vous spécifiez `/my_source/` comme chemin source lorsque vous créez votre emplacement source et votre tâche et que vous spécifiez le filtre d'inclusion`/transfer_this/`. Dans ce cas, DataSync transfère uniquement le répertoire `/my_source/transfer_this/` et son contenu.
+ Pour spécifier un dossier directement sous l'emplacement source, insérez une barre oblique (/) devant le nom du dossier. Dans l'exemple précédent, le modèle utilise `/transfer_this` et non pas `transfer_this`.
+ DataSync interprète les modèles suivants de la même manière et fait correspondre à la fois le dossier et son contenu.
`/dir`
`/dir/`
+ Lorsque vous transférez des données depuis ou vers un compartiment Amazon S3, DataSync traitez le `/` caractère de la clé d'objet comme l'équivalent d'un dossier dans un système de fichiers.
**Caractères spéciaux**
Les caractères spéciaux à utiliser avec le filtrage sont les suivants.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/filtering.html)
## Exemples de filtres
Les exemples suivants montrent les filtres courants que vous pouvez utiliser DataSync.
**Note**
Le nombre de caractères que vous pouvez utiliser dans un filtre est limité. Pour de plus amples informations, veuillez consulter [DataSync quotas](datasync-limits.md#task-hard-limits).
**Exclusion de certains dossiers de votre emplacement source**
Dans certains cas, vous souhaiterez peut-être exclure des dossiers de votre emplacement source afin de ne pas les copier vers votre emplacement de destination. Par exemple, si vous avez work-in-progress des dossiers temporaires, vous pouvez utiliser le filtre suivant :
`*/.temp`
Pour exclure des dossiers présentant un contenu similaire (tel que `/reports2021` et`/reports2022)`), vous pouvez utiliser un filtre d'exclusion tel que le suivant :
`/reports*`
Pour exclure des dossiers à n'importe quel niveau de la hiérarchie des fichiers, vous pouvez utiliser un filtre d'exclusion comme celui-ci.
`*/folder-to-exclude-1`\$1`*/folder-to-exclude-2`
Pour exclure des dossiers situés au niveau supérieur de l'emplacement source, vous pouvez utiliser un filtre d'exclusion tel que le suivant.
`/top-level-folder-to-exclude-1`\$1`/top-level-folder-to-exclude-2`
**Inclure un sous-ensemble de dossiers sur votre emplacement source**
Dans certains cas, votre emplacement source peut être une part importante et vous devez transférer un sous-ensemble des dossiers sous la racine. Pour inclure des dossiers spécifiques, démarrez une exécution de tâche avec un filtre d'inclusion similaire au suivant.
`/folder-to-transfer/*`
**Exclusion de types de fichiers spécifiques**
Pour exclure du transfert certains types de fichiers, vous pouvez créer une exécution de tâche avec un filtre d'exclusion tel que `*.temp`.
**Transférez les fichiers individuels que vous spécifiez**
Pour transférer une liste de fichiers individuels, lancez l'exécution d'une tâche avec un filtre d'inclusion tel que celui-ci : « `/folder/subfolder/file1.txt` \$1 `/folder/subfolder/file2.txt` \$1 `/folder/subfolder/file2.txt` »
## Création de filtres d'inclusion
Les filtres d'inclusion définissent les fichiers, les objets et les dossiers que vous DataSync souhaitez transférer. Vous pouvez configurer des filtres d'inclusion lorsque vous créez, modifiez ou démarrez une tâche.
DataSync analyse et transfère uniquement les fichiers et dossiers qui correspondent aux filtres d'inclusion. Par exemple, pour inclure un sous-ensemble de vos dossiers sources, vous pouvez spécifier `/important_folder_1` \$1`/important_folder_2`.
**Note**
Les filtres d'inclusion prennent en charge le caractère générique (\$1) uniquement en tant que caractère le plus à droite d'un modèle. Par exemple, `/documents*` \$1 `/code*` est pris en charge, mais ne l'`*.txt`est pas.
### Utilisation de la DataSync console
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, choisissez **Tâches**, puis sélectionnez **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. Pour **le contenu à scanner**, sélectionnez **Fichiers, objets et dossiers spécifiques**, puis sélectionnez **Utiliser des filtres**.
1. Pour **Includes**, entrez votre filtre (par exemple, `/important_folders` pour inclure un répertoire important), puis choisissez **Ajouter un modèle**.
1. Ajoutez d'autres filtres d'inclusion si nécessaire.
### À l'aide du AWS CLI
Lorsque vous utilisez le AWS CLI, vous devez utiliser des guillemets simples (`'`) autour du filtre et un \$1 (tube) comme séparateur si vous avez plusieurs filtres.
L'exemple suivant indique deux filtres d'inclusion `/important_folder1` et `/important_folder2` lors de l'exécution de la `create-task` commande.
```
aws datasync create-task
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2'
```
## Création de filtres d'exclusion
Les filtres d'exclusion définissent les fichiers, les objets et les dossiers de votre emplacement source que vous ne DataSync souhaitez pas transférer. Vous pouvez configurer ces filtres lorsque vous créez, modifiez ou démarrez une tâche.
**Topics**
+ [Données exclues par défaut](#directories-ignored-during-transfers)
### Données exclues par défaut
DataSync exclut automatiquement le transfert de certaines données :
+ `.snapshot`— DataSync ignore tout chemin se terminant par`.snapshot`, qui est généralement utilisé pour les point-in-time instantanés des fichiers ou des répertoires d'un système de stockage.
+ `/.aws-datasync`et `/.awssync` — DataSync crée ces dossiers dans votre région pour faciliter votre transfert.
+ `/.zfs`— Vous pouvez voir ce dossier avec Amazon FSx pour les emplacements OpenZFS.
### Utilisation de la DataSync console
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, choisissez **Tâches**, puis sélectionnez **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. Pour **Exclusions**, entrez votre filtre (par exemple, `*/temp` pour exclure des dossiers temporaires), puis choisissez **Ajouter un modèle**.
1. Ajoutez d'autres filtres d'exclusion selon vos besoins.
1. Si nécessaire, ajoutez des [filtres d'inclusion](#include-filters).
### À l'aide du AWS CLI
Lorsque vous utilisez le AWS CLI, vous devez utiliser des guillemets simples (`'`) autour du filtre et un \$1 (tube) comme séparateur si vous avez plusieurs filtres.
L'exemple suivant indique deux filtres d'exclusion `*/temp` et `*/tmp` lors de l'exécution de la `create-task` commande.
```
aws datasync create-task \
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp'
```
# Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets
AWS DataSync peut conserver les métadonnées de votre fichier ou de votre objet lors d'un transfert de données. La manière dont vos métadonnées sont copiées dépend des lieux de transfert et de l'utilisation de types de métadonnées similaires par ces emplacements.
## Métadonnées au niveau du système
En général, DataSync ne copie pas les métadonnées au niveau du système. Par exemple, lors du transfert depuis un serveur de fichiers SMB, les autorisations que vous avez configurées au niveau du système de fichiers ne sont pas copiées vers le système de stockage de destination.
Il y a des exceptions. Lors du transfert entre Amazon S3 et un autre stockage d'objets, copie DataSync certaines métadonnées d'[objets définies par le système](#metadata-copied-between-object-s3).
## Métadonnées copiées dans les transferts Amazon S3
Les tableaux suivants décrivent les métadonnées qui DataSync peuvent être copiées lorsqu'un transfert implique un emplacement Amazon S3.
**Topics**
+ [Vers Amazon S3](#metadata-copied-to-s3)
+ [Entre Amazon S3 et d'autres types de stockage d'objets](#metadata-copied-between-object-s3)
+ [Entre Amazon S3 et HDFS](#metadata-copied-between-hdfs-s3)
### Vers Amazon S3
| Lorsque vous copiez depuis l'un de ces emplacements | Vers cet endroit | DataSync peut copier |
| --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | Ce qui suit en tant que métadonnées utilisateur Amazon S3 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) Les métadonnées des fichiers stockées dans les métadonnées utilisateur d'Amazon S3 sont interopérables avec les partages NFS sur les passerelles de fichiers utilisant. AWS Storage Gateway Une passerelle de fichiers permet un accès à faible latence depuis les réseaux locaux aux données copiées sur Amazon S3 par. DataSync Ces métadonnées sont également interopérables avec FSx for Lustre. Lorsque DataSync des objets contenant ces métadonnées sont copiés vers un serveur NFS, les métadonnées du fichier sont restaurées. La restauration des métadonnées nécessite l'octroi d'autorisations élevées au serveur NFS. Pour de plus amples informations, veuillez consulter [Configuration des AWS DataSync transferts avec un serveur de fichiers NFS](create-nfs-location.md). |
### Entre Amazon S3 et d'autres types de stockage d'objets
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html)
### Entre Amazon S3 et HDFS
| Lors de la copie entre ces emplacements | DataSync peut copier |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | Ce qui suit en tant que métadonnées utilisateur Amazon S3 :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html)HDFS utilise des chaînes pour stocker la propriété des utilisateurs et des groupes de fichiers et de dossiers, plutôt que des identifiants numériques tels que et. UIDs GIDs |
## Métadonnées copiées lors de transferts NFS
Le tableau suivant décrit les métadonnées qui DataSync peuvent être copiées entre des emplacements utilisant le système de fichiers réseau (NFS).
| Lors de la copie entre ces emplacements | DataSync peut copier |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) |
## Métadonnées copiées dans les transferts SMB
Le tableau suivant décrit les métadonnées qui DataSync peuvent être copiées entre des emplacements utilisant le module SMB (Server Message Block).
| Lors de la copie entre ces emplacements | DataSync peut copier |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) |
## Métadonnées copiées dans d'autres scénarios de transfert
DataSync gère les métadonnées de la manière suivante lors de la copie entre ces systèmes de stockage (dont la plupart ont des structures de métadonnées différentes).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html)
## Comprendre quand et comment DataSync applique les métadonnées POSIX par défaut
DataSync applique les métadonnées POSIX par défaut dans les situations suivantes :
+ Lorsque les emplacements source et de destination de votre transfert n'ont pas de structures de métadonnées similaires
+ Lorsque les métadonnées sont absentes de l'emplacement source
Le tableau suivant décrit comment DataSync appliquer les métadonnées POSIX par défaut lors de ces types de transferts :
| Source | Destination | Autorisations de fichiers | Autorisations relatives aux dossiers | UID | GID |
| --- | --- | --- | --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | 0755 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
1 Dans les cas où les objets ne possèdent pas de métadonnées précédemment appliquées par DataSync.
# Liens et répertoires copiés par AWS DataSync
AWS DataSync gère les liens physiques, les liens symboliques et les répertoires différemment selon les emplacements de stockage concernés par votre transfert.
## Liens physiques
Voici comment DataSync gérer les liens physiques dans certains scénarios de transfert courants :
+ **Lors du transfert entre un serveur de fichiers NFS, FSx pour Lustre, pour OpenZFS, FSx FSx pour ONTAP (à l'aide de NFS) et Amazon EFS**, les liens physiques sont préservés.
+ **Lors du transfert vers Amazon S3**, chaque fichier sous-jacent référencé par un lien physique n'est transféré qu'une seule fois. Lors des transferts incrémentiels, des objets distincts sont créés dans votre compartiment S3. Si un lien dur est inchangé dans Amazon S3, il est correctement restauré lorsqu'il est transféré vers un serveur de fichiers NFS, FSx pour Lustre, pour OpenZFS, FSx pour ONTAP (à l'aide de NFS) ou FSx pour le système de fichiers Amazon EFS.
+ **Lors du transfert vers Microsoft Azure Blob Storage**, chaque fichier sous-jacent référencé par un lien physique n'est transféré qu'une seule fois. Lors des transferts incrémentiels, des objets distincts sont créés dans votre stockage de blob si la source contient de nouvelles références. Lors du transfert depuisAzure Blob Storage, DataSync transfère les liens physiques comme s'il s'agissait de fichiers individuels.
+ **Lors du transfert entre un serveur de fichiers SMB, un serveur FSx de fichiers Windows et FSx un serveur ONTAP (via SMB)**, les liens physiques ne sont pas pris en charge. Si DataSync vous rencontrez des liens durs dans ces situations, la tâche de transfert se termine avec une erreur. Pour en savoir plus, consultez vos CloudWatch journaux.
+ **Lors du transfert vers HDFS, les** liens physiques ne sont pas pris en charge. CloudWatch les journaux indiquent que ces liens ont été ignorés.
## Liens symboliques
Voici comment DataSync gérer les liens symboliques dans certains scénarios de transfert courants :
+ **Lors du transfert entre un serveur de fichiers NFS, FSx pour Lustre, pour OpenZFS, FSx FSx pour ONTAP (à l'aide de NFS) et Amazon EFS**, les liens symboliques sont préservés.
+ **Lors du transfert vers Amazon S3**, le chemin cible du lien est stocké dans l'objet Amazon S3. Le lien est correctement restauré lorsqu'il est transféré vers un serveur de fichiers NFS, FSx pour Lustre, pour OpenZFS, FSx pour ONTAP ou FSx pour le système de fichiers Amazon EFS.
+ **Lors du transfert versAzure Blob Storage, les** liens symboliques ne sont pas pris en charge. CloudWatch les journaux indiquent que ces liens ont été ignorés.
+ **Lors du transfert entre un serveur de fichiers SMB, FSx pour Windows File Server et FSx pour ONTAP (via SMB),** les liens symboliques ne sont pas pris en charge. DataSync ne transfère pas un lien symbolique lui-même mais un fichier référencé par le lien symbolique. Pour reconnaître les fichiers dupliqués et les dédupliquer à l'aide de liens symboliques, vous devez configurer la déduplication sur votre système de fichiers de destination.
+ **Lors du transfert vers HDFS, les** liens symboliques ne sont pas pris en charge. CloudWatch les journaux indiquent que ces liens ont été ignorés.
## Annuaires
En général, DataSync préserve les répertoires lors du transfert entre systèmes de stockage. Ce n'est pas le cas dans les situations suivantes :
+ **Lors du transfert vers Amazon S3**, les répertoires sont représentés sous forme d'objets vides dotés de préfixes et se terminant par une barre oblique ()`/`.
+ **Lors du transfert vers un espace de noms Azure Blob Storage sans espace de noms hiérarchique**, les répertoires n'existent pas. Ce qui ressemble à un répertoire n'est qu'une partie du nom d'un objet.
# Configuration du mode de gestion des fichiers, des objets et des métadonnées
Vous pouvez configurer le mode de AWS DataSync gestion de vos fichiers, objets et de leurs métadonnées associées lors du transfert d'un emplacement à un autre.
Par exemple, dans le cas de transferts récurrents, vous souhaiterez peut-être remplacer les fichiers de votre destination par des modifications apportées à la source afin de synchroniser les emplacements. Vous pouvez copier des propriétés telles que les autorisations POSIX pour les fichiers et les dossiers, les balises associées aux objets et les listes de contrôle d'accès (ACLs).
## Options du mode de transfert
Vous pouvez configurer si vous DataSync transférez uniquement les données (y compris les métadonnées) modifiées après une copie initiale ou toutes les données à chaque fois que vous exécutez la tâche. Si vous prévoyez des transferts récurrents, vous souhaiterez peut-être uniquement transférer les modifications apportées depuis l'exécution de votre tâche précédente.
| Option dans la console | Option dans l'API | Description |
| --- | --- | --- |
| **Transférez uniquement les données modifiées** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)réglé sur `CHANGED` | Après votre transfert complet initial, DataSync copie uniquement les données et les métadonnées qui diffèrent entre l'emplacement source et l'emplacement de destination. |
| **Transférez toutes les données** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)réglé sur `ALL` | DataSync copie tout le contenu de la source vers la destination sans comparer les différences entre les emplacements. |
## Options de gestion des fichiers et des objets
Vous pouvez contrôler certains aspects du DataSync traitement de vos fichiers ou objets dans l'emplacement de destination. Par exemple, DataSync vous pouvez supprimer des fichiers dans la destination qui ne figurent pas dans la source.
| Option dans la console | Option dans l'API | Description |
| --- | --- | --- |
| **Conserver les fichiers supprimés** | [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles) | Spécifie si DataSync des fichiers ou des objets qui n'existent pas dans la source sont conservés dans l'emplacement de destination. Si vous configurez votre tâche pour supprimer des objets de votre compartiment Amazon S3, des frais de durée de stockage minimale peuvent vous être facturés pour certaines classes de stockage. Pour plus d’informations, consultez [Considérations relatives à la classe de stockage lors des transferts Amazon S3](create-s3-location.md#using-storage-classes). Vous ne pouvez pas configurer votre tâche de manière à supprimer des données dans la destination et à [transférer toutes les données](#task-option-transfer-mode). Lorsque vous transférez toutes les données, DataSync il ne scanne pas votre position de destination et ne sait pas quoi supprimer. |
| **Remplacer des fichiers** | [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) | Spécifie si DataSync les données sont modifiées dans l'emplacement de destination lorsque les données source ou les métadonnées ont changé. Si vous ne configurez pas votre tâche pour remplacer les données, les données de destination ne sont pas remplacées, même si les données source sont différentes. Si votre tâche remplace des objets, des frais supplémentaires peuvent vous être facturés pour certaines classes de stockage (par exemple, pour la récupération ou la suppression anticipée). Pour plus d’informations, consultez [Considérations relatives à la classe de stockage lors des transferts Amazon S3](create-s3-location.md#using-storage-classes). |
## Options de gestion des métadonnées
DataSync peut conserver les métadonnées des fichiers et des objets lors d'un transfert. Les métadonnées DataSync pouvant être conservées dépendent des systèmes de stockage concernés et de l'utilisation par ces systèmes d'une structure de métadonnées similaire.
Avant de configurer votre tâche, assurez-vous de comprendre comment DataSync gère les [métadonnées et les](metadata-copied.md) [fichiers spéciaux](special-files-copied.md) lors du transfert entre votre emplacement source et votre emplacement de destination.
**Important**
DataSync prend en charge les transferts vers et depuis certains systèmes de stockage cloud tiers, tels que Google Cloud Storage et IBM Cloud Object Storage, qui gèrent les métadonnées du système d'une manière qui n'est pas totalement compatible avec S3. Pour ces transferts, DataSync essaie de copier des attributs de métadonnées tels que`ContentType`,`ContentEncoding`,`ContentLanguage`, et dans `CacheControl` la mesure du possible. Si le système de stockage de destination n'applique pas ces attributs, ils seront ignorés lors de la vérification des tâches.
| Option dans la console | Option dans l'API | Description |
| --- | --- | --- |
| **Propriété de copie** | [https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid) | Spécifie si les DataSync copies sont propriétaires des fichiers et dossiers POSIX, par exemple l'ID de groupe des propriétaires du fichier et l'ID utilisateur du propriétaire du fichier. |
| **Autorisations de copie** | [PosixPermissions](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PosixPermissions) | Spécifie si les autorisations POSIX pour les fichiers et les dossiers sont DataSync copiées de la source vers la destination. |
| Copier les horodatages | [https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime) | Spécifie si les métadonnées d'horodatage sont DataSync copiées de la source vers la destination. Obligatoire lorsque vous devez exécuter une tâche plusieurs fois. |
| Copier les balises d'objets | [ObjectTags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-ObjectTags) | Spécifie si les balises associées à vos objets sont DataSync préservées lors du transfert entre systèmes de stockage d'objets. |
| Propriété de copie DACLs, et SACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)réglé sur OWNER\$1DACL\$1SACL | DataSync copie ce qui suit : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/configure-metadata.html) |
| Propriété de copie et DACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)réglé sur OWNER\$1DACL | DataSync copie ce qui suit : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/configure-metadata.html) DataSync ne sera pas SACLs copié lorsque vous choisissez cette option. |
| Ne copiez pas la propriété ou ACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)réglé sur NONE | DataSync ne copie aucune donnée de propriété ou d'autorisation. Les objets qui DataSync écrivent sur votre emplacement de destination appartiennent à l'utilisateur dont les informations d'identification sont fournies pour accéder DataSync à la destination. Les autorisations des objets de destination sont déterminées en fonction des autorisations configurées sur le serveur de destination. |
## Configuration des options de gestion des fichiers, des objets et des métadonnées
Vous pouvez configurer le mode de DataSync gestion des fichiers, des objets et des métadonnées lors de la création, de la modification ou du démarrage de votre tâche de transfert.
### Utilisation de la DataSync console
Les instructions suivantes décrivent comment configurer les options de gestion des fichiers, des objets et des métadonnées lors de la création d'une tâche.
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. Pour **le mode de transfert**, choisissez l'une des options suivantes :
+ **Transférez uniquement les données modifiées**
+ **Transférez toutes les données**
Pour plus d’informations sur ces options, consultez [Options du mode de transfert](#task-option-transfer-mode).
1. Sélectionnez **Conserver les fichiers supprimés** si vous DataSync souhaitez conserver des fichiers ou des objets dans l'emplacement de destination qui n'existent pas dans la source.
Si vous ne choisissez pas cette option et que votre tâche supprime des objets de votre compartiment Amazon S3, des frais de durée de stockage minimale peuvent vous être facturés pour certaines classes de stockage. Pour plus d’informations, consultez [Considérations relatives à la classe de stockage lors des transferts Amazon S3](create-s3-location.md#using-storage-classes).
**Avertissement**
Vous ne pouvez pas désélectionner cette option et activer **Transférer toutes les données**. Lorsque vous transférez toutes les données, DataSync il ne scanne pas votre position de destination et ne sait pas quoi supprimer.
1. Sélectionnez **Remplacer les fichiers** si vous DataSync souhaitez modifier les données dans l'emplacement de destination lorsque les données source ou les métadonnées ont changé.
Si votre tâche remplace des objets, des frais supplémentaires peuvent vous être facturés pour certaines classes de stockage (par exemple, pour la récupération ou la suppression anticipée). Pour plus d’informations, consultez [Considérations relatives à la classe de stockage lors des transferts Amazon S3](create-s3-location.md#using-storage-classes).
Si vous ne sélectionnez pas cette option, les données de destination ne sont pas remplacées même si les données source sont différentes.
1. Sous **Options de transfert**, sélectionnez la manière dont vous DataSync souhaitez gérer les métadonnées. Pour plus d’informations sur ces options, consultez [Options de gestion des métadonnées](#task-option-metadata-handling).
**Important**
Les options affichées dans la console dépendent de l'emplacement source et de destination de votre tâche. Vous devrez peut-être développer **les paramètres supplémentaires** pour voir certaines de ces options.
+ **Propriété de copie**
+ **Autorisations de copie**
+ **Copier les horodatages**
+ **Copier les balises d'objets**
+ **Propriété de copie DACLs, et SACLs**
+ **Propriété de copie et DACLs**
+ **Ne copiez pas la propriété ou ACLs**
### Utilisation de l' DataSync API
Vous pouvez configurer les options de gestion des fichiers, des objets et des métadonnées en utilisant le `Options` paramètre avec l'une des opérations suivantes :
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
# Configuration du mode de AWS DataSync vérification de l'intégrité des données
Lors d'un transfert, AWS DataSync utilise la vérification par somme de contrôle pour vérifier l'intégrité des données que vous copiez entre les sites. Vous pouvez également configurer DataSync pour effectuer une vérification supplémentaire à la fin de votre transfert.
## Options de vérification des données
Utilisez les informations suivantes pour vous aider à décider si et comment vous DataSync souhaitez effectuer ces vérifications supplémentaires.
| Option console | Option d'API | Description |
| --- | --- | --- |
| **Vérifier uniquement les données transférées** (recommandé) | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)réglé sur `ONLY_FILES_TRANSFERRED` | DataSync calcule la somme de contrôle des données transférées (y compris les métadonnées) à l'emplacement source. À la fin de votre transfert, DataSync comparez cette somme de contrôle à la somme de contrôle calculée sur ces mêmes données à destination. Nous recommandons cette option lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour de plus amples informations, veuillez consulter [Considérations relatives à la classe de stockage lors des transferts Amazon S3](create-s3-location.md#using-storage-classes). |
| **Vérifiez toutes les données** | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)réglé sur `POINT_IN_TIME_CONSISTENT` | À la fin de votre transfert, DataSync vérifie l'intégralité de la source et de la destination pour vérifier que les deux emplacements sont parfaitement synchronisés. Non pris en charge lorsque votre tâche utilise [le mode amélioré](choosing-task-mode.md). Si vous utilisez un [manifeste](transferring-with-manifest.md), il analyse et vérifie DataSync uniquement ce qui est répertorié dans le manifeste. Vous ne pouvez pas utiliser cette option lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour de plus amples informations, veuillez consulter [Considérations relatives à la classe de stockage lors des transferts Amazon S3](create-s3-location.md#using-storage-classes). |
| Ne pas vérifier les données après le transfert | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)réglé sur `NONE` | DataSync effectue des contrôles d'intégrité des données uniquement pendant votre transfert. Contrairement aux autres options, il n'y a aucune vérification supplémentaire à la fin de votre transfert. |
## Configuration de la vérification des données
Vous pouvez configurer les options de vérification des données lors de la création d'une tâche, de sa mise à jour ou du lancement de son exécution.
### Utilisation de la DataSync console
Les instructions suivantes décrivent comment configurer les options de vérification des données lors de la création d'une tâche.
**Pour configurer la vérification des données à l'aide de la console**
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. Pour la **vérification**, choisissez l'une des options suivantes :
+ **Vérifier uniquement les données transférées** (recommandé)
+ **Vérifiez toutes les données**
+ **Ne pas vérifier les données après le transfert**
### Utilisation de l' DataSync API
Vous pouvez configurer le mode de DataSync vérification des données en utilisant le `VerifyMode` paramètre avec l'une des opérations suivantes :
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
# Définition des limites de bande passante pour votre AWS DataSync tâche
Vous pouvez configurer les limites de bande passante réseau pour votre AWS DataSync tâche et chacune de ses exécutions.
## Limiter la bande passante pour une tâche
Définissez une limite de bande passante lors de la création, de la modification ou du démarrage d'une tâche.
### Utilisation de la DataSync console
Les instructions suivantes décrivent comment configurer une limite de bande passante pour votre tâche lorsque vous la créez.
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. Pour **Limite de bande passante**, choisissez l'une des options suivantes :
+ Sélectionnez **Utiliser disponible** pour utiliser toute la bande passante réseau disponible pour chaque exécution de tâche.
+ Sélectionnez **Définir la limite de bande passante (Mbits/s)** et entrez la bande passante maximale que vous souhaitez utiliser DataSync pour chaque exécution de tâche.
### Utilisation de l' DataSync API
Vous pouvez configurer la limite de bande passante d'une tâche en utilisant le `BytesPerSecond` paramètre avec l'une des opérations suivantes :
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
## Limitation de la bande passante pour l'exécution d'une tâche
Vous pouvez modifier la limite de bande passante pour l'exécution d'une tâche en cours ou en file d'attente.
### Utilisation de la DataSync console
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, développez **Transfert de données**, puis choisissez **Tâches**.
1. Choisissez la tâche, puis sélectionnez **Historique** pour afficher les exécutions de la tâche.
1. Choisissez l'exécution de la tâche que vous souhaitez modifier, puis sélectionnez **Modifier**.
1. Dans la boîte de dialogue, sélectionnez l'une des options suivantes :
+ Sélectionnez **Utiliser disponible** pour utiliser toute la bande passante réseau disponible pour l'exécution de la tâche.
+ Sélectionnez **Définir la limite de bande passante (Mbits/s)** et entrez la bande passante maximale que vous souhaitez utiliser DataSync pour l'exécution de la tâche.
1. Sélectionnez **Enregistrer les modifications**.
La nouvelle limite de bande passante prend effet dans les 60 secondes.
### Utilisation de l' DataSync API
Vous pouvez modifier la limite de bande passante pour l'exécution d'une tâche en cours ou en file d'attente en utilisant le `BytesPerSecond` paramètre avec l'[UpdateTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTaskExecution.html)opération.
# Planification de l'exécution de votre AWS DataSync tâche
Vous pouvez configurer un calendrier des AWS DataSync tâches pour transférer régulièrement des données entre les emplacements de stockage.
## Comment fonctionne DataSync la planification des tâches
Une DataSync tâche planifiée s'exécute à la fréquence que vous spécifiez, avec un intervalle minimum d'une heure. Vous pouvez créer un planning de tâches à l'aide d'un cron ou d'expressions de taux.
**Important**
Vous ne pouvez pas planifier l'exécution d'une tâche à un intervalle inférieur à 1 heure.
**Utilisation d'expressions cron**
Utilisez des expressions cron pour les plannings de tâches exécutés à une heure et à un jour spécifiques. Par exemple, voici comment configurer un calendrier de tâches dans le AWS CLI qui s'exécute à 12 h 00 UTC tous les dimanches et mercredis.
```
cron(0 12 ? * SUN,WED *)
```
**Utilisation d'expressions de taux**
Utilisez des expressions de taux pour les planifications de tâches exécutées à intervalles réguliers, par exemple toutes les 12 heures. Par exemple, voici comment configurer un calendrier de tâches AWS CLI qui s'exécute toutes les 12 heures :
```
rate(12 hours)
```
**Astuce**
Pour plus d'informations sur la syntaxe des expressions cron et rate, consultez le [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html).
## Création d'un calendrier de DataSync tâches
Vous pouvez planifier la fréquence d'exécution de votre tâche à l'aide de la DataSync console ou de DataSync l'API. AWS CLI
### Utilisation de la DataSync console
Les instructions suivantes décrivent comment configurer un planning lors de la création d'une tâche. Vous pouvez modifier le planning ultérieurement lors de la modification de la tâche.
Dans la console, certaines options de planification vous permettent de spécifier l'heure exacte d'exécution de votre tâche (par exemple, tous les jours à 22 h 30). Si vous n'indiquez pas d'heure pour ces options, votre tâche s'exécute au moment où vous la créez (ou mettez à jour) la tâche.
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 plus d’informations, consultez [Où puis-je transférer mes données AWS DataSync ?](working-with-locations.md).
1. Pour planifier **la fréquence**, effectuez l'une des opérations suivantes :
+ Choisissez **Non planifié** si vous ne souhaitez pas que votre tâche soit exécutée selon un calendrier.
+ Choisissez **Horaire**, puis choisissez la minute pendant l'heure pendant laquelle vous souhaitez que votre tâche soit exécutée.
+ Choisissez **Quotidien** et entrez l'heure UTC à laquelle vous souhaitez que votre tâche soit exécutée.
+ Choisissez **Hebdomadaire** et le jour de la semaine, puis entrez l'heure UTC à laquelle vous souhaitez que la tâche s'exécute.
+ Choisissez **Jours de la semaine**, choisissez un ou plusieurs jours spécifiques et entrez l'heure UTC à laquelle la tâche doit être exécutée au format HH:MM.
+ Choisissez **Personnalisé**, puis sélectionnez Expression **Cron ou Expression** **Rate**. Entrez votre calendrier de tâches avec un intervalle minimum d'une heure.
### À l'aide du AWS CLI
Vous pouvez créer un calendrier pour votre DataSync tâche en utilisant le `--schedule` paramètre avec la `start-task-execution` commande `create-task``update-task`, ou.
Les instructions suivantes décrivent comment procéder à l'aide de la `create-task` commande.
1. Copiez la `create-task` commande suivante :
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)"
}'
```
1. Pour le `--source-location-arn` paramètre, spécifiez l'Amazon Resource Name (ARN) de l'emplacement à partir duquel vous transférez les données.
1. Pour le `--destination-location-arn` paramètre, spécifiez l'ARN de l'emplacement vers lequel vous transférez les données.
1. Pour le `--schedule` paramètre, spécifiez une expression cron ou rate pour votre planning.
Dans l'exemple, l'expression cron `cron(0 12 ? * SUN,WED *)` définit un calendrier de tâches qui s'exécute à 12 h 00 UTC tous les dimanches et mercredis.
1. Exécutez la `create-task` commande pour créer votre tâche avec le planning.
## Suspension d'un calendrier de DataSync tâches
Il peut arriver que vous deviez suspendre votre planification des DataSync tâches. Par exemple, il se peut que vous deviez désactiver temporairement un transfert récurrent pour résoudre un problème lié à votre tâche ou effectuer des opérations de maintenance sur votre système de stockage.
DataSync peut désactiver automatiquement votre planification des tâches pour les raisons suivantes :
+ Votre tâche échoue à plusieurs reprises avec la même erreur.
+ Vous [désactivez un Région AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) utilisateur utilisé par votre tâche.
### Utilisation de la DataSync console
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 pour laquelle vous souhaitez suspendre le planning, puis choisissez **Modifier**.
1. Pour **Planifier**, désactivez **Activer le calendrier**. Sélectionnez **Enregistrer les modifications**.
### À l'aide du AWS CLI
1. Copiez la `update-task` commande suivante :
```
aws datasync update-task \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED"
}'
```
1. Pour le `--task-arn` paramètre, spécifiez l'ARN de la tâche pour laquelle vous souhaitez suspendre le planning.
1. Pour le `--schedule` paramètre, procédez comme suit :
+ Pour`ScheduleExpression`, spécifiez un cron ou une expression de taux pour votre calendrier.
Dans l'exemple, l'expression `cron(0 12 ? * SUN,WED *)` définit un calendrier de tâches qui s'exécute à 12 h 00 UTC tous les dimanches et mercredis.
+ Pour`Status`, spécifiez `DISABLED` de suspendre le calendrier des tâches.
1. Exécutez la commande `update-task`.
1. Pour reprendre le planning, exécutez la même `update-task` commande avec `Status` set to`ENABLED`.
## Vérifier l'état d'un planning de DataSync tâches
Vous pouvez voir si votre calendrier de DataSync tâches est activé.
### Utilisation de la DataSync console
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. Dans la colonne **Planification**, vérifiez si le calendrier de la tâche est activé ou désactivé.
### À l'aide du AWS CLI
1. Copiez la `describe-task` commande suivante :
```
aws datasync describe-task \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Pour le `--task-arn` paramètre, spécifiez l'ARN de la tâche sur laquelle vous souhaitez obtenir des informations.
1. Exécutez la commande `describe-task`.
Vous obtenez une réponse qui fournit des détails sur votre tâche, y compris son calendrier. (L'exemple suivant se concentre principalement sur la configuration du planning des tâches et ne montre pas de `describe-task` réponse complète.)
L'exemple montre que le planning de la tâche est désactivé manuellement. Si la planification est désactivée par le DataSync `SERVICE`, un message d'erreur s'affiche pour vous aider `DisabledReason` à comprendre pourquoi la tâche continue d'échouer. Pour de plus amples informations, veuillez consulter [AWS DataSync Problèmes de résolution des problèmes](troubleshooting-datasync.md).
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh",
"Status": "AVAILABLE",
"Schedule": {
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED",
"StatusUpdateTime": 1697736000,
"DisabledBy": "USER",
"DisabledReason": "Manually disabled by user."
},
...
}
```
# Marquer vos tâches AWS DataSync
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
Vous ne pouvez étiqueter votre DataSync tâche que lors de sa création.
### Utilisation de la DataSync console
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
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
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
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
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.