Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Questa operazione restituisce un elenco di lavori di ricerca appartenenti a un account.

## Sintassi della richiesta
<a name="API_BKS_ListSearchJobs_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_BKS_ListSearchJobs_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByStatus](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-ByStatus"></a>
Includi questo parametro per filtrare l'elenco in base allo stato del lavoro di ricerca.  
Valori validi: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [MaxResults](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-MaxResults"></a>
Il numero massimo di elementi dell'elenco di risorse da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-NextToken"></a>
L'elemento successivo che segue un elenco parziale dei lavori di ricerca restituiti.  
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.

## Corpo della richiesta
<a name="API_BKS_ListSearchJobs_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
      }
   ]
}
```

## Elementi di risposta
<a name="API_BKS_ListSearchJobs_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [NextToken](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-NextToken"></a>
L'elemento successivo che segue un elenco parziale dei backup restituiti inclusi in un processo di ricerca.  
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.  
Tipo: String

 ** [SearchJobs](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-SearchJobs"></a>
I lavori di ricerca presenti nell'elenco, con i dettagli dei lavori di ricerca restituiti.  
Tipo: matrice di oggetti [SearchJobSummary](API_BKS_SearchJobSummary.md)

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.    
 ** message **   
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server. Invia di nuovo la richiesta.    
 ** message **   
Errore imprevisto durante l'elaborazione della richiesta.  
 ** retryAfterSeconds **   
Riprova la chiamata dopo un certo numero di secondi.
Codice di stato HTTP: 500

 ** ThrottlingException **   
La richiesta è stata negata a causa del throttling della richiesta.    
 ** message **   
La richiesta non è andata a buon fine a causa della limitazione della richiesta.  
 ** quotaCode **   
Questo è il codice univoco del servizio di origine con la quota.  
 ** retryAfterSeconds **   
Riprova la chiamata dopo alcuni secondi.  
 ** serviceCode **   
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429

 ** ValidationException **   
L'input non soddisfa i vincoli specificati da un servizio.    
 ** message **   
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400

## Vedi anche
<a name="API_BKS_ListSearchJobs_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobs)