Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Create an alias for a Lambda function

Focus mode
Create an alias for a Lambda function - AWS Lambda

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.

AWS CLI

To create an alias using the AWS Command Line Interface (AWS 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 AWS CLI commands in the preceding steps correspond to the following Lambda API operations:

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.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.