Skip to content

Amazon Lambda Connector Configuration

The following operations allow you to work with the Amazon Lambda Connector. Click an operation name to see parameter details and samples on how to use it.

Working with Amazon Lambda Accounts

getAccountSettings

The getAccountSettings operation retrieves details about your account's limits and usage in an AWS Region. See the related API documentation.

Parameter Name Description Required
apiVersionGetAccountSettings API version for GetAccountSettings method. Yes

Sample configuration

<amazonlambda.getAccountSettings>
    <apiVersionGetAccountSettings>{$ctx:apiVersionGetAccountSettings}</apiVersionGetAccountSettings>
</amazonlambda.getAccountSettings>

Sample request

{
    "secretAccessKey":"0b+fcboKq87Nf7mH6M**********************",
    "accessKeyId":"AKIAJHJ*************",
    "region":"us-east-2",
    "blocking":"false",
    "apiVersionGetAccountSettings": "2016-08-19"
}

Sample response

{
    "AccountLimit": {
        "CodeSizeUnzipped": 262144000,
        "CodeSizeZipped": 52428800,
        "ConcurrentExecutions": 1000,
        "TotalCodeSize": 80530636800,
        "UnreservedConcurrentExecutions": 1000,
        "UnreservedConcurrentExecutionsMinimum": null
    },
    "AccountUsage": {
        "FunctionCount": 1,
        "TotalCodeSize": 176268666
    },
    "DeprecatedFeaturesAccess": null,
    "HasFunctionWithDeprecatedRuntime": false,
    "PreviewFeatures": null
}

Working with Amazon Lambda Aliases

createAlias

The createAlias implementation of the POST operation creates an alias for a Lambda function version. Use aliases to provide clients with a function identifier that you can update to invoke a different version. You can also map an alias to split invocation requests between two versions. Use the RoutingConfig parameter to specify a second version and the percentage of invocation requests that it receives. See the related API documentation.

Parameter Name Description Required
apiVersionCreateAlias API version for CreateAlias method. Yes
functionName The name of the Lambda function that the alias invokes. Yes
createAliasDescription The description of the alias. Yes
functionVersion The function version that the alias invokes. Yes
aliasName The name of the alias. Yes
aliasAdditionalVersionWeights The name of second alias, and the percentage of traffic that's routed to it. Yes

Sample configuration

<amazonlambda.createAlias>
    <functionName>{$ctx:functionName}</functionName>
    <createAliasDescription>{$ctx:createAliasDescription}</createAliasDescription>
    <functionVersion>{$ctx:functionVersion}</functionVersion>
    <aliasName>{$ctx:aliasName}</aliasName>
    <aliasAdditionalVersionWeights>{$ctx:aliasAdditionalVersionWeights}</aliasAdditionalVersionWeights>
    <apiVersionCreateAlias>{$ctx:apiVersionCreateAlias}</apiVersionCreateAlias>
</amazonlambda.createAlias>

Sample request

{
    "secretAccessKey":"0b+fcboKq87Nf7mH6M**********************",
    "accessKeyId":"AKIAJHJ*************",
    "region":"us-east-2",
    "blocking":"false",
    "functionName":"test",
    "functionVersion":"$LATEST",
    "aliasName":"alias2",
    "apiVersionCreateAlias":"2015-03-31"
}

Sample response

{
    "AliasArn": "arn:aws:lambda:us-east-2:********:function:test:alias2",
    "Description": "",
    "FunctionVersion": "$LATEST",
    "Name": "alias2",
    "RevisionId": "be8925ae-a634-4303-92e2-5364d0724406",
    "RoutingConfig": null
}
deleteAlias

The deleteAlias implementation deletes a Lambda function alias. See the related API documentation.

Parameter Name Description Required
apiVersionDeleteAlias API version for DeleteAlias method. Yes
functionName The name of the Lambda function that the alias invokes. Yes
aliasName The name of the alias. Yes

Sample configuration

<amazonlambda.deleteAlias>
    <functionName>{$ctx:functionName}</functionName>
    <aliasName>{$ctx:aliasName}</aliasName>
    <apiVersionDeleteAlias>{$ctx:apiVersionDeleteAlias}</apiVersionDeleteAlias>
</amazonlambda.deleteAlias>

Sample request

{
    "secretAccessKey":"0b+fcboKq87Nf7mH6M**********************",
    "accessKeyId":"AKIAJHJ*************",
    "region":"us-east-2",
    "blocking":"false",
    "functionName":"test",
    "aliasName":"alias2",
    "apiVersionDeleteAlias":"2015-03-31"
}

Sample response

Status: 204 No Content
getAlias

The getAlias implementation of the GET operation returns details about a Lambda function alias. See the related API documentation.

Parameter Name Description Required
apiVersionGetAlias API version for getAlias method. Yes
functionName The name of the Lambda function that the alias invokes. Yes
aliasName The name of the alias. Yes

Sample configuration

<amazonlambda.getAlias>
    <functionName>{$ctx:functionName}</functionName>
    <aliasName>{$ctx:aliasName}</aliasName>
    <apiVersionGetAlias>{$ctx:apiVersionGetAlias}</apiVersionGetAlias>    
</amazonlambda.getAlias>

Sample request

{
    "secretAccessKey":"0b+fcboKq87Nf7mH6M**********************",
    "accessKeyId":"AKIAJHJ*************",
    "region":"us-east-2",
    "blocking":"false",
    "functionName":"test",
    "aliasName":"alias2",
    "apiVersionGetAlias":"2015-03-31"
}

Sample response

Status: 204 No Content
{
    "AliasArn": "arn:aws:lambda:us-east-2:********:function:test:alias2",
    "Description": "",
    "FunctionVersion": "$LATEST",
    "Name": "alias2",
    "RevisionId": "be8925ae-a634-4303-92e2-5364d0724406",
    "RoutingConfig": null
}
updateAlias

The updateAlias method implementation updates the configuration of a Lambda function alias. See the related API documentation.

Parameter Name Description Required
apiVersionUpdateAlias API version for updateAlias method. Yes
functionName The name of the Lambda function that the alias invokes. Yes
aliasName The name of the alias. Yes
updatedAliasDescription The description of the alias. Yes
updatedAliasAdditionalVersionWeight The name of second alias, and the percentage of traffic that's routed to it. Yes
functionVersion The function version that the alias invokes. Yes

Sample configuration

<amazonlambda.updateAlias>
    <functionName>{$ctx:functionName}</functionName>
    <updatedAliasDescription>{$ctx:updatedAliasDescription}</updatedAliasDescription>
    <functionVersion>{$ctx:functionVersion}</functionVersion>
    <aliasName>{$ctx:aliasName}</aliasName>
    <updatedAliasAdditionalVersionWeight>{$ctx:updatedAliasAdditionalVersionWeight}</updatedAliasAdditionalVersionWeight>
    <apiVersionUpdateAlias>{$ctx:apiVersionUpdateAlias}</apiVersionUpdateAlias>
</amazonlambda.updateAlias>

Sample request

{
    "secretAccessKey":"0b+fcboKq87Nf7mH6M**********************",
    "accessKeyId":"AKIAJHJ*************",
    "region":"us-east-1",
    "blocking":"false",
    "functionName":"test",
    "aliasName":"alias2",
    "functionVersion":"$LATEST",
    "apiVersionUpdateAlias":"2015-03-31"
}

Sample response

Status: 200 OK
{
    "AliasArn": "arn:aws:lambda:us-east-2:*********:function:test:alias2",
    "Description": "",
    "FunctionVersion": "$LATEST",
    "Name": "alias2",
    "RevisionId": "6d8d089b-c632-4a4b-91ba-ee1ce706c50a",
    "RoutingConfig": null
}
Top