Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
GetPITRMalwareScanResults
Renvoie les résultats de l'analyse des programmes malveillants à un moment donné dans le cadre d'une sauvegarde continue (restauration instantanée).
Syntaxe de la demande
GET /scan/pitr-malware-scan-results?BackupVaultName=BackupVaultName&MalwareScanner=MalwareScanner&RecoveryPointArn=RecoveryPointArn&ScanEndTime=ScanEndTime HTTP/1.1
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- BackupVaultName
-
Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms spécifiques pour le compte utilisé pour les créer et la région AWS dans laquelle ils sont créés.
Obligatoire : oui
- MalwareScanner
-
Le moteur d'analyse utilisé pour la tâche de numérisation correspondante. Actuellement, seul
GUARDDUTYest pris en charge.Valeurs valides :
GUARDDUTYObligatoire : oui
- RecoveryPointArn
-
Un ARN qui identifie de manière unique le point de récupération cible à scanner ; par exemple,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.Obligatoire : oui
- ScanEndTime
-
Point dans le temps de la sauvegarde continue pour examiner les résultats de l'analyse des programmes malveillants.
Obligatoire : oui
Corps de la demande
La demande n’a pas de corps de requête.
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"LastScanJobTime": number,
"ScanEndTime": number,
"ScanId": "string",
"ScanMode": "string",
"ScanResult": {
"ScanResultStatus": "string"
}
}Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- LastScanJobTime
-
Durée d'exécution de la tâche de numérisation la plus récente qui a couvert le moment spécifié.
Type : Timestamp
- ScanEndTime
-
Le moment où la question a été posée. Cela renvoie à l'heure spécifiée dans la demande.
Type : Timestamp
- ScanId
-
L'ID de scan généré par Amazon GuardDuty pour la demande d'ID de scan Job correspondante auprès de AWS Backup.
Type : Chaîne
- ScanMode
-
Spécifie le type de numérisation utilisé pour la tâche de numérisation.
Type : Chaîne
Valeurs valides :
FULL_SCAN | INCREMENTAL_SCAN - ScanResult
-
Contient le
ScanResultStatuspour le scan et les retoursTHREATS_FOUNDNO_THREATS_FOUND, ouUNKNOWN.Type : objet ScanResultInfo
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Types d'erreurs courants.
- InvalidParameterValueException
-
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.
- Context
- Type
Code d’état HTTP : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
- Context
- Type
Code d’état HTTP : 400
- ResourceNotFoundException
-
Aucune ressource requise pour l'action n'existe.
- Context
- Type
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
- Context
- Type
Code d’état HTTP : 500
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :
