AWS API Changes

2018/11/20 - AWS Lambda - 8 updated api methods

Changes AWS Lambda now supports python3.7 and the Kinesis Data Streams (KDS) enhanced fan-out and HTTP/2 data retrieval features for Kinesis event sources.

CreateFunction (updated)

Link ¶
Changes (both)

{'Runtime': {'python3.7'}}

Creates a new Lambda function. The function configuration is created from the request parameters, and the code for the function is provided by a .zip file. The function name is case-sensitive.

This operation requires permission for the lambda:CreateFunction action.

See also: AWS API Documentation

Request Syntax

client.create_function(
    FunctionName='string',
    Runtime='nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
    Role='string',
    Handler='string',
    Code={
        'ZipFile': b'bytes',
        'S3Bucket': 'string',
        'S3Key': 'string',
        'S3ObjectVersion': 'string'
    },
    Description='string',
    Timeout=123,
    MemorySize=123,
    Publish=True|False,
    VpcConfig={
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ]
    },
    DeadLetterConfig={
        'TargetArn': 'string'
    },
    Environment={
        'Variables': {
            'string': 'string'
        }
    },
    KMSKeyArn='string',
    TracingConfig={
        'Mode': 'Active'|'PassThrough'
    },
    Tags={
        'string': 'string'
    }
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the lambda function.

Name formats

Function name - MyFunction .
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
Partial ARN - 123456789012:function:MyFunction .

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

type Runtime

string

param Runtime

[REQUIRED]

The runtime version for the function.

type Role

string

param Role

[REQUIRED]

The Amazon Resource Name (ARN) of the function's execution role.

type Handler

string

param Handler

[REQUIRED]

The name of the method within your code that Lambda calls to execute your function. For more information, see Programming Model.

type Code

dict

param Code

[REQUIRED]

The code for the function.

ZipFile (bytes) --

The base64-encoded contents of your zip file containing your deployment package. AWS SDK and AWS CLI clients handle the encoding for you.
S3Bucket (string) --

An Amazon S3 bucket in the same region as your function.
S3Key (string) --

The Amazon S3 key of the deployment package.
S3ObjectVersion (string) --

For versioned objects, the version of the deployment package object to use.

type Description

string

param Description

A description of the function.

type Timeout

integer

param Timeout

The amount of time that Lambda allows a function to run before terminating it. The default is 3 seconds. The maximum allowed value is 900 seconds.

type MemorySize

integer

param MemorySize

The amount of memory that your function has access to. Increasing the function's memory also increases it's CPU allocation. The default value is 128 MB. The value must be a multiple of 64 MB.

type Publish

boolean

param Publish

Set to true to publish the first version of the function during creation.

type VpcConfig

dict

param VpcConfig

If your Lambda function accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.

SubnetIds (list) --

A list of VPC subnet IDs.
- (string) --
SecurityGroupIds (list) --

A list of VPC security groups IDs.
- (string) --

type DeadLetterConfig

dict

param DeadLetterConfig

A dead letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing. For more information, see Dead Letter Queues.

TargetArn (string) --

The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.

type Environment

dict

param Environment

Environment variables that are accessible from function code during execution.

Variables (dict) --

Environment variable key-value pairs.
- (string) --
  - (string) --

type KMSKeyArn

string

param KMSKeyArn

The ARN of the KMS key used to encrypt your function's environment variables. If not provided, AWS Lambda will use a default service key.

type TracingConfig

dict

param TracingConfig

Set Mode to Active to sample and trace a subset of incoming requests with AWS X-Ray.

Mode (string) --

The tracing mode.

type Tags

dict

param Tags

The list of tags (key-value pairs) assigned to the new function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide .

(string) --
- (string) --

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string',
    'CodeSha256': 'string',
    'Version': 'string',
    'VpcConfig': {
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ],
        'VpcId': 'string'
    },
    'DeadLetterConfig': {
        'TargetArn': 'string'
    },
    'Environment': {
        'Variables': {
            'string': 'string'
        },
        'Error': {
            'ErrorCode': 'string',
            'Message': 'string'
        }
    },
    'KMSKeyArn': 'string',
    'TracingConfig': {
        'Mode': 'Active'|'PassThrough'
    },
    'MasterArn': 'string',
    'RevisionId': 'string'
}

Response Structure

(dict) --

A Lambda function's configuration settings.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The function's Amazon Resource Name.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The function's execution role.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size of the function's deployment package in bytes.
- Description (string) --
  
  The function's description.
- Timeout (integer) --
  
  The amount of time that Lambda allows a function to run before terminating it.
- MemorySize (integer) --
  
  The memory allocated to the function
- LastModified (string) --
  
  The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
- CodeSha256 (string) --
  
  The SHA256 hash of the function's deployment package.
- Version (string) --
  
  The version of the Lambda function.
- VpcConfig (dict) --
  
  The function's networking configuration.
  - SubnetIds (list) --
    
    A list of VPC subnet IDs.
    - (string) --
  - SecurityGroupIds (list) --
    
    A list of VPC security groups IDs.
    - (string) --
  - VpcId (string) --
    
    The ID of the VPC.
- DeadLetterConfig (dict) --
  
  The function's dead letter queue.
  - TargetArn (string) --
    
    The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
- Environment (dict) --
  
  The function's environment variables.
  - Variables (dict) --
    
    Environment variable key-value pairs.
    - (string) --
      - (string) --
  - Error (dict) --
    
    Error messages for environment variables that could not be applied.
    - ErrorCode (string) --
      
      The error code.
    - Message (string) --
      
      The error message.
- KMSKeyArn (string) --
  
  The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
- TracingConfig (dict) --
  
  The function's AWS X-Ray tracing configuration.
  - Mode (string) --
    
    The tracing mode.
- MasterArn (string) --
  
  The ARN of the master function.
- RevisionId (string) --
  
  Represents the latest updated revision of the function or alias.

GetFunction (updated)

Link ¶
Changes (response)

{'Configuration': {'Runtime': {'python3.7'}}}

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.

Use the Qualifier parameter to retrieve a published version of the function. Otherwise, returns the unpublished version ( $LATEST ). For more information, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:GetFunction action.

See also: AWS API Documentation

Request Syntax

client.get_function(
    FunctionName='string',
    Qualifier='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the lambda function.

Name formats

Function name - MyFunction .
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
Partial ARN - 123456789012:function:MyFunction .

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

type Qualifier

string

param Qualifier

Specify a version or alias to get details about a published version of the function.

rtype

dict

returns

Response Syntax

{
    'Configuration': {
        'FunctionName': 'string',
        'FunctionArn': 'string',
        'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
        'Role': 'string',
        'Handler': 'string',
        'CodeSize': 123,
        'Description': 'string',
        'Timeout': 123,
        'MemorySize': 123,
        'LastModified': 'string',
        'CodeSha256': 'string',
        'Version': 'string',
        'VpcConfig': {
            'SubnetIds': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ],
            'VpcId': 'string'
        },
        'DeadLetterConfig': {
            'TargetArn': 'string'
        },
        'Environment': {
            'Variables': {
                'string': 'string'
            },
            'Error': {
                'ErrorCode': 'string',
                'Message': 'string'
            }
        },
        'KMSKeyArn': 'string',
        'TracingConfig': {
            'Mode': 'Active'|'PassThrough'
        },
        'MasterArn': 'string',
        'RevisionId': 'string'
    },
    'Code': {
        'RepositoryType': 'string',
        'Location': 'string'
    },
    'Tags': {
        'string': 'string'
    },
    'Concurrency': {
        'ReservedConcurrentExecutions': 123
    }
}

Response Structure

(dict) --

