Skip to content

Guardduty  >  Operations  >  send_object_malware_scan

send_object_malware_scan

Operation

send_object_malware_scan async

send_object_malware_scan(input: SendObjectMalwareScanInput, plugins: list[Plugin] | None = None) -> SendObjectMalwareScanOutput

Initiates a malware scan for a specific S3 object. This API allows you to perform on-demand malware scanning of individual objects in S3 buckets that have Malware Protection for S3 enabled.

When you use this API, the Amazon Web Services service terms for GuardDuty Malware Protection apply. For more information, see Amazon Web Services service terms for GuardDuty Malware Protection.

Parameters:

Name Type Description Default
input SendObjectMalwareScanInput

An instance of SendObjectMalwareScanInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
SendObjectMalwareScanOutput

An instance of SendObjectMalwareScanOutput.

Input

SendObjectMalwareScanInput dataclass

Dataclass for SendObjectMalwareScanInput structure.

Attributes

s3_object class-attribute instance-attribute
s3_object: S3ObjectForSendObjectMalwareScan | None = None

The S3 object information for the object you want to scan. The bucket must have a Malware Protection plan configured to use this API.

Output

SendObjectMalwareScanOutput dataclass

Dataclass for SendObjectMalwareScanOutput structure.