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
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
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
La demande utilise les paramètres URI suivants.
- AccountId
-
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
ANYpour renvoyer le nombre de tâches de chaque compte de l'organisation.AGGREGATE_ALLagrè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
-
Période pendant laquelle les résultats sont renvoyés.
-
ONE_DAYLe nombre de tâches quotidiennes pour le jour précédent. -
SEVEN_DAYSLe nombre de tâches quotidiennes des 7 jours précédents. -
FOURTEEN_DAYSLe nombre de tâches quotidiennes des 14 jours précédents.
Valeurs valides :
ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS -
- MalwareScanner
-
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 égalementANY, etAGGREGATE_ALL.Valeurs valides :
GUARDDUTY - MaxResults
-
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
-
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,NextTokenvous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant. - ResourceType
-
Renvoie le nombre de tâches pour le type de ressource spécifié. Utilisez la demande
GetSupportedResourceTypespour obtenir des chaînes pour les types de ressources pris en charge.La valeur
ANYrenvoie le nombre de tous les types de ressources.AGGREGATE_ALLagrè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
-
Renvoie uniquement les tâches d'analyse pour les résultats d'analyse spécifiés.
Valeurs valides :
NO_THREATS_FOUND | THREATS_FOUND - State
-
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
La demande n’a pas de corps de requête.
Syntaxe de la réponse
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
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
-
Période pendant laquelle les résultats sont renvoyés.
-
ONE_DAYLe nombre de tâches quotidiennes pour le jour précédent. -
SEVEN_DAYSLe nombre de tâches quotidiennes des 7 jours précédents. -
FOURTEEN_DAYSLe nombre de tâches quotidiennes des 14 jours précédents.
Valeurs valides :
'ONE_DAY'|'SEVEN_DAYS'|'FOURTEEN_DAYS'Type : Chaîne
-
- NextToken
-
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,NextTokenvous 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
-
Les informations récapitulatives.
Type : tableau d’objets ScanJobSummary
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- 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
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