This response contains the object for the Lambda function location (see FunctionCodeLocation.
- Configuration (dict) --
  
  The function's configuration.
  - FunctionName (string) --
    
    The name of the function.
  - FunctionArn (string) --
    
    The function's Amazon Resource Name.
  - Runtime (string) --
    
    The runtime environment for the Lambda function.
  - Role (string) --
    
    The function's execution role.
  - Handler (string) --
    
    The function Lambda calls to begin executing your function.
  - CodeSize (integer) --
    
    The size of the function's deployment package in bytes.
  - Description (string) --
    
    The function's description.
  - Timeout (integer) --
    
    The amount of time that Lambda allows a function to run before terminating it.
  - MemorySize (integer) --
    
    The memory allocated to the function
  - LastModified (string) --
    
    The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
  - CodeSha256 (string) --
    
    The SHA256 hash of the function's deployment package.
  - Version (string) --
    
    The version of the Lambda function.
  - VpcConfig (dict) --
    
    The function's networking configuration.
    - SubnetIds (list) --
      
      A list of VPC subnet IDs.
      - (string) --
    - SecurityGroupIds (list) --
      
      A list of VPC security groups IDs.
      - (string) --
    - VpcId (string) --
      
      The ID of the VPC.
  - DeadLetterConfig (dict) --
    
    The function's dead letter queue.
    - TargetArn (string) --
      
      The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
  - Environment (dict) --
    
    The function's environment variables.
    - Variables (dict) --
      
      Environment variable key-value pairs.
      - (string) --
        
        (string) --
    - Error (dict) --
      
      Error messages for environment variables that could not be applied.
      - ErrorCode (string) --
        
        The error code.
      - Message (string) --
        
        The error message.
  - KMSKeyArn (string) --
    
    The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
  - TracingConfig (dict) --
    
    The function's AWS X-Ray tracing configuration.
    - Mode (string) --
      
      The tracing mode.
  - MasterArn (string) --
    
    The ARN of the master function.
  - RevisionId (string) --
    
    Represents the latest updated revision of the function or alias.
- Code (dict) --
  
  The function's code.
  - 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.
- Tags (dict) --
  
  Returns the list of tags associated with the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide .
  - (string) --
    - (string) --
- Concurrency (dict) --
  
  The concurrent execution limit set for this function. For more information, see Managing Concurrency.
  - ReservedConcurrentExecutions (integer) --
    
    The number of concurrent executions reserved for this function. For more information, see Managing Concurrency.

GetFunctionConfiguration (updated)

Link ¶
Changes (response)

{'Runtime': {'python3.7'}}

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

If you are using the versioning feature, you can retrieve this information for a specific function version by using the optional Qualifier parameter and specifying the function version or alias that points to it. If you don't provide it, the API returns information about the $LATEST version of the function. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:GetFunctionConfiguration operation.

See also: AWS API Documentation

Request Syntax

client.get_function_configuration(
    FunctionName='string',
    Qualifier='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the lambda function.

Name formats

Function name - MyFunction .
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
Partial ARN - 123456789012:function:MyFunction .

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

type Qualifier

string

param Qualifier

Specify a version or alias to get details about a published version of the function.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string',
    'CodeSha256': 'string',
    'Version': 'string',
    'VpcConfig': {
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ],
        'VpcId': 'string'
    },
    'DeadLetterConfig': {
        'TargetArn': 'string'
    },
    'Environment': {
        'Variables': {
            'string': 'string'
        },
        'Error': {
            'ErrorCode': 'string',
            'Message': 'string'
        }
    },
    'KMSKeyArn': 'string',
    'TracingConfig': {
        'Mode': 'Active'|'PassThrough'
    },
    'MasterArn': 'string',
    'RevisionId': 'string'
}

Response Structure

(dict) --

A Lambda function's configuration settings.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The function's Amazon Resource Name.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The function's execution role.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size of the function's deployment package in bytes.
- Description (string) --
  
  The function's description.
- Timeout (integer) --
  
  The amount of time that Lambda allows a function to run before terminating it.
- MemorySize (integer) --
  
  The memory allocated to the function
- LastModified (string) --
  
  The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
- CodeSha256 (string) --
  
  The SHA256 hash of the function's deployment package.
- Version (string) --
  
  The version of the Lambda function.
- VpcConfig (dict) --
  
  The function's networking configuration.
  - SubnetIds (list) --
    
    A list of VPC subnet IDs.
    - (string) --
  - SecurityGroupIds (list) --
    
    A list of VPC security groups IDs.
    - (string) --
  - VpcId (string) --
    
    The ID of the VPC.
- DeadLetterConfig (dict) --
  
  The function's dead letter queue.
  - TargetArn (string) --
    
    The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
- Environment (dict) --
  
  The function's environment variables.
  - Variables (dict) --
    
    Environment variable key-value pairs.
    - (string) --
      - (string) --
  - Error (dict) --
    
    Error messages for environment variables that could not be applied.
    - ErrorCode (string) --
      
      The error code.
    - Message (string) --
      
      The error message.
- KMSKeyArn (string) --
  
  The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
- TracingConfig (dict) --
  
  The function's AWS X-Ray tracing configuration.
  - Mode (string) --
    
    The tracing mode.
- MasterArn (string) --
  
  The ARN of the master function.
- RevisionId (string) --
  
  Represents the latest updated revision of the function or alias.

ListFunctions (updated)

Link ¶
Changes (response)

{'Functions': {'Runtime': {'python3.7'}}}

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.

If you are using the versioning feature, you can list all of your functions or only $LATEST versions. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

See also: AWS API Documentation

Request Syntax

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

type MasterRegion

string

param MasterRegion

Specify a region (e.g. us-east-2 ) to only list functions that were created in that region, or ALL to include functions replicated from any region. If specified, you also must specify the FunctionVersion .

type FunctionVersion

string

param FunctionVersion

Set to ALL to list all published versions. If not specified, only the latest unpublished version ARN is returned.

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. The absolute maximum of AWS Lambda functions that can be returned is 50.

rtype

dict

returns

Response Syntax

{
    'NextMarker': 'string',
    'Functions': [
        {
            'FunctionName': 'string',
            'FunctionArn': 'string',
            'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
            'Role': 'string',
            'Handler': 'string',
            'CodeSize': 123,
            'Description': 'string',
            'Timeout': 123,
            'MemorySize': 123,
            'LastModified': 'string',
            'CodeSha256': 'string',
            'Version': 'string',
            'VpcConfig': {
                'SubnetIds': [
                    'string',
                ],
                'SecurityGroupIds': [
                    'string',
                ],
                'VpcId': 'string'
            },
            'DeadLetterConfig': {
                'TargetArn': 'string'
            },
            'Environment': {
                'Variables': {
                    'string': 'string'
                },
                'Error': {
                    'ErrorCode': 'string',
                    'Message': 'string'
                }
            },
            'KMSKeyArn': 'string',
            'TracingConfig': {
                'Mode': 'Active'|'PassThrough'
            },
            'MasterArn': 'string',
            'RevisionId': 'string'
        },
    ]
}

Response Structure

(dict) --

A list of Lambda functions.
- NextMarker (string) --
  
  A string, present if there are more functions.
- Functions (list) --
  
  A list of Lambda functions.
  - (dict) --
    
    A Lambda function's configuration settings.
    - FunctionName (string) --
      
      The name of the function.
    - FunctionArn (string) --
      
      The function's Amazon Resource Name.
    - Runtime (string) --
      
      The runtime environment for the Lambda function.
    - Role (string) --
      
      The function's execution role.
    - Handler (string) --
      
      The function Lambda calls to begin executing your function.
    - CodeSize (integer) --
      
      The size of the function's deployment package in bytes.
    - Description (string) --
      
      The function's description.
    - Timeout (integer) --
      
      The amount of time that Lambda allows a function to run before terminating it.
    - MemorySize (integer) --
      
      The memory allocated to the function
    - LastModified (string) --
      
      The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
    - CodeSha256 (string) --
      
      The SHA256 hash of the function's deployment package.
    - Version (string) --
      
      The version of the Lambda function.
    - VpcConfig (dict) --
      
      The function's networking configuration.
      - SubnetIds (list) --
        
        A list of VPC subnet IDs.
        
        (string) --
      - SecurityGroupIds (list) --
        
        A list of VPC security groups IDs.
        
        (string) --
      - VpcId (string) --
        
        The ID of the VPC.
    - DeadLetterConfig (dict) --
      
      The function's dead letter queue.
      - TargetArn (string) --
        
        The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
    - Environment (dict) --
      
      The function's environment variables.
      - Variables (dict) --
        
        Environment variable key-value pairs.
        
        (string) --
        
        (string) --
      - Error (dict) --
        
        Error messages for environment variables that could not be applied.
        
        ErrorCode (string) --
        
        The error code.
        
        Message (string) --
        
        The error message.
    - KMSKeyArn (string) --
      
      The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
    - TracingConfig (dict) --
      
      The function's AWS X-Ray tracing configuration.
      - Mode (string) --
        
        The tracing mode.
    - MasterArn (string) --
      
      The ARN of the master function.
    - RevisionId (string) --
      
      Represents the latest updated revision of the function or alias.

