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.

# ListSearchJobs
<a name="API_BKS_ListSearchJobs"></a>

Cette opération renvoie une liste des tâches de recherche associées à un compte.

## Syntaxe de la demande
<a name="API_BKS_ListSearchJobs_RequestSyntax"></a>

```
GET /search-jobs?MaxResults=MaxResults&NextToken=NextToken&Status=ByStatus HTTP/1.1
```

## Paramètres de demande URI
<a name="API_BKS_ListSearchJobs_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [ByStatus](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-ByStatus"></a>
Incluez ce paramètre pour filtrer la liste en fonction du statut de la tâche de recherche.  
Valeurs valides : `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [MaxResults](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-MaxResults"></a>
Le nombre maximum d'éléments de la liste de ressources à renvoyer.  
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.

 ** [NextToken](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-NextToken"></a>
L'élément suivant une liste partielle des tâches de recherche renvoyées.  
Par exemple, si une demande est faite pour renvoyer le `MaxResults` nombre de sauvegardes, cela vous `NextToken` permet de renvoyer plus d'éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.

## Corps de la requête
<a name="API_BKS_ListSearchJobs_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_BKS_ListSearchJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SearchJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "Name": "string",
         "SearchJobArn": "string",
         "SearchJobIdentifier": "string",
         "SearchScopeSummary": { 
            "TotalItemsToScanCount": number,
            "TotalRecoveryPointsToScanCount": number
         },
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_BKS_ListSearchJobs_ResponseElements"></a>

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](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-NextToken"></a>
L'élément suivant une liste partielle des sauvegardes renvoyées incluses dans une tâche de recherche.  
Par exemple, si une demande est faite pour renvoyer le `MaxResults` nombre de sauvegardes, cela vous `NextToken` permet de renvoyer plus d'éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.  
Type : Chaîne

 ** [SearchJobs](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-SearchJobs"></a>
Les tâches de recherche figurant dans la liste, avec les détails des tâches de recherche renvoyées.  
Type : tableau d’objets [SearchJobSummary](API_BKS_SearchJobSummary.md)

## Erreurs
<a name="API_BKS_ListSearchJobs_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** AccessDeniedException **   
Vous ne disposez pas d’un accès suffisant pour effectuer cette action.    
 ** message **   
L'utilisateur ne dispose pas d'un accès suffisant pour effectuer cette action.
Code d’état HTTP : 403

 ** InternalServerException **   
Une erreur interne du serveur s’est produite. Réessayez votre demande.    
 ** message **   
Erreur inattendue lors du traitement de la demande.  
 ** retryAfterSeconds **   
Réessayez l'appel au bout de quelques secondes.
Code d’état HTTP : 500

 ** ThrottlingException **   
La demande a été refusée suite à une limitation des demandes.    
 ** message **   
La demande n'a pas abouti en raison d'une limitation des demandes.  
 ** quotaCode **   
Il s'agit du code propre au service d'origine avec le quota.  
 ** retryAfterSeconds **   
Réessayez l'appel au bout de quelques secondes.  
 ** serviceCode **   
Il s'agit du code propre au service d'origine.
Code d’état HTTP : 429

 ** ValidationException **   
L'entrée ne satisfait pas les contraintes spécifiées par un service.    
 ** message **   
L'entrée ne répond pas aux contraintes spécifiées par un service Amazon.
Code d’état HTTP : 400

## Voir aussi
<a name="API_BKS_ListSearchJobs_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobs)