Filtrer AWS DataSync les ressources - AWS DataSync
Paramètres de filtrageFiltrer par localisationFiltrer par tâche

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 etListLocations. Par exemple, pour récupérer tous vos sites Amazon S3, vous pouvez utiliser ListLocations avec le nom du filtre LocationType S3et 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 pourListLocations).

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

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 Nombre
LessThanOrEqual Nombre
GreaterThan Nombre
GreaterThanOrEqual Nombre
In Chaîne
Contains Chaîne
NotContains Chaîne
BeginsWith Chaîne

Filtrer par localisation

ListLocationsprend 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

ListTasksprend 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"
        }
    ]
}