ListVersionsByFunction (updated)

Link ¶
Changes (response)

{'Versions': {'Runtime': {'python3.7'}}}

Lists all versions of a function. For information about versioning, see AWS Lambda Function Versioning and Aliases.

See also: AWS API Documentation

Request Syntax

client.list_versions_by_function(
    FunctionName='string',
    Marker='string',
    MaxItems=123
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the lambda function.

Name formats

Function name - MyFunction .
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
Partial ARN - 123456789012:function:MyFunction .

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

type Marker

string

param Marker

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

type MaxItems

integer

param MaxItems

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

rtype

dict

returns

Response Syntax

{
    'NextMarker': 'string',
    'Versions': [
        {
            'FunctionName': 'string',
            'FunctionArn': 'string',
            'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
            'Role': 'string',
            'Handler': 'string',
            'CodeSize': 123,
            'Description': 'string',
            'Timeout': 123,
            'MemorySize': 123,
            'LastModified': 'string',
            'CodeSha256': 'string',
            'Version': 'string',
            'VpcConfig': {
                'SubnetIds': [
                    'string',
                ],
                'SecurityGroupIds': [
                    'string',
                ],
                'VpcId': 'string'
            },
            'DeadLetterConfig': {
                'TargetArn': 'string'
            },
            'Environment': {
                'Variables': {
                    'string': 'string'
                },
                'Error': {
                    'ErrorCode': 'string',
                    'Message': 'string'
                }
            },
            'KMSKeyArn': 'string',
            'TracingConfig': {
                'Mode': 'Active'|'PassThrough'
            },
            'MasterArn': 'string',
            'RevisionId': 'string'
        },
    ]
}

Response Structure

(dict) --
- NextMarker (string) --
  
  A string, present if there are more function versions.
- Versions (list) --
  
  A list of Lambda function versions.
  - (dict) --
    
    A Lambda function's configuration settings.
    - FunctionName (string) --
      
      The name of the function.
    - FunctionArn (string) --
      
      The function's Amazon Resource Name.
    - Runtime (string) --
      
      The runtime environment for the Lambda function.
    - Role (string) --
      
      The function's execution role.
    - Handler (string) --
      
      The function Lambda calls to begin executing your function.
    - CodeSize (integer) --
      
      The size of the function's deployment package in bytes.
    - Description (string) --
      
      The function's description.
    - Timeout (integer) --
      
      The amount of time that Lambda allows a function to run before terminating it.
    - MemorySize (integer) --
      
      The memory allocated to the function
    - LastModified (string) --
      
      The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
    - CodeSha256 (string) --
      
      The SHA256 hash of the function's deployment package.
    - Version (string) --
      
      The version of the Lambda function.
    - VpcConfig (dict) --
      
      The function's networking configuration.
      - SubnetIds (list) --
        
        A list of VPC subnet IDs.
        
        (string) --
      - SecurityGroupIds (list) --
        
        A list of VPC security groups IDs.
        
        (string) --
      - VpcId (string) --
        
        The ID of the VPC.
    - DeadLetterConfig (dict) --
      
      The function's dead letter queue.
      - TargetArn (string) --
        
        The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
    - Environment (dict) --
      
      The function's environment variables.
      - Variables (dict) --
        
        Environment variable key-value pairs.
        
        (string) --
        
        (string) --
      - Error (dict) --
        
        Error messages for environment variables that could not be applied.
        
        ErrorCode (string) --
        
        The error code.
        
        Message (string) --
        
        The error message.
    - KMSKeyArn (string) --
      
      The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
    - TracingConfig (dict) --
      
      The function's AWS X-Ray tracing configuration.
      - Mode (string) --
        
        The tracing mode.
    - MasterArn (string) --
      
      The ARN of the master function.
    - RevisionId (string) --
      
      Represents the latest updated revision of the function or alias.

PublishVersion (updated)

Link ¶
Changes (response)

{'Runtime': {'python3.7'}}

Publishes a version of your function from the current snapshot of $LATEST. That is, AWS Lambda takes a snapshot of the function code and configuration information from $LATEST and publishes a new version. The code and configuration cannot be modified after publication. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

See also: AWS API Documentation

Request Syntax

client.publish_version(
    FunctionName='string',
    CodeSha256='string',
    Description='string',
    RevisionId='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the lambda function.

Name formats

Function name - MyFunction .
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
Partial ARN - 123456789012:function:MyFunction .

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

type CodeSha256

string

param CodeSha256

The SHA256 hash of the deployment package you want to publish. This provides validation on the code you are publishing. If you provide this parameter, the value must match the SHA256 of the $LATEST version for the publication to succeed. You can use the DryRun parameter of UpdateFunctionCode to verify the hash value that will be returned before publishing your new version.

type Description

string

param Description

The description for the version you are publishing. If not provided, AWS Lambda copies the description from the $LATEST version.

type RevisionId

string

param RevisionId

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you retrieve the latest function version or alias RevisionID using either GetFunction or GetAlias.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string',
    'CodeSha256': 'string',
    'Version': 'string',
    'VpcConfig': {
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ],
        'VpcId': 'string'
    },
    'DeadLetterConfig': {
        'TargetArn': 'string'
    },
    'Environment': {
        'Variables': {
            'string': 'string'
        },
        'Error': {
            'ErrorCode': 'string',
            'Message': 'string'
        }
    },
    'KMSKeyArn': 'string',
    'TracingConfig': {
        'Mode': 'Active'|'PassThrough'
    },
    'MasterArn': 'string',
    'RevisionId': 'string'
}

