SendObjectMalwareScan
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 AWS service terms for GuardDuty Malware
Protection apply. For more information, see AWS service terms for GuardDuty Malware Protection
Request Syntax
POST /object-malware-scan/send HTTP/1.1
Content-type: application/json
{
"s3Object": {
"bucket": "string",
"key": "string",
"versionId": "string"
}
}URI Request Parameters
The request does not use any URI parameters.
Request Body
The request accepts the following data in JSON format.
- s3Object
-
The S3 object information for the object you want to scan. The bucket must have a Malware Protection plan configured to use this API.
Type: S3ObjectForSendObjectMalwareScan object
Required: No
Response Syntax
HTTP/1.1 200
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
An access denied exception object.
- Message
-
The error message.
- Type
-
The error type.
HTTP Status Code: 403
- BadRequestException
-
A bad request exception object.
- Message
-
The error message.
- Type
-
The error type.
HTTP Status Code: 400
- InternalServerErrorException
-
An internal server error exception object.
- Message
-
The error message.
- Type
-
The error type.
HTTP Status Code: 500
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
