View a markdown version of this page

GetPITRMalwareScanResults - AWS Backup

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

GetPITRMalwareScanResults

Gibt die Malware-Scanergebnisse für einen bestimmten Zeitpunkt innerhalb eines kontinuierlichen Backups (Point-in-Time-Recovery) zurück.

Anforderungssyntax

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

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

BackupVaultName

Der Name eines logischen Containers, in dem die Sicherungen gespeichert werden. Backup-Tresore werden durch Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und die AWS -Region, in der sie erstellt wurden, eindeutig sind.

Erforderlich: Ja

MalwareScanner

Die Scan-Engine, die für den entsprechenden Scanauftrag verwendet wurde. Derzeit wird nur GUARDDUTY unterstützt.

Zulässige Werte: GUARDDUTY

Erforderlich: Ja

RecoveryPointArn

Ein ARN, der den Zielwiederherstellungspunkt für das Scannen eindeutig identifiziert; zum Beispielarn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Erforderlich: Ja

ScanEndTime

Der Zeitpunkt innerhalb des kontinuierlichen Backups, zu dem die Ergebnisse des Malware-Scans untersucht werden sollen.

Erforderlich: Ja

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

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

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

LastScanJobTime

Die Abschlusszeit des letzten Scanauftrags, der den angegebenen Zeitpunkt abdeckte.

Typ: Zeitstempel

ScanEndTime

Der Zeitpunkt, der abgefragt wurde. Dies entspricht der in der Anfrage angegebenen Zeit.

Typ: Zeitstempel

ScanId

Die von Amazon GuardDuty für die entsprechende Scan-Job-ID-Anfrage von generierte Scan-ID AWS Backup.

Typ: Zeichenfolge

ScanMode

Gibt den für den Scanauftrag verwendeten Scantyp an.

Typ: Zeichenfolge

Zulässige Werte: FULL_SCAN | INCREMENTAL_SCAN

ScanResult

Enthält den Wert ScanResultStatus für den Scan und gibt THREATS_FOUNDNO_THREATS_FOUND, oder zurückUNKNOWN.

Typ: ScanResultInfo Objekt

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehlertypen.

InvalidParameterValueException

Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.

Context

Type

HTTP-Statuscode: 400

MissingParameterValueException

Zeigt an, dass ein erforderlicher Parameter fehlt.

Context

Type

HTTP-Statuscode: 400

ResourceNotFoundException

Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.

Context

Type

HTTP-Statuscode: 400

ServiceUnavailableException

Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.

Context

Type

HTTP Status Code: 500

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: