CreateAlias
Crea un alias para una versión de función Lambda. Utilice los alias para proporcionar a los clientes un identificador de función que puede actualizar para invocar una versión diferente.
También puede asignar un alias para dividir las solicitudes de invocación entre dos versiones. Utilice el parámetro RoutingConfig para especificar una segunda versión y el porcentaje de solicitudes de invocación que recibe.
Sintaxis de la solicitud
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 de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- FunctionName
-
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í
-
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- Description
-
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
-
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: sí
- Name
-
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-_]+)Obligatorio: sí
- RoutingConfig
-
La configuración de enrutamiento del alias.
Tipo: objeto AliasRoutingConfiguration
Obligatorio: no
Sintaxis de la respuesta
HTTP/1.1 201
Content-type: application/json
{
"AliasArn": "string",
"Description": "string",
"FunctionVersion": "string",
"Name": "string",
"RevisionId": "string",
"RoutingConfig": {
"AdditionalVersionWeights": {
"string" : number
}
}
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.
El servicio devuelve los datos siguientes en formato JSON.
- AliasArn
-
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
-
Una descripción del alias.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.
- FunctionVersion
-
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
-
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
-
Un identificador único que cambia al actualizar el alias.
Tipo: cadena
- RoutingConfig
-
La configuración de enrutamiento del alias.
Tipo: objeto AliasRoutingConfiguration
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InvalidParameterValueException
-
Uno de los parámetros de la solicitud no es válido.
Código de estado HTTP: 400
- 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.
Código de estado HTTP: 429
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
