# UpdateAlias
<a name="API_UpdateAlias"></a>

Actualiza la configuración de una [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) de función Lambda.

## Sintaxis de la solicitud
<a name="API_UpdateAlias_RequestSyntax"></a>

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

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

## Parámetros de solicitud del URI
<a name="API_UpdateAlias_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [FunctionName](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-FunctionName"></a>
El nombre de la función de Lambda.  

**Formatos de nombre**
+  **Nombre de la función**: `MyFunction`.
+  **ARN de la función**: `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
+  **ARN parcial**: `123456789012:function:MyFunction`.
La limitación de longitud se aplica únicamente al ARN completo. Si solo especifica el nombre de la función, se limita a 64 caracteres de longitud.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.  
Patrón: `(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-_]+))?`   
Obligatorio: sí

 ** [Name](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-Name"></a>
El nombre del alias.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.  
Patrón: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateAlias_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Description](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-Description"></a>
Una descripción del alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** [FunctionVersion](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-FunctionVersion"></a>
La versión de la función que invoca el alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `(\$LATEST|[0-9]+)`   
Obligatorio: no

 ** [RevisionId](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-RevisionId"></a>
Actualice el alias solo si el ID de revisión coincide con el ID especificado. Utilice esta opción para evitar la modificación de un alias que haya cambiado desde que lo leyó por última vez.  
Tipo: cadena  
Obligatorio: no

 ** [RoutingConfig](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-RoutingConfig"></a>
La [configuración de enrutamiento](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing) del alias.  
Tipo: objeto [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateAlias_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_UpdateAlias_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AliasArn](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-AliasArn"></a>
El nombre de recurso de Amazon (ARN) de un alias.  
Tipo: String  
Patrón: `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_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-Description"></a>
Una descripción del alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.

 ** [FunctionVersion](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-FunctionVersion"></a>
La versión de la función que invoca el alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-Name"></a>
El nombre del alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.  
Patrón: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-RevisionId"></a>
Un identificador único que cambia al actualizar el alias.  
Tipo: cadena

 ** [RoutingConfig](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-RoutingConfig"></a>
La [configuración de enrutamiento](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) del alias.  
Tipo: objeto [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)

## Errores
<a name="API_UpdateAlias_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InvalidParameterValueException **   
Uno de los parámetros de la solicitud no es válido.  
Código de estado HTTP: 400

 ** PreconditionFailedException **   
El RevisionId proporcionado no coincide con el RevisionId más reciente para la función o alias de Lambda. Llame a la operación de la API `GetFunction` o `GetAlias` para recuperar la última versión de RevisionId para su recurso.  
Código de estado HTTP: 412

 ** ResourceConflictException **   
El recurso ya existe o hay otra operación en marcha.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
El recurso especificado en la solicitud no existe.  
Código de estado HTTP: 404

 ** ServiceException **   
El servicio AWS Lambda detectó un error interno.  
Código de estado HTTP: 500

 ** TooManyRequestsException **   
Se ha superado el límite de rendimiento de la solicitud. Para obtener más información, consulte [Cuotas de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de estado HTTP: 429

## Véase también
<a name="API_UpdateAlias_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateAlias) 
+  [SDK de AWS para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateAlias)