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à.
StartSearchJob
Questa operazione crea un processo di ricerca che restituisce punti di ripristino filtrati per SearchScope e elementi filtrati per. ItemFilters
Puoi facoltativamente includere ClientToken,, Name EncryptionKeyArn, Tags. and/or
Sintassi della richiesta
PUT /search-jobs HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"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",
"SearchScope": {
"BackupResourceArns": [ "string" ],
"BackupResourceCreationTime": {
"CreatedAfter": number,
"CreatedBefore": number
},
"BackupResourceTags": {
"string" : "string"
},
"BackupResourceTypes": [ "string" ],
"SourceResourceArns": [ "string" ]
},
"Tags": {
"string" : "string"
}
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ClientToken
-
Includi questo parametro per consentire più chiamate identiche per l'idempotenza.
Un token client è valido per 8 ore dopo il completamento della prima richiesta che lo utilizza. Trascorso questo periodo, qualsiasi richiesta con lo stesso token viene trattata come una nuova richiesta.
▬Tipo: stringa
Campo obbligatorio: no
- EncryptionKeyArn
-
La chiave di crittografia per il processo di ricerca specificato.
▬Tipo: stringa
Campo obbligatorio: no
- ItemFilters
-
I filtri degli elementi rappresentano tutte le proprietà degli elementi di input specificate al momento della creazione della ricerca.
Contiene EBSItem filtri o S3 ItemFilters
Tipo: oggetto ItemFilters
Campo obbligatorio: no
- Name
-
Includi caratteri alfanumerici per creare un nome per questo lavoro di ricerca.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 500 caratteri.
Campo obbligatorio: no
- SearchScope
-
Questo oggetto può contenere BackupResourceTypes,, BackupResourceArns BackupResourceCreationTime BackupResourceTags, e SourceResourceArns filtrare i punti di ripristino restituiti dal processo di ricerca.
Tipo: oggetto SearchScope
Campo obbligatorio: sì
- Tags
-
Elenco dei tag restituiti dall'operazione.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"SearchJobArn": "string",
"SearchJobIdentifier": "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.
- CreationTime
-
Data e ora di creazione di un lavoro, 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
- SearchJobArn
-
La stringa univoca che identifica l'Amazon Resource Name (ARN) del processo di ricerca specificato.
▬Tipo: stringa
- SearchJobIdentifier
-
La stringa univoca che specifica il lavoro di ricerca.
▬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
- ConflictException
-
Questa eccezione si verifica quando viene rilevato un conflitto con una precedente operazione riuscita. Ciò si verifica in genere quando l'operazione precedente non ha avuto il tempo di propagarsi all'host che serve la richiesta corrente.
La risposta consigliata a questa eccezione è un nuovo tentativo (con una logica di backoff appropriata).
- message
-
L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.
- resourceId
-
Identificatore della risorsa interessata.
- resourceType
-
Tipo di risorsa interessata.
Codice di stato HTTP: 409
- 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
- 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
- ServiceQuotaExceededException
-
La richiesta è stata respinta a causa del superamento dei limiti di quota consentiti.
- message
-
Questa richiesta non ha avuto successo a causa del superamento dei limiti della quota di servizio.
- quotaCode
-
Questo è il codice specifico del tipo di quota.
- resourceId
-
Identificatore della risorsa.
- resourceType
-
Tipo di risorsa.
- serviceCode
-
Questo è il codice univoco del servizio di origine con la quota.
Codice di stato HTTP: 402
- 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:
