AWS API Changes

2015/06/24 - AWS Lambda - 6 updated api methods

CreateFunction (updated)

Link ¶
Changes (both)

{'Runtime': {'java8'}}

Creates a new Lambda function. The function metadata is created from the request parameters, and the code for the function is provided by a .zip file in the request body. If the function name already exists, the operation will fail. Note that the function name is case-sensitive.

This operation requires permission for the lambda:CreateFunction action.

Request Syntax

client.create_function(
    FunctionName='string',
    Runtime='nodejs'|'java8',
    Role='string',
    Handler='string',
    Description='string',
    Timeout=123,
    MemorySize=123,
    Code={
        'ZipFile': b'bytes',
        'S3Bucket': 'string',
        'S3Key': 'string',
        'S3ObjectVersion': 'string'
    }
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name you want to assign to the function you are uploading. You can specify an unqualified function name (for example, "Thumbnail") or you can specify Amazon Resource Name (ARN) of the function (for example, "arn:aws:lambda:us-west-2:account-id:function:ThumbNail"). AWS Lambda also allows you to specify only the account ID qualifier (for example, "account-id:Thumbnail"). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 character in length. The function names appear in the console and are returned in the ListFunctions API. Function names are used to specify functions to other AWS Lambda APIs, such as Invoke.

type Runtime

string

param Runtime

[REQUIRED]

The runtime environment for the Lambda function you are uploading. Currently, Lambda supports "java" and "nodejs" as the runtime.

type Role

string

param Role

[REQUIRED]

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources. For more information, see AWS Lambda: How it Works

type Handler

string

param Handler

[REQUIRED]

The function within your code that Lambda calls to begin execution. For Node.js, it is the module-name .*export* value in your function. For Java, it can be package.class-name::handler or package.class-name . For more information, see Lambda Function Handler (Java).

type Description

string

param Description

A short, user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.

type Timeout

integer

param Timeout

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

type MemorySize

integer

param MemorySize

The amount of memory, in MB, your Lambda function is given. Lambda uses this memory size to infer the amount of CPU and memory allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

type Code

dict

param Code

[REQUIRED]

The code for the Lambda function.

ZipFile (bytes) --

A base64-encoded .zip file containing your deployment package. For more information about creating a .zip file, go to Execution Permissions in the AWS Lambda Developer Guide .
S3Bucket (string) --

Amazon S3 bucket name where the .zip file containing your deployment package is stored. This bucket must reside in the same AWS region where you are creating the Lambda function.
S3Key (string) --

The Amazon S3 object (the deployment package) key name you want to upload.
S3ObjectVersion (string) --

The Amazon S3 object (the deployment package) version you want to upload.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'java8',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string'
}

Response Structure

(dict) --

A complex type that describes function metadata.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The Amazon Resource Name (ARN) assigned to the function.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size, in bytes, of the function .zip file you uploaded.
- Description (string) --
  
  The user-provided description.
- Timeout (integer) --
  
  The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.
- MemorySize (integer) --
  
  The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
- LastModified (string) --
  
  The timestamp of the last time you updated the function.

GetFunction (updated)

Link ¶
Changes (response)

{'Configuration': {'Runtime': {'java8'}}}

Returns the configuration information of the Lambda function and a presigned URL link to the .zip file you uploaded with CreateFunction so you can download the .zip file. Note that the URL is valid for up to 10 minutes. The configuration information is the same information you provided as parameters when uploading the function.

This operation requires permission for the lambda:GetFunction action.

Request Syntax

client.get_function(
    FunctionName='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The Lambda function name.

You can specify an unqualified function name (for example, "Thumbnail") or you can specify Amazon Resource Name (ARN) of the function (for example, "arn:aws:lambda:us-west-2:account-id:function:ThumbNail"). AWS Lambda also allows you to specify only the account ID qualifier (for example, "account-id:Thumbnail"). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 character in length.

rtype

dict

returns

Response Syntax

{
    'Configuration': {
        'FunctionName': 'string',
        'FunctionArn': 'string',
        'Runtime': 'nodejs'|'java8',
        'Role': 'string',
        'Handler': 'string',
        'CodeSize': 123,
        'Description': 'string',
        'Timeout': 123,
        'MemorySize': 123,
        'LastModified': 'string'
    },
    'Code': {
        'RepositoryType': 'string',
        'Location': 'string'
    }
}

Response Structure

(dict) --

This response contains the object for the Lambda function location (see API_FunctionCodeLocation
- Configuration (dict) --
  
  A complex type that describes function metadata.
  - FunctionName (string) --
    
    The name of the function.
  - FunctionArn (string) --
    
    The Amazon Resource Name (ARN) assigned to the function.
  - Runtime (string) --
    
    The runtime environment for the Lambda function.
  - Role (string) --
    
    The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.
  - Handler (string) --
    
    The function Lambda calls to begin executing your function.
  - CodeSize (integer) --
    
    The size, in bytes, of the function .zip file you uploaded.
  - Description (string) --
    
    The user-provided description.
  - Timeout (integer) --
    
    The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.
  - MemorySize (integer) --
    
    The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
  - LastModified (string) --
    
    The timestamp of the last time you updated the function.
- Code (dict) --
  
  The object for the Lambda function location.
  - RepositoryType (string) --
    
    The repository from which you can download the function.
  - Location (string) --
    
    The presigned URL you can use to download the function's .zip file that you previously uploaded. The URL is valid for up to 10 minutes.

GetFunctionConfiguration (updated)

Link ¶
Changes (response)

{'Runtime': {'java8'}}

Returns the configuration information of the Lambda function. This the same information you provided as parameters when uploading the function by using CreateFunction.

This operation requires permission for the lambda:GetFunctionConfiguration operation.

Request Syntax

client.get_function_configuration(
    FunctionName='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the Lambda function for which you want to retrieve the configuration information.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'java8',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string'
}

Response Structure

(dict) --

A complex type that describes function metadata.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The Amazon Resource Name (ARN) assigned to the function.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size, in bytes, of the function .zip file you uploaded.
- Description (string) --
  
  The user-provided description.
- Timeout (integer) --
  
  The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.
- MemorySize (integer) --
  
  The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
- LastModified (string) --
  
  The timestamp of the last time you updated the function.

ListFunctions (updated)

Link ¶
Changes (response)

{'Functions': {'Runtime': {'java8'}}}

Returns a list of your Lambda functions. For each function, the response includes the function configuration information. You must use GetFunction to retrieve the code for your function.

This operation requires permission for the lambda:ListFunctions action.

Request Syntax

client.list_functions(
    Marker='string',
    MaxItems=123
)

type Marker

string

param Marker

Optional string. An opaque pagination token returned from a previous ListFunctions operation. If present, indicates where to continue the listing.

type MaxItems

integer

param MaxItems

Optional integer. Specifies the maximum number of AWS Lambda functions to return in response. This parameter value must be greater than 0.

rtype

dict

returns

Response Syntax

{
    'NextMarker': 'string',
    'Functions': [
        {
            'FunctionName': 'string',
            'FunctionArn': 'string',
            'Runtime': 'nodejs'|'java8',
            'Role': 'string',
            'Handler': 'string',
            'CodeSize': 123,
            'Description': 'string',
            'Timeout': 123,
            'MemorySize': 123,
            'LastModified': 'string'
        },
    ]
}

Response Structure

(dict) --

Contains a list of AWS Lambda function configurations (see FunctionConfiguration.
- NextMarker (string) --
  
  A string, present if there are more functions.
- Functions (list) --
  
  A list of Lambda functions.
  - (dict) --
    
    A complex type that describes function metadata.
    - FunctionName (string) --
      
      The name of the function.
    - FunctionArn (string) --
      
      The Amazon Resource Name (ARN) assigned to the function.
    - Runtime (string) --
      
      The runtime environment for the Lambda function.
    - Role (string) --
      
      The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.
    - Handler (string) --
      
      The function Lambda calls to begin executing your function.
    - CodeSize (integer) --
      
      The size, in bytes, of the function .zip file you uploaded.
    - Description (string) --
      
      The user-provided description.
    - Timeout (integer) --
      
      The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.
    - MemorySize (integer) --
      
      The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
    - LastModified (string) --
      
      The timestamp of the last time you updated the function.

UpdateFunctionCode (updated)

Link ¶
Changes (response)

{'Runtime': {'java8'}}

Updates the code for the specified Lambda function. This operation must only be used on an existing Lambda function and cannot be used to update the function configuration.

This operation requires permission for the lambda:UpdateFunctionCode action.

Request Syntax

client.update_function_code(
    FunctionName='string',
    ZipFile=b'bytes',
    S3Bucket='string',
    S3Key='string',
    S3ObjectVersion='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The existing Lambda function name whose code you want to replace.

type ZipFile

bytes

param ZipFile

Based64-encoded .zip file containing your packaged source code.

type S3Bucket

string

param S3Bucket

Amazon S3 bucket name where the .zip file containing your deployment package is stored. This bucket must reside in the same AWS region where you are creating the Lambda function.

type S3Key

string

param S3Key

The Amazon S3 object (the deployment package) key name you want to upload.

type S3ObjectVersion

string

param S3ObjectVersion

The Amazon S3 object (the deployment package) version you want to upload.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'java8',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string'
}

Response Structure

(dict) --

A complex type that describes function metadata.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The Amazon Resource Name (ARN) assigned to the function.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size, in bytes, of the function .zip file you uploaded.
- Description (string) --
  
  The user-provided description.
- Timeout (integer) --
  
  The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.
- MemorySize (integer) --
  
  The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
- LastModified (string) --
  
  The timestamp of the last time you updated the function.

UpdateFunctionConfiguration (updated)

Link ¶
Changes (response)

{'Runtime': {'java8'}}

Updates the configuration parameters for the specified Lambda function by using the values provided in the request. You provide only the parameters you want to change. This operation must only be used on an existing Lambda function and cannot be used to update the function's code.

This operation requires permission for the lambda:UpdateFunctionConfiguration action.

Request Syntax

client.update_function_configuration(
    FunctionName='string',
    Role='string',
    Handler='string',
    Description='string',
    Timeout=123,
    MemorySize=123
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the Lambda function.

type Role

string

param Role

The Amazon Resource Name (ARN) of the IAM role that Lambda will assume when it executes your function.

type Handler

string

param Handler

The function that Lambda calls to begin executing your function. For Node.js, it is the module-name.export value in your function.

type Description

string

param Description

A short user-defined function description. AWS Lambda does not use this value. Assign a meaningful description as you see fit.

type Timeout

integer

param Timeout

The function execution time at which AWS Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

type MemorySize

integer

param MemorySize

The amount of memory, in MB, your Lambda function is given. AWS Lambda uses this memory size to infer the amount of CPU allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'java8',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string'
}

Response Structure

(dict) --

A complex type that describes function metadata.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The Amazon Resource Name (ARN) assigned to the function.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size, in bytes, of the function .zip file you uploaded.
- Description (string) --
  
  The user-provided description.
- Timeout (integer) --
  
  The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.
- MemorySize (integer) --
  
  The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
- LastModified (string) --
  
  The timestamp of the last time you updated the function.