Response Structure

(dict) --

A Lambda function's configuration settings.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The function's Amazon Resource Name.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The function's execution role.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size of the function's deployment package in bytes.
- Description (string) --
  
  The function's description.
- Timeout (integer) --
  
  The amount of time that Lambda allows a function to run before terminating it.
- MemorySize (integer) --
  
  The memory allocated to the function
- LastModified (string) --
  
  The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
- CodeSha256 (string) --
  
  The SHA256 hash of the function's deployment package.
- Version (string) --
  
  The version of the Lambda function.
- VpcConfig (dict) --
  
  The function's networking configuration.
  - SubnetIds (list) --
    
    A list of VPC subnet IDs.
    - (string) --
  - SecurityGroupIds (list) --
    
    A list of VPC security groups IDs.
    - (string) --
  - VpcId (string) --
    
    The ID of the VPC.
- DeadLetterConfig (dict) --
  
  The function's dead letter queue.
  - TargetArn (string) --
    
    The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
- Environment (dict) --
  
  The function's environment variables.
  - Variables (dict) --
    
    Environment variable key-value pairs.
    - (string) --
      - (string) --
  - Error (dict) --
    
    Error messages for environment variables that could not be applied.
    - ErrorCode (string) --
      
      The error code.
    - Message (string) --
      
      The error message.
- KMSKeyArn (string) --
  
  The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
- TracingConfig (dict) --
  
  The function's AWS X-Ray tracing configuration.
  - Mode (string) --
    
    The tracing mode.
- MasterArn (string) --
  
  The ARN of the master function.
- RevisionId (string) --
  
  Represents the latest updated revision of the function or alias.

UpdateFunctionCode (updated)

Link ¶
Changes (response)

{'Runtime': {'python3.7'}}

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.

If you are using the versioning feature, note this API will always update the $LATEST version of your Lambda function. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:UpdateFunctionCode action.

See also: AWS API Documentation

Request Syntax

