

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.

# Transfert de fichiers ou d'objets spécifiques à l'aide d'un manifeste
<a name="transferring-with-manifest"></a>

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
<a name="transferring-with-manifest-create"></a>

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
<a name="transferring-with-manifest-guidelines"></a>

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
<a name="manifest-examples"></a>

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
<a name="transferring-with-manifest-access"></a>

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
<a name="creating-manfiest-role-automatically"></a>

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)
<a name="creating-manfiest-role-automatically-same-account"></a>

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)
<a name="creating-manfiest-role-automatically-different-account"></a>

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
<a name="creating-manfiest-role-automatically-different-account-1"></a>

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
<a name="creating-manfiest-role-automatically-different-account-2"></a>

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
<a name="manifest-creating-task"></a>

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
<a name="manifest-creating-task-console"></a>

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

1. Dans le volet de navigation de gauche, 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
<a name="manifest-creating-task-cli"></a>

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
<a name="manifest-starting-task"></a>

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
<a name="manifest-starting-task-console"></a>

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

1. Dans le volet de navigation de gauche, 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
<a name="manifest-starting-task-cli"></a>

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
<a name="transferring-with-manifest-limitations"></a>
+ 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
<a name="manifests-troubleshooting"></a>

**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
<a name="manifests-next-steps"></a>

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