Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# ListScanJobSummaries
<a name="API_ListScanJobSummaries"></a>

Il s'agit d'une demande de résumé des tâches de scan créées ou exécutées au cours des 30 derniers jours.

## Syntaxe de la demande
<a name="API_ListScanJobSummaries_RequestSyntax"></a>

```
GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1
```

## Paramètres de demande URI
<a name="API_ListScanJobSummaries_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [AccountId](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-AccountId"></a>
Renvoie le nombre de tâches pour le compte spécifié.  
Si la demande est envoyée depuis un compte membre ou un compte ne faisant pas partie d' AWS Organizations, les offres d'emploi enregistrées dans le compte du demandeur seront renvoyées.  
Les comptes root, administrateur et administrateur délégué peuvent utiliser cette valeur `ANY` pour renvoyer le nombre de tâches de tous les comptes de l'organisation.  
 `AGGREGATE_ALL` agrège le nombre de tâches provenant de tous les comptes de l’organisation authentifiée, puis renvoie la somme.  
Modèle : `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-AggregationPeriod"></a>
Période pendant laquelle les résultats sont renvoyés.  
+  `ONE_DAY`Le nombre de tâches quotidiennes pour le jour précédent.
+  `SEVEN_DAYS`Le nombre de tâches quotidiennes effectuées au cours des 7 jours précédents.
+  `FOURTEEN_DAYS`Le nombre de tâches quotidiennes effectuées au cours des 14 jours précédents.
Valeurs valides : `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MalwareScanner](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-MalwareScanner"></a>
Renvoie uniquement les tâches d'analyse pour le scanner de programmes malveillants spécifié. Actuellement, le seul MalwareScanner est`GUARDDUTY`. Mais le terrain soutient également`ANY`, et`AGGREGATE_ALL`.  
Valeurs valides : `GUARDDUTY` 

 ** [MaxResults](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-MaxResults"></a>
Le nombre maximum d'éléments à renvoyer.  
La valeur est un nombre entier. La plage de valeurs acceptées est comprise entre 1 et 500.  
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.

 ** [NextToken](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-NextToken"></a>
L'élément suivant selon une liste partielle des éléments renvoyés. Par exemple, si une demande est faite pour renvoyer `MaxResults` éléments, `NextToken` vous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.

 ** [ResourceType](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-ResourceType"></a>
Renvoie le nombre de tâches pour le type de ressource spécifié. Utilisez la demande `GetSupportedResourceTypes` pour obtenir des chaînes pour les types de ressources pris en charge.  
La valeur `ANY` renvoie le nombre de tous les types de ressources.  
 `AGGREGATE_ALL` agrège le nombre de tâches pour tous les types de ressources et renvoie la somme.  
Modèle : `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ScanResultStatus](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-ScanResultStatus"></a>
Renvoie uniquement les tâches d'analyse pour les résultats d'analyse spécifiés.  
Valeurs valides : `NO_THREATS_FOUND | THREATS_FOUND` 

 ** [State](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-State"></a>
Renvoie uniquement les tâches de numérisation correspondant à l'état de tâche de numérisation spécifié.  
Valeurs valides : `CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | AGGREGATE_ALL | ANY` 

## Corps de la requête
<a name="API_ListScanJobSummaries_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_ListScanJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "ScanJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MalwareScanner": "string",
         "Region": "string",
         "ResourceType": "string",
         "ScanResultStatus": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListScanJobSummaries_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AggregationPeriod](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-AggregationPeriod"></a>
Période pendant laquelle les résultats sont renvoyés.  
+  `ONE_DAY`Le nombre de tâches quotidiennes pour le jour précédent.
+  `SEVEN_DAYS`Le nombre de tâches quotidiennes effectuées au cours des 7 jours précédents.
+  `FOURTEEN_DAYS`Le nombre de tâches quotidiennes effectuées au cours des 14 jours précédents.
Valeurs valides : `'ONE_DAY'` \$1 `'SEVEN_DAYS'` \$1 `'FOURTEEN_DAYS'`   
Type : Chaîne

 ** [NextToken](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-NextToken"></a>
L'élément suivant selon une liste partielle des éléments renvoyés. Par exemple, si une demande est faite pour renvoyer `MaxResults` éléments, `NextToken` vous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.  
Type : Chaîne

 ** [ScanJobSummaries](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-ScanJobSummaries"></a>
Les informations récapitulatives.  
Type : tableau d’objets [ScanJobSummary](API_ScanJobSummary.md)

## Erreurs
<a name="API_ListScanJobSummaries_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** InvalidParameterValueException **   
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** ServiceUnavailableException **   
La demande a échoué en raison d'une défaillance temporaire du serveur.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 500

## Voir aussi
<a name="API_ListScanJobSummaries_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobSummaries)