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
Questa operazione restituisce un elenco di lavori di ricerca appartenenti a un account.
Sintassi della richiesta
GET /search-jobs?MaxResults=MaxResults
&NextToken=NextToken
&Status=ByStatus
HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- ByStatus
-
Includi questo parametro per filtrare l'elenco in base allo stato del lavoro di ricerca.
Valori validi:
RUNNING | COMPLETED | STOPPING | STOPPED | FAILED
- MaxResults
-
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
- NextToken
-
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
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
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
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- NextToken
-
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: stringa
- SearchJobs
-
I lavori di ricerca presenti nell'elenco, con i dettagli dei lavori di ricerca restituiti.
Tipo: matrice di oggetti SearchJobSummary
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- 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 alcuni 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
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: