Create an alias for a Lambda function - Amazon Lambda
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Create an alias for a Lambda function

You can create aliases for your Lambda function. A Lambda alias is a pointer to a function version that you can update. The function's users can access the function version using the alias Amazon Resource Name (ARN). When you deploy a new version, you can update the alias to use the new version, or split traffic between two versions.

Console
To create an alias using the console

  1. Open the Functions page of the Lambda console.

  2. Choose a function.

  3. Choose Aliases and then choose Create alias.

  4. On the Create alias page, do the following:

    1. Enter a Name for the alias.

    2. (Optional) Enter a Description for the alias.

    3. For Version, choose a function version that you want the alias to point to.

    4. (Optional) To configure routing on the alias, expand Weighted alias. For more information, see Implement Lambda canary deployments using a weighted alias.

    5. Choose Save.

Amazon CLI

To create an alias using the Amazon Command Line Interface (Amazon CLI), use the create-alias command.

aws lambda create-alias \
  --function-name my-function \
  --name alias-name \
  --function-version version-number \
  --description " "

To change an alias to point a new version of the function, use the update-alias command.

aws lambda update-alias \
  --function-name my-function \
  --name alias-name \
  --function-version version-number

To delete an alias, use the delete-alias command.

aws lambda delete-alias \
  --function-name my-function \
  --name alias-name

The Amazon CLI commands in the preceding steps correspond to the following Lambda API operations: