PutRuntimeManagementConfig - AWS Lambda

PutRuntimeManagementConfig

Establece la configuración de la administración en tiempo de ejecución para una versión de la función. Para obtener más información, consulte Runtime updates (Actualizaciones de tiempo de ejecución).

Sintaxis de la solicitud

PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "RuntimeVersionArn": "string", "UpdateRuntimeOn": "string" }

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: my-function.

  • ARN de la función: arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • ARN parcial: 123456789012:function:my-function.

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í

Qualifier

Especifique una versión de la función. Esta puede ser la versión $LATEST o un número de versión publicado. Si no se especifica ningún valor, se devuelve la configuración de la versión $LATEST.

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

Patrón: (|[a-zA-Z0-9$_-]+)

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

RuntimeVersionArn

El ARN de la versión del tiempo de ejecución que desea que utilice la función.

nota

Esto solo es necesario si utiliza el modo de actualización Manual del tiempo de ejecución.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 26. La longitud máxima es de 2048 caracteres.

Patrón: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

Obligatorio: no

UpdateRuntimeOn

Especifique el modo de actualización en tiempo de ejecución.

  • Auto (predeterminado) (Automático [predeterminado]): actualice de forma automática la versión de ejecución más reciente y segura mediante el Lanzamiento de la versión del tiempo de ejecución bifásico. Esta es la mejor opción para la mayoría de los clientes para garantizar que siempre se beneficien de las actualizaciones de tiempo de ejecución.

  • Function update (Actualización de funciones): cuando actualiza la función, Lambda actualiza el tiempo de ejecución de la función a la versión de ejecución más reciente y segura. Este enfoque sincroniza las actualizaciones del tiempo de ejecución con la implementación de funciones, lo que permite controlar cuándo se aplican las actualizaciones del tiempo de ejecución y detectar y mitigar las incompatibilidades poco frecuentes entre las actualizaciones del tiempo de ejecución con antelación. Cuando utiliza este modo, debe actualizar periódicamente las funciones para mantener el tiempo de ejecución actualizado.

  • Manual: se especifica una versión del tiempo de ejecución en la configuración de la función. La función utilizará esta versión del tiempo de ejecución de forma indefinida. En el improbable caso de que una nueva versión del tiempo de ejecución sea incompatible con una función existente, puede utilizar este modo para revertir la función a una versión anterior del tiempo de ejecución. Para obtener más información, consulte Restaurar una versión en tiempo de ejecución.

Tipo: cadena

Valores válidos: Auto | Manual | FunctionUpdate

Obligatorio: sí

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "FunctionArn": "string", "RuntimeVersionArn": "string", "UpdateRuntimeOn": "string" }

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.

FunctionArn

El ARN de la función

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-_]+))?

RuntimeVersionArn

El ARN del tiempo de ejecución para el que está configurada la función. Si el modo de actualización en tiempo de ejecución es manual, se devuelve el ARN; de lo contrario, se devuelve el código null.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 26. La longitud máxima es de 2048 caracteres.

Patrón: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

UpdateRuntimeOn

El modo de actualización del tiempo de ejecución.

Tipo: cadena

Valores válidos: Auto | Manual | FunctionUpdate

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: