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, d'objets et de dossiers spécifiques à l'aide de filtres
<a name="filtering"></a>

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
<a name="filter-overview"></a>

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
<a name="sample-filters"></a>

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
<a name="include-filters"></a>

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
<a name="include-filters-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 à 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
<a name="include-filters-cli"></a>

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
<a name="exclude-filters"></a>

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
<a name="directories-ignored-during-transfers"></a>

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
<a name="adding-exclude-filters"></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 **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
<a name="adding-exclude-filters-cli"></a>

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'
```