client.update_function_code(
    FunctionName='string',
    ZipFile=b'bytes',
    S3Bucket='string',
    S3Key='string',
    S3ObjectVersion='string',
    Publish=True|False,
    DryRun=True|False,
    RevisionId='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the lambda function.

Name formats

Function name - MyFunction .
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
Partial ARN - 123456789012:function:MyFunction .

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

type ZipFile

bytes

param ZipFile

The contents of your zip file containing your deployment package. If you are using the web API directly, the contents of the zip file must be base64-encoded. If you are using the AWS SDKs or the AWS CLI, the SDKs or CLI will do the encoding for you. For more information about creating a .zip file, see Execution Permissions.

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.

type Publish

boolean

param Publish

This boolean parameter can be used to request AWS Lambda to update the Lambda function and publish a version as an atomic operation.

type DryRun

boolean

param DryRun

This boolean parameter can be used to test your request to AWS Lambda to update the Lambda function and publish a version as an atomic operation. It will do all necessary computation and validation of your code but will not upload it or a publish a version. Each time this operation is invoked, the CodeSha256 hash value of the provided code will also be computed and returned in the response.

type RevisionId

string

param RevisionId

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either using using either GetFunction or GetAlias.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string',
    'CodeSha256': 'string',
    'Version': 'string',
    'VpcConfig': {
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ],
        'VpcId': 'string'
    },
    'DeadLetterConfig': {
        'TargetArn': 'string'
    },
    'Environment': {
        'Variables': {
            'string': 'string'
        },
        'Error': {
            'ErrorCode': 'string',
            'Message': 'string'
        }
    },
    'KMSKeyArn': 'string',
    'TracingConfig': {
        'Mode': 'Active'|'PassThrough'
    },
    'MasterArn': 'string',
    'RevisionId': 'string'
}

Response Structure

(dict) --

A Lambda function's configuration settings.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The function's Amazon Resource Name.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The function's execution role.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size of the function's deployment package in bytes.
- Description (string) --
  
  The function's description.
- Timeout (integer) --
  
  The amount of time that Lambda allows a function to run before terminating it.
- MemorySize (integer) --
  
  The memory allocated to the function
- LastModified (string) --
  
  The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
- CodeSha256 (string) --
  
  The SHA256 hash of the function's deployment package.
- Version (string) --
  
  The version of the Lambda function.
- VpcConfig (dict) --
  
  The function's networking configuration.
  - SubnetIds (list) --
    
    A list of VPC subnet IDs.
    - (string) --
  - SecurityGroupIds (list) --
    
    A list of VPC security groups IDs.
    - (string) --
  - VpcId (string) --
    
    The ID of the VPC.
- DeadLetterConfig (dict) --
  
  The function's dead letter queue.
  - TargetArn (string) --
    
    The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
- Environment (dict) --
  
  The function's environment variables.
  - Variables (dict) --
    
    Environment variable key-value pairs.
    - (string) --
      - (string) --
  - Error (dict) --
    
    Error messages for environment variables that could not be applied.
    - ErrorCode (string) --
      
      The error code.
    - Message (string) --
      
      The error message.
- KMSKeyArn (string) --
  
  The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
- TracingConfig (dict) --
  
  The function's AWS X-Ray tracing configuration.
  - Mode (string) --
    
    The tracing mode.
- MasterArn (string) --
  
  The ARN of the master function.
- RevisionId (string) --
  
  Represents the latest updated revision of the function or alias.

UpdateFunctionConfiguration (updated)

Link ¶
Changes (both)

{'Runtime': {'python3.7'}}

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.

See also: AWS API Documentation

Request Syntax

client.update_function_configuration(
    FunctionName='string',
    Role='string',
    Handler='string',
    Description='string',
    Timeout=123,
    MemorySize=123,
    VpcConfig={
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ]
    },
    Environment={
        'Variables': {
            'string': 'string'
        }
    },
    Runtime='nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
    DeadLetterConfig={
        'TargetArn': 'string'
    },
    KMSKeyArn='string',
    TracingConfig={
        'Mode': 'Active'|'PassThrough'
    },
    RevisionId='string'
)

type FunctionName

string

param FunctionName

[REQUIRED]

The name of the lambda function.

Name formats

Function name - MyFunction .
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
Partial ARN - 123456789012:function:MyFunction .

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

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 amount of time that Lambda allows a function to run before terminating it. The default is 3 seconds. The maximum allowed value is 900 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.

type VpcConfig

dict

param VpcConfig

Specify security groups and subnets in a VPC to which your Lambda function needs access.

SubnetIds (list) --

A list of VPC subnet IDs.
- (string) --
SecurityGroupIds (list) --

A list of VPC security groups IDs.
- (string) --

type Environment

dict

param Environment

The parent object that contains your environment's configuration settings.

Variables (dict) --

Environment variable key-value pairs.
- (string) --
  - (string) --

type Runtime

string

param Runtime

The runtime version for the function.

type DeadLetterConfig

dict

param DeadLetterConfig

A dead letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing. For more information, see Dead Letter Queues.

TargetArn (string) --

The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.

type KMSKeyArn

string

param KMSKeyArn

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If you elect to use the AWS Lambda default service key, pass in an empty string ("") for this parameter.

type TracingConfig

dict

param TracingConfig

Set Mode to Active to sample and trace a subset of incoming requests with AWS X-Ray.

Mode (string) --

The tracing mode.

type RevisionId

string

param RevisionId

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either GetFunction or GetAlias.

rtype

dict

returns

Response Syntax

{
    'FunctionName': 'string',
    'FunctionArn': 'string',
    'Runtime': 'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'java8'|'python2.7'|'python3.6'|'python3.7'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'nodejs4.3-edge'|'go1.x',
    'Role': 'string',
    'Handler': 'string',
    'CodeSize': 123,
    'Description': 'string',
    'Timeout': 123,
    'MemorySize': 123,
    'LastModified': 'string',
    'CodeSha256': 'string',
    'Version': 'string',
    'VpcConfig': {
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ],
        'VpcId': 'string'
    },
    'DeadLetterConfig': {
        'TargetArn': 'string'
    },
    'Environment': {
        'Variables': {
            'string': 'string'
        },
        'Error': {
            'ErrorCode': 'string',
            'Message': 'string'
        }
    },
    'KMSKeyArn': 'string',
    'TracingConfig': {
        'Mode': 'Active'|'PassThrough'
    },
    'MasterArn': 'string',
    'RevisionId': 'string'
}

Response Structure

(dict) --

A Lambda function's configuration settings.
- FunctionName (string) --
  
  The name of the function.
- FunctionArn (string) --
  
  The function's Amazon Resource Name.
- Runtime (string) --
  
  The runtime environment for the Lambda function.
- Role (string) --
  
  The function's execution role.
- Handler (string) --
  
  The function Lambda calls to begin executing your function.
- CodeSize (integer) --
  
  The size of the function's deployment package in bytes.
- Description (string) --
  
  The function's description.
- Timeout (integer) --
  
  The amount of time that Lambda allows a function to run before terminating it.
- MemorySize (integer) --
  
  The memory allocated to the function
- LastModified (string) --
  
  The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).
- CodeSha256 (string) --
  
  The SHA256 hash of the function's deployment package.
- Version (string) --
  
  The version of the Lambda function.
- VpcConfig (dict) --
  
  The function's networking configuration.
  - SubnetIds (list) --
    
    A list of VPC subnet IDs.
    - (string) --
  - SecurityGroupIds (list) --
    
    A list of VPC security groups IDs.
    - (string) --
  - VpcId (string) --
    
    The ID of the VPC.
- DeadLetterConfig (dict) --
  
  The function's dead letter queue.
  - TargetArn (string) --
    
    The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.
- Environment (dict) --
  
  The function's environment variables.
  - Variables (dict) --
    
    Environment variable key-value pairs.
    - (string) --
      - (string) --
  - Error (dict) --
    
    Error messages for environment variables that could not be applied.
    - ErrorCode (string) --
      
      The error code.
    - Message (string) --
      
      The error message.
- KMSKeyArn (string) --
  
  The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.
- TracingConfig (dict) --
  
  The function's AWS X-Ray tracing configuration.
  - Mode (string) --
    
    The tracing mode.
- MasterArn (string) --
  
  The ARN of the master function.
- RevisionId (string) --
  
  Represents the latest updated revision of the function or alias.