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à.
ListBackupJobSummaries
È la richiesta di riepilogo dei processi di backup creati o eseguiti negli ultimi 30 giorni. È possibile includere i parametri AccountID, State,, ResourceType, MessageCategory AggregationPeriod MaxResults, o NextToken per filtrare i risultati.
Questa richiesta restituisce un riepilogo che contiene Regione, Account ResourceType, Stato MessageCategory, StartTime, EndTime, e Numero di lavori inclusi.
Sintassi della richiesta
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
URIParametri della richiesta
La richiesta utilizza i seguenti URI parametri.
- AccountId
-
Restituisce il numero di processi per l'account specificato.
Se la richiesta viene inviata da un account membro o da un account che non fa parte di AWS Organizations, verranno restituiti i lavori all'interno dell'account del richiedente.
Gli account root, admin e amministratore delegato possono utilizzare il valore ANY per restituire il numero di job da ogni account dell'organizzazione.
AGGREGATE_ALLaggrega i numeri dei processi di tutti gli account dell'organizzazione autenticata, quindi restituisce la somma.Modello:
^[0-9]{12}$ - AggregationPeriod
-
Periodo per i risultati restituiti.
-
ONE_DAY- Il numero di lavori giornalieri per i 14 giorni precedenti. -
SEVEN_DAYS- Il numero aggregato dei lavori per i 7 giorni precedenti. -
FOURTEEN_DAYS- Il numero aggregato dei lavori per i 14 giorni precedenti.
Valori validi:
ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS -
- MaxResults
-
Il numero massimo di elementi da restituire.
Il valore è un numero intero. L'intervallo di valori validi è compreso tra 1 e 500.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
- MessageCategory
-
Questo parametro restituisce il numero di processi per la categoria di messaggi specificata.
Stringhe di esempio valide sono
AccessDenied,SuccesseInvalidParameters. Vedi Monitoraggio per un elenco delle MessageCategory stringhe accettate.Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
AGGREGATE_ALLaggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma. - NextToken
-
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero
MaxResultsdi risorse,NextTokenconsente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo. - ResourceType
-
Restituisce il numero di processi per il tipo di risorsa specificato. Usa la richiesta
GetSupportedResourceTypesper ottenere le stringhe per i tipi di risorsa supportati.Quindi il valore ANY restituisce il conteggio di tutti i tipi di risorse.
AGGREGATE_ALLaggrega i numeri dei processi per tutti i tipi di risorsa e restituisce la somma.Il tipo di AWS risorsa di cui eseguire il backup; ad esempio, un volume Amazon Elastic Block Store (AmazonEBS) o un database Amazon Relational Database Service (RDSAmazon).
Modello:
^[a-zA-Z0-9\-\_\.]{1,50}$ - State
-
Questo parametro restituisce il numero di processi con lo stato specificato.
Il valore ANY restituisce il conteggio di tutti gli stati.
AGGREGATE_ALLaggrega i numeri dei processi per tutti gli stati e restituisce la somma.Completed with issuesè uno stato specifico della console AWS Backup . InfattiAPI, questo stato si riferisce ai lavori con uno stato diCOMPLETEDe aMessageCategorycon un valore diverso daSUCCESS; vale a dire, lo stato è completato ma viene fornito con un messaggio di stato. Per ottenere il numero di lavori per cuiCompleted with issues, esegui due GET richieste e sottrai il secondo numero più piccolo:GET/audit/backup-job-summaries? AggregationPeriod= _ &Stato= FOURTEEN DAYS COMPLETED
GETbackup-job-summaries/revisione/? AggregationPeriod= FOURTEEN _ DAYS & MessageCategory = &Stato= SUCCESS COMPLETED
Valori validi:
CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"AggregationPeriod": "string",
"BackupJobSummaries": [
{
"AccountId": "string",
"Count": number,
"EndTime": number,
"MessageCategory": "string",
"Region": "string",
"ResourceType": "string",
"StartTime": number,
"State": "string"
}
],
"NextToken": "string"
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una HTTP risposta di 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- AggregationPeriod
-
Periodo per i risultati restituiti.
-
ONE_DAY- Il numero di lavori giornalieri per i 14 giorni precedenti. -
SEVEN_DAYS- Il numero aggregato dei lavori per i 7 giorni precedenti. -
FOURTEEN_DAYS- Il numero aggregato dei lavori per i 14 giorni precedenti.
Tipo: stringa
-
- BackupJobSummaries
-
Le informazioni di riepilogo.
Tipo: matrice di oggetti BackupJobSummary
- NextToken
-
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero
MaxResultsdi risorse,NextTokenconsente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.Tipo: stringa
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InvalidParameterValueException
-
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
HTTPCodice di stato: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questo API codice in una delle lingue specifiche AWS SDKs, consulta quanto segue:
