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à.
GetSearchJob
Questa operazione recupera i metadati di un processo di ricerca, incluso lo stato di avanzamento.
Sintassi della richiesta
GET /search-jobs/SearchJobIdentifier HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- SearchJobIdentifier
-
Stringa univoca obbligatoria che specifica il processo di ricerca.
Campo obbligatorio: sì
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"CompletionTime": number,
"CreationTime": number,
"CurrentSearchProgress": {
"ItemsMatchedCount": number,
"ItemsScannedCount": number,
"RecoveryPointsScannedCount": number
},
"EncryptionKeyArn": "string",
"ItemFilters": {
"EBSItemFilters": [
{
"CreationTimes": [
{
"Operator": "string",
"Value": number
}
],
"FilePaths": [
{
"Operator": "string",
"Value": "string"
}
],
"LastModificationTimes": [
{
"Operator": "string",
"Value": number
}
],
"Sizes": [
{
"Operator": "string",
"Value": number
}
]
}
],
"S3ItemFilters": [
{
"CreationTimes": [
{
"Operator": "string",
"Value": number
}
],
"ETags": [
{
"Operator": "string",
"Value": "string"
}
],
"ObjectKeys": [
{
"Operator": "string",
"Value": "string"
}
],
"Sizes": [
{
"Operator": "string",
"Value": number
}
],
"VersionIds": [
{
"Operator": "string",
"Value": "string"
}
]
}
]
},
"Name": "string",
"SearchJobArn": "string",
"SearchJobIdentifier": "string",
"SearchScope": {
"BackupResourceArns": [ "string" ],
"BackupResourceCreationTime": {
"CreatedAfter": number,
"CreatedBefore": number
},
"BackupResourceTags": {
"string" : "string"
},
"BackupResourceTypes": [ "string" ],
"SourceResourceArns": [ "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.
- CompletionTime
-
Data e ora di completamento di un processo di ricerca, in formato Unix e UTC (Coordinated Universal Time). Il valore di
CompletionTimeè preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.Tipo: Timestamp
- CreationTime
-
Data e ora di creazione di un processo di ricerca, in formato Unix e Coordinated Universal Time (UTC). Il valore di
CompletionTimeè preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.Tipo: Timestamp
- CurrentSearchProgress
-
Restituisce numeri che rappresentano BackupsScannedCount ItemsScanned, e. ItemsMatched
Tipo: oggetto CurrentSearchProgress
- EncryptionKeyArn
-
La chiave di crittografia per il processo di ricerca specificato.
Esempio:
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.Tipo: stringa
- ItemFilters
-
I filtri degli elementi rappresentano tutte le proprietà degli elementi di input specificate al momento della creazione della ricerca.
Tipo: oggetto ItemFilters
- Name
-
Nome restituito del processo di ricerca specificato.
Tipo: stringa
- SearchJobArn
-
La stringa univoca che identifica l'Amazon Resource Name (ARN) del processo di ricerca specificato.
Tipo: stringa
- SearchJobIdentifier
-
La stringa univoca che identifica il lavoro di ricerca specificato.
Tipo: stringa
- SearchScope
-
L'ambito di ricerca è costituito da tutte le proprietà di backup inserite in una ricerca.
Tipo: oggetto SearchScope
- SearchScopeSummary
-
Viene restituito un riepilogo dell'ambito del lavoro di ricerca specificato, tra cui:
-
TotalBackupsToScanCount, il numero di punti di ripristino restituiti dalla ricerca.
-
TotalItemsToScanCount, il numero di elementi restituiti dalla ricerca.
Tipo: oggetto SearchScopeSummary
-
- Status
-
Lo stato corrente del processo di ricerca specificato.
Un lavoro di ricerca può avere uno dei seguenti stati:
RUNNING;;COMPLETED;STOPPED;FAILEDTIMED_OUT; oppureEXPIRED.Tipo: stringa
Valori validi:
RUNNING | COMPLETED | STOPPING | STOPPED | FAILED - StatusMessage
-
Verrà restituito un messaggio di stato per un lavoro di ricerca con stato di
ERROREDo per uno stato diCOMPLETEDlavori con problemi.Ad esempio, un messaggio può indicare che una ricerca conteneva punti di ripristino che non possono essere analizzati a causa di un problema di autorizzazioni.
Tipo: stringa
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 un certo numero di secondi.
Codice di stato HTTP: 500
- ResourceNotFoundException
-
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
- message
-
La richiesta fa riferimento a una risorsa che non esiste.
- resourceId
-
Identificatore ipotetico della risorsa interessata.
- resourceType
-
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
- 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:
