com.amazonaws.services.lambda.runtime.events

Class S3ObjectLambdaEvent

java.lang.Object

com.amazonaws.services.lambda.runtime.events.S3ObjectLambdaEvent

public class S3ObjectLambdaEvent
extends Object

Event to allow transformations to occur before an S3 object is returned to the calling service. Documentation Writing and debugging Lambda functions for S3 Object Lambda Access Points Example:

 import com.amazonaws.services.lambda.runtime.Context;
 import com.amazonaws.services.lambda.runtime.events.S3ObjectLambdaEvent;
 import org.apache.http.client.fluent.Request;
 import software.amazon.awssdk.services.s3.S3Client;
 import software.amazon.awssdk.services.s3.model.WriteGetObjectResponseRequest;

 import java.io.IOException;

 import static software.amazon.awssdk.core.sync.RequestBody.fromString;

 public class S3ObjectRequestHandler {

      private static final S3Client s3Client = S3Client.create();

      public void handleRequest(S3ObjectLambdaEvent event, Context context) throws IOException {
          String s3Body = Request.Get(event.inputS3Url()).execute().returnContent().asString();

          String responseBody = s3Body.toUpperCase();

          WriteGetObjectResponseRequest request = WriteGetObjectResponseRequest.builder()
              .requestRoute(event.outputRoute())
              .requestToken(event.outputToken())
              .build();
          s3Client.writeGetObjectResponse(request, fromString(responseBody));
      }
 }
 
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	S3ObjectLambdaEvent.Configuration
static class	S3ObjectLambdaEvent.GetObjectContext
static class	S3ObjectLambdaEvent.UserIdentity
static class	S3ObjectLambdaEvent.UserRequest

Constructor Summary

Constructors

Constructor and Description
S3ObjectLambdaEvent()

Method Summary

Modifier and Type	Method and Description
String	inputS3Url() A pre-signed URL that can be used to fetch the original object from Amazon S3.
String	outputRoute() A routing token that is added to the S3 Object Lambda URL when the Lambda function calls the S3 API WriteGetObjectResponse.
String	outputToken() An opaque token used by S3 Object Lambda to match the WriteGetObjectResponse call with the original caller.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

S3ObjectLambdaEvent

public S3ObjectLambdaEvent()

Method Detail

inputS3Url

public String inputS3Url()

A pre-signed URL that can be used to fetch the original object from Amazon S3. The URL is signed using the original caller's identity, and their permissions will apply when the URL is used. If there are signed headers in the URL, the Lambda function must include these in the call to Amazon S3, except for the Host.

Returns:

A pre-signed URL that can be used to fetch the original object from Amazon S3.

outputRoute

public String outputRoute()

A routing token that is added to the S3 Object Lambda URL when the Lambda function calls the S3 API WriteGetObjectResponse.

Returns:

the outputRoute

outputToken

public String outputToken()

An opaque token used by S3 Object Lambda to match the WriteGetObjectResponse call with the original caller.

Returns:

the outputToken