Backup / Client / get_pitr_malware_scan_results

get_pitr_malware_scan_results

Backup.Client.get_pitr_malware_scan_results(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.get_pitr_malware_scan_results(
    RecoveryPointArn='string',
    BackupVaultName='string',
    ScanEndTime=datetime(2015, 1, 1),
    MalwareScanner='GUARDDUTY'
)

Parameters:

• RecoveryPointArn (string) –

  [REQUIRED]

  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.

• BackupVaultName (string) –

  [REQUIRED]

  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.

• ScanEndTime (datetime) –

  [REQUIRED]

  The point in time within the continuous backup to examine for malware scan results.

• MalwareScanner (string) –

  [REQUIRED]

  The scanning engine used for the corresponding scan job. Currently only GUARDDUTY is supported.

Return type:

dict

Returns:

Response Syntax

{
    'ScanEndTime': datetime(2015, 1, 1),
    'ScanResult': {
        'ScanResultStatus': 'NO_THREATS_FOUND'|'THREATS_FOUND'|'UNKNOWN'
    },
    'LastScanJobTime': datetime(2015, 1, 1),
    'ScanId': 'string',
    'ScanMode': 'FULL_SCAN'|'INCREMENTAL_SCAN'
}

Response Structure

• (dict) –

  • ScanEndTime (datetime) –

    The point in time that was queried. This echoes back the time specified in the request.

  • ScanResult (dict) –

    Contains the ScanResultStatus for the scan and returns THREATS_FOUND, NO_THREATS_FOUND, or UNKNOWN.

    • ScanResultStatus (string) –

      The status of the scan results.

      Valid values: THREATS_FOUND | NO_THREATS_FOUND | UNKNOWN.

  • LastScanJobTime (datetime) –

    The completion time of the most recent scan job that covered the specified point in time.

  • ScanId (string) –

    The scan ID generated by Amazon GuardDuty for the corresponding Scan Job ID request from Backup.

  • ScanMode (string) –

    Specifies the scan type used for the scan job.

Exceptions

• Backup.Client.exceptions.InvalidParameterValueException

• Backup.Client.exceptions.MissingParameterValueException

• Backup.Client.exceptions.ResourceNotFoundException

• Backup.Client.exceptions.ServiceUnavailableException