Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Crea un [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) per una versione della funzione Lambda. Utilizza gli alias per fornire ai clienti un identificatore di funzione che puoi aggiornare per richiamare una versione diversa.

Puoi anche mappare un alias per suddividere le richieste di invocazione tra due versioni. Utilizza il parametro `RoutingConfig` per specificare una seconda versione e la percentuale di richieste di chiamata ricevute.

## Sintassi della richiesta
<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 
      }
   }
}
```

## Parametri della richiesta URI
<a name="API_CreateAlias_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [FunctionName](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionName"></a>
Il nome della funzione Lambda.  

**Formati di nome**
+  **Nome funzione** – `MyFunction`
+  ** Function ARN (ARN funzione LAM)** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
+  **ARN parziale** - `123456789012:function:MyFunction`.
Il vincolo di lunghezza si applica solo all'ARN completo. Se specifichi solo il nome della funzione, questo avrà un limite di lunghezza di 64 caratteri.  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 140.  
Modello: `(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-_]+))?`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_CreateAlias_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Description](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Description"></a>
Una descrizione degli alias.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionVersion"></a>
La versione della funzione chiamata dall'alias.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 1024 caratteri.  
Modello: `(\$LATEST|[0-9]+)`   
Campo obbligatorio: sì

 ** [Name](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Name"></a>
Nome dell'alias.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 128 caratteri.  
Modello: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Campo obbligatorio: sì

 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-RoutingConfig"></a>
La [configurazione di routing](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing) dell'alias.  
Tipo: oggetto [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)  
Campo obbligatorio: no

## Sintassi della risposta
<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 
      }
   }
}
```

## Elementi di risposta
<a name="API_CreateAlias_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [AliasArn](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-AliasArn"></a>
L'Amazon Resource Name (ARN) dell'alias.  
Tipo: stringa  
Modello: `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>
Una descrizione degli alias.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-FunctionVersion"></a>
La versione della funzione chiamata dall'alias.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 1024 caratteri.  
Modello: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Name"></a>
Nome dell'alias.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 128 caratteri.  
Modello: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RevisionId"></a>
Identificatore univoco che cambia quando si aggiorna l'alias.  
Tipo: stringa

 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RoutingConfig"></a>
La [configurazione di routing](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) dell'alias.  
Tipo: oggetto [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterValueException **   
Uno dei parametri della richiesta non è valido.  
Codice di stato HTTP: 400

 ** ResourceConflictException **   
La risorsa esiste già o è in corso un'altra operazione.  
Codice di stato HTTP: 409

 ** ResourceNotFoundException **   
La risorsa specificata nella richiesta non esiste.  
Codice di stato HTTP: 404

 ** ServiceException **   
Il servizio AWS Lambda ha riscontrato un errore interno.  
Codice di stato HTTP: 500

 ** TooManyRequestsException **   
È stato superato il limite di throughput della richiesta. Per ulteriori informazioni, consulta la pagina relativa alle [quote di ](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_CreateAlias_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateAlias) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateAlias) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateAlias) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateAlias) 
+  [SDK AWS per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateAlias) 
+  [AWSSDK per JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateAlias) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateAlias) 
+  [SDK AWS per Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateAlias) 
+  [SDK AWS per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateAlias)