

# Criar um alias para uma função do Lambda
<a name="configuration-aliases"></a>

É possível criar aliases para sua função do Lambda. Um alias do Lambda é um ponteiro para uma versão da função que pode ser atualizada. Os usuários da função podem acessar a versão da função usando o nome do recurso da Amazon (ARN) do alias. Ao implantar uma nova versão, é possível atualizar o alias para usar a nova versão ou dividir o tráfego entre duas versões.

------
#### [ Console ]

**Para criar um alarme usando o console**

1. Abra a [página Funções](https://console.aws.amazon.com/lambda/home#/functions) do console do Lambda.

1. Escolha uma função.

1. Escolha **Aliases** e, em seguida, escolha **Create alias (Criar alias)**.

1. Na página **Create alias (Criar alias)**, faça o seguinte:

   1. Insira um **Name (Nome)** para o alias.

   1. (Opcional) Insira uma **Description (Descrição)** do alias.

   1. Em **Version (Versão)**, escolha uma versão da função para a qual você deseja que o alias indique.

   1. (Opcional) Para configurar o roteamento no alias, expanda **Weighted alias (Alias ponderado)**. Para ter mais informações, consulte [Implemente implantações canárias do Lambda usando um alias ponderado](configuring-alias-routing.md).

   1. Escolha **Salvar**.

------
#### [ AWS CLI ]

Para criar um alias usando a AWS Command Line Interface (AWS CLI), use o comando [create-alias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-alias.html).

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

Para alterar um alias para apontar para uma nova versão da função, use o comando [update-alias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-alias.html).

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

Para excluir um alias, use o comando [delete-alias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/delete-alias.html).

```
aws lambda delete-alias \
  --function-name {{my-function}} \
  --name {{alias-name}}
```

 Os comandos da AWS CLI nas etapas anteriores correspondem às seguintes operações de API do Lambda:
+ [CreateAlias](https://docs.aws.amazon.com/lambda/latest/api/API_CreateAlias.html)
+ [UpdateAlias](https://docs.aws.amazon.com/lambda/latest/api/API_UpdateAlias.html)
+ [DeleteAlias](https://docs.aws.amazon.com/lambda/latest/api/API_DeleteAlias.html)

------