ListTasks - AWS DataSync
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir 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 une liste desAWS DataSync tâches que vous avez qui s'affichent.

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 communs à toutes les actions, voir Paramètres communs.

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

Filters

Vous pouvez utiliser des filtres d'API pour affiner la liste des ressources qui s'affichentListTasks. Par exemple, pour récupérer toutes les tâches sur un emplacement source spécifique, vous pouvez utiliserListTasks avec le nom du filtreLocationId etOperator 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 à laquelle commencer la liste de tâches suivante.

Type : String

Contraintes de longueur : Longueur maximum de 65535.

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

Obligatoire : non

Syntaxe de la réponse

{
   "NextToken": "string",
   "Tasks": [ 
      { 
         "Name": "string",
         "Status": "string",
         "TaskArn": "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 à laquelle commencer à renvoyer la liste de tâches suivante.

Type : String

Contraintes de longueur : Longueur maximum 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 communes à toutes les actions, consultezErreurs courantes.

InternalException

Cette exception est déclenchée lorsqu'une erreur se produit dans leAWS DataSync service.

Code d'état HTTP : 500

InvalidRequestException

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

Code d'état HTTP : 400

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :