On-demand file scan

Sometimes, you want to scan one particular file in your S3 bucket or R2 bucket. You can do so by sending a scan job to bucketAV manually or programmatically via Amazon SQS & SNS/EventBridge or our HTTPS API.

Programmatically scan a file

Please visit our Developer docs.

Manually scan a file

  1. Visit the AWS SQS Management Console.
  2. Ensure that you are in the correct region.
  3. Navigate to Queues.
  4. Click on the queue with ScanQueue in the name.
  5. Click the Send and receive messages button.
  6. Set Message body (replace BUCKET_NAME with the S3 bucket name, e.g. mybucket, and OBJECT_KEY with the S3 object key, e.g. myfolder/myfile.pdf, the object key has to be URL encoded (e.g., via encodeURIComponent()).):
{
  "objects": [
    {
      "bucket": "BUCKET_NAME",
      "key": "OBJECT_KEY"
    }    
  ]
}
  1. Click the Send message button. Send scan job
  2. Visit the AWS S3 Management Console
  3. Click on the bucket that stores the file.
  4. Navigate to the file.
  5. Click on the file.
  6. Scroll down to the Tags box. The bucketav contains the scan result (reload the page if no tag is visible). Object tag
  1. Visit the AWS SQS Management Console.
  2. Ensure that you are in the correct region.
  3. Navigate to Queues.
  4. Click on the queue with ScanQueue in the name.
  5. Click the Send and receive messages button.
  6. Set Message body (replace BUCKET_NAME with the R2 bucket name, e.g. mybucket, and OBJECT_KEY with the R2 object key, e.g. myfolder/myfile.pdf):
{
  "objects": [
    {
      "bucket": "BUCKET_NAME",
      "key": "OBJECT_KEY"
    }    
  ]
}
  1. Click the Send message button. Send scan job
  2. Visit the AWS CloudWatch Management Console.
  3. Navigate to Dashboards.
  4. Select the dashboard starting with the name bucketav followed by the name of the AWS region—for example, bucketav-eu-west-1.
  5. Wait for your file to appear in the logs. The log entry contains the scan result.

Need more help?

Write us, and we'll get back to you as soon as we can.

Send us an email