As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
GetPITRMalwareScanResults
Retorna os resultados da verificação de malware para um determinado momento em um backup contínuo (recuperação pontual).
Sintaxe da Solicitação
GET /scan/pitr-malware-scan-results?BackupVaultName=BackupVaultName&MalwareScanner=MalwareScanner&RecoveryPointArn=RecoveryPointArn&ScanEndTime=ScanEndTime HTTP/1.1
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- BackupVaultName
-
O nome de um contêiner lógico onde os backups são armazenados. Os cofres de backup são identificados por nomes que são exclusivos da conta usada para criá-los e a região da AWS em que são criados.
Obrigatório: Sim
- MalwareScanner
-
O mecanismo de escaneamento usado para o trabalho de escaneamento correspondente. No momento, somente
GUARDDUTYé compatível.Valores válidos:
GUARDDUTYObrigatório: Sim
- RecoveryPointArn
-
Um ARN que identifica de forma exclusiva o ponto de recuperação de destino para digitalização; por exemplo,.
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45Obrigatório: Sim
- ScanEndTime
-
O momento no backup contínuo para examinar os resultados da verificação de malware.
Obrigatório: Sim
Corpo da Solicitação
Essa solicitação não tem corpo.
Sintaxe da resposta
HTTP/1.1 200
Content-type: application/json
{
"LastScanJobTime": number,
"ScanEndTime": number,
"ScanId": "string",
"ScanMode": "string",
"ScanResult": {
"ScanResultStatus": "string"
}
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- LastScanJobTime
-
O tempo de conclusão do trabalho de verificação mais recente que abrangeu o momento especificado.
Tipo: Timestamp
- ScanEndTime
-
O momento em que foi consultado. Isso reflete a hora especificada na solicitação.
Tipo: Timestamp
- ScanId
-
O ID de escaneamento gerado pela Amazon GuardDuty para a solicitação de Scan Job ID correspondente de AWS Backup.
Tipo: string
- ScanMode
-
Especifica o tipo de escaneamento usado para o trabalho de escaneamento.
Tipo: string
Valores válidos:
FULL_SCAN | INCREMENTAL_SCAN - ScanResult
-
Contém o
ScanResultStatuspara a digitalização e retornaTHREATS_FOUND,NO_THREATS_FOUND, ouUNKNOWN.Tipo: objeto ScanResultInfo
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Tipos de erro comuns.
- InvalidParameterValueException
-
Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.
- Context
- Type
Código de status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
- Context
- Type
Código de status HTTP: 400
- ResourceNotFoundException
-
Um recurso necessário para a ação não existe.
- Context
- Type
Código de status HTTP: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
- Context
- Type
Código de status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte:
