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.
# 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)