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.
# Filtrer AWS DataSync les ressources
Vous pouvez filtrer vos AWS DataSync emplacements et vos tâches à l'aide des opérations `ListTasks` d'API `ListLocations` et du AWS CLI. Par exemple, récupérez la liste de vos tâches les plus récentes.
## Paramètres de filtrage
Vous pouvez utiliser les filtres d'API pour affiner la liste des ressources renvoyées par `ListTasks` et`ListLocations`. Par exemple, pour récupérer tous vos sites Amazon S3, vous pouvez utiliser `ListLocations` avec le nom du filtre `LocationType` *`S3`*et `Operator` *`Equals`*.
Pour filtrer les résultats de l'API, vous devez spécifier un nom, un opérateur et une valeur de filtre.
+ `Name`— Le nom du filtre utilisé. Chaque appel d'API prend en charge une liste de filtres disponibles pour celui-ci (par exemple, `LocationType` pour`ListLocations`).
+ `Values`— Les valeurs que vous souhaitez filtrer. Par exemple, vous souhaiterez peut-être afficher uniquement les emplacements Amazon S3.
+ `Operator`— L'opérateur utilisé pour comparer les valeurs des filtres (par exemple, `Equals` ou`Contains`).
Le tableau suivant répertorie les opérateurs disponibles.
| Opérateur | Types de clé |
| --- | --- |
| Equals | Chaîne, numéro |
| NotEquals | Chaîne, numéro |
| LessThan | Number |
| LessThanOrEqual | Number |
| GreaterThan | Number |
| GreaterThanOrEqual | Number |
| In | String |
| Contains | Chaîne |
| NotContains | Chaîne |
| BeginsWith | String |
## Filtrer par localisation
`ListLocations`prend en charge les noms de filtres suivants :
+ `LocationType`— Filtres selon le type de localisation :
+ `SMB`
+ `NFS`
+ `HDFS`
+ `OBJECT_STORAGE`
+ `S3`
+ `OUTPOST_S3`
+ `FSX_WINDOWS`
+ `FSX_LUSTRE`
+ `FSX_OPENZFS_NFS`
+ `FSX_ONTAP_NFS`
+ `FSX_ONTAP_SMB`
+ `LocationUri`— Filtres sur l'identifiant de ressource uniforme (URI) attribué à l'emplacement, tel que renvoyé par l'appel d'`DescribeLocation*`API (par exemple, `s3://bucket-name/your-prefix` pour les sites Amazon S3).
+ `CreationTime`— Filtre en fonction de l'heure à laquelle le lieu a été créé. Le format d'entrée est `yyyy-MM-dd:mm:ss` en temps universel coordonné (UTC).
L' AWS CLI exemple suivant répertorie tous les emplacements de type Amazon S3 dont l'URI commence par la chaîne `"s3://amzn-s3-demo-bucket"` et qui ont été créés le 15/12/2019 à 17:15:20 UTC ou après cette date.
```
aws datasync list-locations \
--filters [{Name=LocationType, Values=["S3"], Operator=Equals}, {Name=LocationUri, Values=["s3://amzn-s3-demo-bucket"], Operator=BeginsWith}, {Name=CreationTime,Values=["2019-12-15 17:15:20"],Operator=GreaterThanOrEqual}]
```
La sortie générée lors de l'exécution de cette commande est semblable à ce qui suit.
```
{
"Locations": [
{
"LocationArn": "arn:aws:datasync:us-east-1:111122223333:location/loc-333333333abcdef0",
"LocationUri": "s3://amzn-s3-demo-bucket1/"
},
{
"LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-987654321abcdef0",
"LocationUri": "s3://amzn-s3-demo-bucket2/"
}
]
}
```
## Filtrer par tâche
`ListTasks`prend en charge les noms de filtres suivants.
+ `LocationId`— Filtre à la fois les emplacements source et de destination en fonction des valeurs Amazon Resource Name (ARN).
+ `CreationTime`— Filtre en fonction de l'heure à laquelle la tâche a été créée. Le format d'entrée est `yyyy-MM-dd:mm:ss` en UTC.
L' AWS CLI exemple suivant montre la syntaxe lors du filtrage activé`LocationId`.
```
aws datasync list-tasks \
--filters Name=LocationId,Values=arn:aws:datasync:us-east-1:your-account-id:location/your-location-id,Operator=Contains
```
Le résultat de cette commande ressemble à ce qui suit.
```
{
"Tasks": [
{
"TaskArn": "arn:aws:datasync:us-east-1:your-account-id:task/your-task-id",
"Status": "AVAILABLE",
"Name": "amzn-s3-demo-bucket"
}
]
}
```