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à.
GetPITRMalwareScanResults
Restituisce i risultati della scansione del malware per un determinato momento all'interno di un backup continuo (ripristino point-in-time).
Sintassi della richiesta
GET /scan/pitr-malware-scan-results?BackupVaultName=BackupVaultName&MalwareScanner=MalwareScanner&RecoveryPointArn=RecoveryPointArn&ScanEndTime=ScanEndTime HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- BackupVaultName
-
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Obbligatorio: sì
- MalwareScanner
-
Il motore di scansione utilizzato per il processo di scansione corrispondente. Attualmento solo
GUARDDUTYè supportato.Valori validi:
GUARDDUTYObbligatorio: sì
- RecoveryPointArn
-
Un ARN che identifica in modo univoco il punto di ripristino di destinazione per la scansione, ad esempio.
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45Obbligatorio: sì
- ScanEndTime
-
Il momento temporale all'interno del backup continuo in cui esaminare i risultati della scansione antimalware.
Obbligatorio: sì
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"LastScanJobTime": number,
"ScanEndTime": number,
"ScanId": "string",
"ScanMode": "string",
"ScanResult": {
"ScanResultStatus": "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.
- LastScanJobTime
-
L'ora di completamento del processo di scansione più recente che ha coperto il momento specificato.
Tipo: Timestamp
- ScanEndTime
-
Il momento in cui è stata effettuata la richiesta. Ciò riecheggia l'ora specificata nella richiesta.
Tipo: Timestamp
- ScanId
-
L'ID di scansione generato da Amazon GuardDuty per la richiesta Scan Job ID corrispondente da AWS Backup.
Tipo: String
- ScanMode
-
Speciifica il tipo di scansione utilizzato per il processo di scansione.
Tipo: String
Valori validi:
FULL_SCAN | INCREMENTAL_SCAN - ScanResult
-
Contiene il comando
ScanResultStatusper la scansione e restituisceTHREATS_FOUNDNO_THREATS_FOUND, oUNKNOWN.Tipo: oggetto ScanResultInfo
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Tipi di errore 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
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
- Context
- Type
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
- 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 uno degli AWS SDK specifici della lingua, consulta quanto segue: