UpdateAlias - AWS Lambda

UpdateAlias

Actualiza la configuración de una alias de función Lambda.

Sintaxis de la solicitud

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

La solicitud utiliza los siguientes parámetros URI.

FunctionName

El nombre de la función de Lambda.

Formatos de nombre

  • Nombre de función - MyFunction.

  • ARN de 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.

Pattern: (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

El nombre del alias.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.

Pattern: (?!^[0-9]+$)([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: String

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.

Requerido: No

FunctionVersion

La versión de la función que invoca el alias.

Tipo: String

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

Pattern: (\$LATEST|[0-9]+)

Requerido: No

RevisionId

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: String

Requerido: No

RoutingConfig

La configuración de enrutamiento del alias.

Tipo: objeto AliasRoutingConfiguration

Requerido: No

Sintaxis de la respuesta

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

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

El servicio devuelve los datos siguientes en formato JSON.

AliasArn

El nombre de recurso de Amazon (ARN) de un alias.

Tipo: String

Pattern: 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: String

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: String

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

Pattern: (\$LATEST|[0-9]+)

Name

El nombre del alias.

Tipo: String

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.

Pattern: (?!^[0-9]+$)([a-zA-Z0-9-_]+)

RevisionId

Un identificador único que cambia al actualizar el alias.

Tipo: String

RoutingConfig

La configuración de enrutamiento del alias.

Tipo: objeto AliasRoutingConfiguration

Errors

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 API de 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.

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: