pitr_malware_scan_results

Creates, updates, deletes, gets or lists a pitr_malware_scan_results resource.

Overview

Name	pitr_malware_scan_results
Type	Resource
Id	aws.backup.pitr_malware_scan_results

Fields

The following fields are returned by SELECT queries:

get_pitr_malware_scan_results

Name	Datatype	Description
last_scan_job_time	string (date-time)	The completion time of the most recent scan job that covered the specified point in time.
scan_end_time	string (date-time)	The point in time that was queried. This echoes back the time specified in the request.
scan_id	string	The scan ID generated by Amazon GuardDuty for the corresponding Scan Job ID request from Backup.
scan_mode	string	Specifies the scan type used for the scan job. (FULL_SCAN, INCREMENTAL_SCAN)
scan_result	object	Contains the ScanResultStatus for the scan and returns THREATS_FOUND, NO_THREATS_FOUND, or UNKNOWN.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_pitr_malware_scan_results	select	RecoveryPointArn, BackupVaultName, ScanEndTime, MalwareScanner, region		Returns the malware scan results for a specified point in time within a continuous (point-in-time recovery) backup.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
BackupVaultName	string	The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the Amazon Web Services Region where they are created.
MalwareScanner	string	The scanning engine used for the corresponding scan job. Currently only GUARDDUTY is supported.
RecoveryPointArn	string	An ARN that uniquely identifies the target recovery point for scanning; for example, arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.
ScanEndTime	string (date-time)	The point in time within the continuous backup to examine for malware scan results.
region	string	AWS region (default: us-east-1)

SELECT examples

get_pitr_malware_scan_results

Returns the malware scan results for a specified point in time within a continuous (point-in-time recovery) backup.

SELECT
last_scan_job_time,
scan_end_time,
scan_id,
scan_mode,
scan_result
FROM aws.backup.pitr_malware_scan_results
WHERE RecoveryPointArn = '{{ RecoveryPointArn }}' -- required
AND BackupVaultName = '{{ BackupVaultName }}' -- required
AND ScanEndTime = '{{ ScanEndTime }}' -- required
AND MalwareScanner = '{{ MalwareScanner }}' -- required
AND region = '{{ region }}' -- required
;