Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# GetPITRMalwareScanResults
<a name="API_GetPITRMalwareScanResults"></a>

Devuelve los resultados del análisis de malware para un momento específico dentro de una copia de seguridad continua (recuperación puntual).

## Sintaxis de la solicitud
<a name="API_GetPITRMalwareScanResults_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetPITRMalwareScanResults_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [BackupVaultName](#API_GetPITRMalwareScanResults_RequestSyntax) **   <a name="Backup-GetPITRMalwareScanResults-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de AWS donde se crearon.  
Obligatorio: sí

 ** [MalwareScanner](#API_GetPITRMalwareScanResults_RequestSyntax) **   <a name="Backup-GetPITRMalwareScanResults-request-uri-MalwareScanner"></a>
El motor de escaneo utilizado para el trabajo de escaneo correspondiente. En la actualidad, solo se admite `GUARDDUTY`.  
Valores válidos: `GUARDDUTY`   
Obligatorio: sí

 ** [RecoveryPointArn](#API_GetPITRMalwareScanResults_RequestSyntax) **   <a name="Backup-GetPITRMalwareScanResults-request-uri-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva el punto de recuperación objetivo para el escaneo; por ejemplo,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`  
Obligatorio: sí

 ** [ScanEndTime](#API_GetPITRMalwareScanResults_RequestSyntax) **   <a name="Backup-GetPITRMalwareScanResults-request-uri-ScanEndTime"></a>
El momento en el que se realiza la copia de seguridad continua para examinar los resultados del análisis de malware.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetPITRMalwareScanResults_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetPITRMalwareScanResults_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LastScanJobTime": number,
   "ScanEndTime": number,
   "ScanId": "string",
   "ScanMode": "string",
   "ScanResult": { 
      "ScanResultStatus": "string"
   }
}
```

## Elementos de respuesta
<a name="API_GetPITRMalwareScanResults_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LastScanJobTime](#API_GetPITRMalwareScanResults_ResponseSyntax) **   <a name="Backup-GetPITRMalwareScanResults-response-LastScanJobTime"></a>
El tiempo de finalización del trabajo de escaneo más reciente que cubrió el punto en el tiempo especificado.  
Tipo: marca temporal

 ** [ScanEndTime](#API_GetPITRMalwareScanResults_ResponseSyntax) **   <a name="Backup-GetPITRMalwareScanResults-response-ScanEndTime"></a>
El momento en el que se consultó. Esto se remonta al tiempo especificado en la solicitud.  
Tipo: marca temporal

 ** [ScanId](#API_GetPITRMalwareScanResults_ResponseSyntax) **   <a name="Backup-GetPITRMalwareScanResults-response-ScanId"></a>
El identificador de escaneado generado por Amazon GuardDuty para la correspondiente solicitud de Scan Job ID de AWS Backup.  
Tipo: cadena

 ** [ScanMode](#API_GetPITRMalwareScanResults_ResponseSyntax) **   <a name="Backup-GetPITRMalwareScanResults-response-ScanMode"></a>
Especifica el tipo de escaneo utilizado para el trabajo de escaneo.  
Tipo: cadena  
Valores válidos: `FULL_SCAN | INCREMENTAL_SCAN` 

 ** [ScanResult](#API_GetPITRMalwareScanResults_ResponseSyntax) **   <a name="Backup-GetPITRMalwareScanResults-response-ScanResult"></a>
Contiene el `ScanResultStatus` elemento para escanear y devuelve `THREATS_FOUND``NO_THREATS_FOUND`, o`UNKNOWN`.  
Tipo: objeto [ScanResultInfo](API_ScanResultInfo.md)

## Errores
<a name="API_GetPITRMalwareScanResults_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InvalidParameterValueException **   
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetPITRMalwareScanResults_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetPITRMalwareScanResults) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetPITRMalwareScanResults)