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: