AWS Lambda
Developer Guide

Step 2.3: Create the Lambda Function and Test It Manually

In this section, you do the following:

  • Create a Lambda function by uploading the deployment package.

  • Test the Lambda function by invoking it manually. Instead of creating an event source, you use sample Kinesis event data.

In the next section, you create an Kinesis stream and test the end-to-end experience.

Step 2.3.1: Create a Lambda Function (Upload the Deployment Package)

In this step, you upload the deployment package using the AWS CLI.

At the command prompt, run the following Lambda CLI create-function command using the adminuser profile. For more information on setting this up, see Configuring the AWS CLI.

You need to update the command by providing the .zip file path and the execution role ARN. The --runtime parameter value can be python3.6, python2.7, nodejs6.10, nodejs4.3, or java8, depending on the language you used to author your code.

$ aws lambda create-function \ --region us-west-2 \ --function-name ProcessKinesisRecords \ --zip-file fileb://file-path/ \ --role execution-role-arn \ --handler handler \ --runtime runtime-value \ --profile adminuser

The --handler parameter value for Java should be example.ProcessKinesisRecords::recordHandler. For Node.js, it should be ProcessKinesisRecords.handler and for Python it should be ProcessKinesisRecords.lambda_handler.

Optionally, you can upload the .zip file to an Amazon S3 bucket in the same AWS region, and then specify the bucket and object name in the preceding command. You need to replace the --zip-file parameter by the --code parameter, as shown following:

--code S3Bucket=bucket-name,S3Key=zip-file-object-key


You can create the Lambda function using the AWS Lambda console, in which case note the value of the create-function AWS CLI command parameters. You provide the same values in the console UI.

Step 2.3.2: Test the Lambda Function (Invoke Manually)

Invoke the function manually using sample Kinesis event data. We recommend that you invoke the function using the console because the console UI provides a user-friendly interface for reviewing the execution results, including the execution summary, logs written by your code, and the results returned by the function (because the console always performs synchronous execution—invokes the Lambda function using the RequestResponse invocation type).

To test the Lambda function (console)

  1. Follow the steps in the Getting Started to create and invoke the Lambda function at Step 2.2: Invoke the Lambda Function Manually and Verify Results, Logs, and Metrics. For the sample event for testing, choose Kinesis in Sample event template.

  2. Verify the results in the console.

To test the Lambda function (AWS CLI)

  1. Copy the following JSON into a file and save it as input.txt.

    { "Records": [ { "kinesis": { "partitionKey": "partitionKey-3", "kinesisSchemaVersion": "1.0", "data": "SGVsbG8sIHRoaXMgaXMgYSB0ZXN0IDEyMy4=", "sequenceNumber": "49545115243490985018280067714973144582180062593244200961" }, "eventSource": "aws:kinesis", "eventID": "shardId-000000000000:49545115243490985018280067714973144582180062593244200961", "invokeIdentityArn": "arn:aws:iam::account-id:role/testLEBRole", "eventVersion": "1.0", "eventName": "aws:kinesis:record", "eventSourceARN": "arn:aws:kinesis:us-west-2:35667example:stream/examplestream", "awsRegion": "us-west-2" } ] }
  2. Execute the following invoke command:

    $ aws lambda invoke \ --invocation-type Event \ --function-name ProcessKinesisRecords \ --region us-west-2 \ --payload file://file-path/input.txt \ --profile adminuser outputfile.txt


    In this tutorial example, the message is saved in the outputfile.txt file. If you request synchronous execution (RequestResponse as the invocation type), the function returns the string message in the response body.

    For Node.js, it could be one of the following (whatever one you specify in the code):


    context.done(null, "message)

    For Python or Java, it is the message in the return statement:

    return "message"

Next Step

Step 3: Add an Event Source (Create an Kinesis Stream and Associate It with Your Lambda Function)