Filtres API pour ListTasks ListLocations

AWS DataSync prend en charge les filtres en tant qu'arguments d'entrée duListTasksetListLocationsAppels d'API. Cela vous permet de récupérer les configurations des tâches de transfert de données à l'aide de filtres tels que la source ou la destination du transfert de données.

Paramètres pour le filtrage des API

Vous pouvez utiliser les filtres d'API pour affiner la liste des ressources renvoyées parListTasksetListLocations. Par exemple, pour récupérer tous vos emplacements Amazon S3, vous pouvez utiliserListLocationsavec le nom de filtreLocationType S3etOperator Equals.

Pour filtrer les résultats de l'API, vous devez spécifier un nom de filtre, un opérateur et une valeur.

• Name— Le nom du filtre utilisé. Chaque appel d'API prend en charge une liste de filtres disponibles pour lui (par exemple,LocationTypepourListLocations).

• Values— Les valeurs pour lesquelles vous souhaitez filtrer. Par exemple, vous pouvez avoir l'intention d'afficher uniquement les emplacements Amazon S3.

• Operator— Opérateur utilisé pour comparer les valeurs de filtre (par exemple,EqualsouContains).

Le tableau suivant répertorie les opérateurs disponibles.

Opérateur	Principaux types
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

Filtrage des API pour ListLocations

ListLocationsprend en charge les noms de filtres suivants :

• LocationType— Filtre sur le type d'emplacement :SMB,NFS,HDFS,S3,FSXW,FSXL,FSXZ, etOBJECT_STORAGE.

• LocationUri— Filtre l'identificateur de ressource uniforme (URI) attribué à l'emplacement, tel que renvoyé par leDescribeLocation*Appel d'API (par exemple,s3://bucket-name/your-prefixpour les emplacements Amazon S3).

• CreationTime: filtre l'heure à laquelle l'emplacement a été créé. Le format d'entrée estyyyy-MM-dd:mm:ssen heure UTC (temps universel coordonné).

Procédez comme suit :AWS CLIexemple répertorie tous les emplacements de type Amazon S3 dont l'URI commence par la chaîne."s3://DOC-EXAMPLE-BUCKET"et qui ont été créés à partir du 2019-12-15 17h15 UTC.

aws datasync list-locations \
    --filters [{Name=LocationType, Values=["S3"], Operator=Equals}, {Name=LocationUri, Values=["s3://DOC-EXAMPLE-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://DOC-EXAMPLE-BUCKET-examples/"
        },
        {
            "LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-987654321abcdef0",
            "LocationUri": "s3://DOC-EXAMPLE-BUCKET-examples-2/"
        }
    ]
}

Filtrage des API pour ListTasks

ListTasksprend en charge les noms de filtres suivants.

• LocationId— Filtre à la fois les emplacements source et destination sur les valeurs Amazon Resource Name (ARN).

• CreationTime: filtre le moment où la tâche a été créée. Le format d'entrée estyyyy-MM-dd:mm:ssen UTC.

Procédez comme suit :AWS CLImontre la syntaxe lors du filtrage surLocationId.

aws datasync list-tasks \
    --filters Name=LocationId,Values=arn:aws:datasync:us-east-1:your-account-id:location/your-location-id,Operator=Contains

La sortie 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": "DOC-EXAMPLE-BUCKET"
        }
    ]
}