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
<a name="API_ListBackupJobSummaries"></a>

È 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
<a name="API_ListBackupJobSummaries_RequestSyntax"></a>

```
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [AccountId](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-AccountId"></a>
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, amministratore e amministratore delegato possono utilizzare il valore ANY per restituire il numero di processi di ogni account dell'organizzazione.  
 `AGGREGATE_ALL` aggrega i numeri dei processi di tutti gli account dell'organizzazione autenticata, quindi restituisce la somma.  
Modello: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-AggregationPeriod"></a>
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](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-MaxResults"></a>
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](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-MessageCategory"></a>
Questo parametro restituisce il numero di processi per la categoria di messaggi specificata.  
Stringhe di esempio valide sono `AccessDenied`, `Success` e `InvalidParameters`. Vedi [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco delle MessageCategory stringhe accettate.  
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.  
 `AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.

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

 ** [ResourceType](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-ResourceType"></a>
Restituisce il numero di processi per il tipo di risorsa specificato. Usa la richiesta `GetSupportedResourceTypes` per ottenere le stringhe per i tipi di risorsa supportati.  
Il valore ANY restituisce il conteggio di tutti i tipi di risorse.  
 `AGGREGATE_ALL` aggrega 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 (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).  
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [State](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-State"></a>
Questo parametro restituisce il numero di processi con lo stato specificato.  
Il valore ANY restituisce il conteggio di tutti gli stati.  
 `AGGREGATE_ALL` aggrega i numeri dei processi per tutti gli stati e restituisce la somma.  
 `Completed with issues` è uno stato specifico della console AWS Backup . Per l'API, questo stato si riferisce ai processi `COMPLETED` e a `MessageCategory` con un valore diverso da `SUCCESS`, vale a dire, lo stato è completato ma è accompagnato da un messaggio di stato. Per ottenere il numero di processi per `Completed with issues`, esegui due richieste GET e sottrai il secondo numero più piccolo:  
OTTIENI /audit/? backup-job-summaries AggregationPeriod=fourteen\$1days&state=Completato  
OTTIENI /audit/? backup-job-summaries AggregationPeriod=QUATTORDICI GIORNI& =successo&state=Completato MessageCategory  
Valori validi: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY` 

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

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupJobSummaries_ResponseSyntax"></a>

```
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
<a name="API_ListBackupJobSummaries_ResponseElements"></a>

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

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

 ** [AggregationPeriod](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-AggregationPeriod"></a>
Il 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: String

 ** [BackupJobSummaries](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-BackupJobSummaries"></a>
Le informazioni di riepilogo.  
Tipo: matrice di oggetti [BackupJobSummary](API_BackupJobSummary.md)

 ** [NextToken](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-NextToken"></a>
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.  
Tipo: String

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

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

 ** InvalidParameterValueException **   
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** ServiceUnavailableException **   
La richiesta non è riuscita a causa di un errore temporaneo del server.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 500

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

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