ListTasks - AWS DataSync
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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.

ListTasks

Renvoie la liste des AWS DataSync tâches que vous avez créées.

Syntaxe de la requête

{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

Cette demande accepte les données suivantes au format JSON.

Filters

Vous pouvez utiliser des filtres d'API pour affiner la liste des ressources renvoyées parListTasks. Par exemple, pour récupérer toutes les tâches d'un emplacement source spécifique, vous pouvez les utiliser ListTasks avec le nom du filtre LocationId et Operator Equals avec l'ARN de l'emplacement.

Type : tableau d’objets TaskFilter

Obligatoire : non

MaxResults

Le nombre maximum de tâches à renvoyer.

Type : entier

Plage valide : Valeur minimum de 0. Valeur maximale fixée à 100.

Obligatoire : non

NextToken

Chaîne opaque qui indique la position à partir de laquelle commencer la liste de tâches suivante.

Type : String

Contraintes de longueur : longueur maximale de 65535.

Modèle : [a-zA-Z0-9=_-]+

Obligatoire : non

Syntaxe de la réponse

{
   "NextToken": "string",
   "Tasks": [ 
      { 
         "Name": "string",
         "Status": "string",
         "TaskArn": "string",
         "TaskMode": "string"
      }
   ]
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

NextToken

Chaîne opaque qui indique la position à partir de laquelle commencer à renvoyer la liste de tâches suivante.

Type : String

Contraintes de longueur : longueur maximale de 65535.

Modèle : [a-zA-Z0-9=_-]+

Tasks

Liste de toutes les tâches renvoyées.

Type : tableau d’objets TaskListEntry

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

InternalException

Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service.

Code d’état HTTP : 500

InvalidRequestException

Cette exception est levée lorsque le client soumet une demande mal formée.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :