# Create an alias for a Lambda function
<a name="configuration-aliases"></a>

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](https://console.amazonaws.cn/lambda/home#/functions) of the Lambda console.

1. Choose a function.

1. Choose **Aliases** and then choose **Create alias**.

1. On the **Create alias** page, do the following:

   1. Enter a **Name** for the alias.

   1. (Optional) Enter a **Description** for the alias.

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

   1. (Optional) To configure routing on the alias, expand **Weighted alias**. For more information, see [Implement Lambda canary deployments using a weighted alias](configuring-alias-routing.md).

   1. Choose **Save**.

------
#### [ Amazon CLI ]

To create an alias using the Amazon Command Line Interface (Amazon CLI), use the [create-alias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-alias.html) 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-alias.html) command.

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

To delete an alias, use the [delete-alias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-alias.html) 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:
+ [CreateAlias](https://docs.amazonaws.cn/lambda/latest/api/API_CreateAlias.html)
+ [UpdateAlias](https://docs.amazonaws.cn/lambda/latest/api/API_UpdateAlias.html)
+ [DeleteAlias](https://docs.amazonaws.cn/lambda/latest/api/API_DeleteAlias.html)

------