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à.
ListScanJobSummaries
Si tratta di una richiesta di riepilogo dei processi di scansione creati o in esecuzione negli ultimi 30 giorni.
Sintassi della richiesta
GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- 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
ANYper 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_DAYIl numero di lavori giornalieri per il giorno precedente. -
SEVEN_DAYSIl numero di lavori giornalieri per i 7 giorni precedenti. -
FOURTEEN_DAYSIl numero di lavori giornalieri per i 14 giorni precedenti.
Valori validi:
ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS -
- MalwareScanner
-
Restituisce solo i processi di scansione per lo scanner antimalware specificato. Attualmente l'unico MalwareScanner è
GUARDDUTY. Ma il campo supporta ancheANY, eAGGREGATE_ALL.Valori validi:
GUARDDUTY - 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.
- NextToken
-
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero
MaxResultsdi elementi,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.Il valore
ANYrestituisce il conteggio di tutti i tipi di risorse.AGGREGATE_ALLaggrega i numeri dei processi per tutti i tipi di risorsa e restituisce la somma.Modello:
^[a-zA-Z0-9\-\_\.]{1,50}$ - ScanResultStatus
-
Restituisce solo i lavori di scansione per i risultati di scansione specificati.
Valori validi:
NO_THREATS_FOUND | THREATS_FOUND - State
-
Restituisce solo i lavori di scansione per lo stato del lavoro di scansione specificato.
Valori validi:
CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | 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",
"NextToken": "string",
"ScanJobSummaries": [
{
"AccountId": "string",
"Count": number,
"EndTime": number,
"MalwareScanner": "string",
"Region": "string",
"ResourceType": "string",
"ScanResultStatus": "string",
"StartTime": number,
"State": "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.
- AggregationPeriod
-
Il periodo per i risultati restituiti.
-
ONE_DAYIl numero di lavori giornalieri per il giorno precedente. -
SEVEN_DAYSIl numero di lavori giornalieri per i 7 giorni precedenti. -
FOURTEEN_DAYSIl numero di lavori giornalieri per i 14 giorni precedenti.
Valori validi:
'ONE_DAY'|'SEVEN_DAYS'|'FOURTEEN_DAYS'Tipo: String
-
- NextToken
-
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero
MaxResultsdi elementi,NextTokenconsente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.Tipo: String
- ScanJobSummaries
-
Le informazioni di riepilogo.
Tipo: matrice di oggetti ScanJobSummary
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.
- 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
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
