View a markdown version of this page

GetPITRMalwareScanResults - AWS Backup

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

GetPITRMalwareScanResults

返回连续(时间点恢复)备份中指定时间点的恶意软件扫描结果。

请求语法

GET /scan/pitr-malware-scan-results?BackupVaultName=BackupVaultName&MalwareScanner=MalwareScanner&RecoveryPointArn=RecoveryPointArn&ScanEndTime=ScanEndTime HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

BackupVaultName

用于存储备份的逻辑容器的名称。备份保管库的名称在创建它们的账户和创建它们的 AWS 区域中是唯一的。

是否必需:是

MalwareScanner

用于相应扫描任务的扫描引擎。目前仅支持 GUARDDUTY

有效值:GUARDDUTY

是否必需:是

RecoveryPointArn

一个 ARN,用于唯一标识要扫描的目标恢复点;例如,。arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

是否必需:是

ScanEndTime

连续备份中用于检查恶意软件扫描结果的时间点。

是否必需:是

请求体

该请求没有请求正文。

响应语法

HTTP/1.1 200 Content-type: application/json { "LastScanJobTime": number, "ScanEndTime": number, "ScanId": "string", "ScanMode": "string", "ScanResult": { "ScanResultStatus": "string" } }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

LastScanJobTime

覆盖指定时间点的最新扫描任务的完成时间。

类型:时间戳

ScanEndTime

所查询的时间点。这会回显请求中指定的时间。

类型:时间戳

ScanId

Amazon GuardDuty 为相应的 Scan Job ID 请求生成的扫描 ID AWS Backup。

类型:字符串

ScanMode

指定用于扫描任务的扫描类型。

类型:字符串

有效值:FULL_SCAN | INCREMENTAL_SCAN

ScanResult

包含ScanResultStatus用于扫描的,并返回THREATS_FOUNDNO_THREATS_FOUND、或UNKNOWN

类型:ScanResultInfo 对象

错误

有关所有操作返回的常见错误的信息,请参阅常见错误类型

InvalidParameterValueException

表示参数的值有问题。例如,该值超出了范围。

Context

Type

HTTP 状态代码:400

MissingParameterValueException

表示缺少必需的参数。

Context

Type

HTTP 状态代码:400

ResourceNotFoundException

该操作所需的资源不存在。

Context

Type

HTTP 状态代码:400

ServiceUnavailableException

由于服务器发生临时故障而导致请求失败。

Context

Type

HTTP 状态代码:500

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: