# CreateAlias
<a name="API_CreateAlias"></a>

Cria um [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) para uma versão da função do Lambda. Use alias para fornecer aos clientes um identificador de função que você pode atualizar para invocar uma versão diferente.

Você também pode mapear um alias para dividir solicitações de invocação entre duas versões. Use o parâmetro `RoutingConfig` para especificar uma segunda versão e a porcentagem de solicitações de invocação que ela recebe.

## Sintaxe da Solicitação
<a name="API_CreateAlias_RequestSyntax"></a>

```
POST /2015-03-31/functions/FunctionName/aliases HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## Parâmetros da Solicitação de URI
<a name="API_CreateAlias_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [FunctionName](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionName"></a>
O nome da função do Lambda.  

**Formatos de nome**
+  **Nome da função** - `MyFunction`.
+  **ARN da função** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
+  **ARN parcial**: `123456789012:function:MyFunction`.
A restrição de comprimento se aplica apenas ao ARN completo. Se você especificar apenas o nome da função, ele será limitado a 64 caracteres.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.  
Padrão: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Exigido: Sim

## Corpo da Solicitação
<a name="API_CreateAlias_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [Description](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Description"></a>
Uma descrição do alias.  
Tipo: String  
Restrições de comprimento: comprimento mínimo 0. Comprimento máximo de 256.  
Obrigatório: não

 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionVersion"></a>
A versão da função que o alias invoca.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 1024.  
Padrão: `(\$LATEST|[0-9]+)`   
Exigido: Sim

 ** [Name](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Name"></a>
O nome do alias.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 128.  
Padrão: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Exigido: Sim

 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-RoutingConfig"></a>
A [configuração de roteamento](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing) do alias.  
Tipo: objeto [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)  
Obrigatório: não

## Sintaxe da Resposta
<a name="API_CreateAlias_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## Elementos de Resposta
<a name="API_CreateAlias_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [AliasArn](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-AliasArn"></a>
O nome do recurso da Amazon (ARN) do alarme do alias.  
Tipo: string  
Padrão: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [Description](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Description"></a>
Uma descrição do alias.  
Tipo: String  
Restrições de comprimento: comprimento mínimo 0. Comprimento máximo de 256.

 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-FunctionVersion"></a>
A versão da função que o alias invoca.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 1024.  
Padrão: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Name"></a>
O nome do alias.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 128.  
Padrão: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RevisionId"></a>
Um identificador exclusivo que muda ao atualizar o alias.  
Tipo: string

 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RoutingConfig"></a>
A [configuração de roteamento](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) do alias.  
Tipo: objeto [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)

## Erros
<a name="API_CreateAlias_Errors"></a>

Para obter informações sobre os erros que todas as ações retornam, consulte [Erros comuns](CommonErrors.md).

 ** InvalidParameterValueException **   
Um dos parâmetros da solicitação não é válido.  
Código de Status HTTP: 400

 ** ResourceConflictException **   
O recurso já existe ou outra operação está em andamento.  
Código de status HTTP: 409

 ** ResourceNotFoundException **   
O recurso especificado na solicitação não existe.  
Código de Status HTTP: 404

 ** ServiceException **   
O serviço AWS Lambda encontrou um erro interno.  
Código de Status HTTP: 500

 ** TooManyRequestsException **   
O limite de throughput da solicitação foi excedido. Para obter mais informações, consulte [Cotas do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de status HTTP: 429

## Ver também
<a name="API_CreateAlias_SeeAlso"></a>

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte:
+  [AWS Interface de linha de comando](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateAlias)