View a markdown version of this page

GetPITRMalwareScanResults - AWS Backup

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: GUARDDUTY

Obbligatorio: 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-108B488B0D45

Obbligatorio: 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 ScanResultStatus per la scansione e restituisce THREATS_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: