PutFunctionConcurrency
Establece el número máximo de ejecuciones simultáneas para una función y reserva capacidad para ese nivel de concurrencia.
La configuración de simultaneidad se aplica a la función como un todo, incluyendo todas las versiones publicadas y la versión no publicada. La reserva de simultaneidad garantiza que su función tenga capacidad para procesar el número especificado de eventos simultáneamente y evita que se escale más allá de ese nivel. Utilice GetFunction para ver el valor actual de una función.
Utilice GetAccountSettings para ver el límite de simultaneidad regional. Puede reservar la simultaneidad para tantas funciones como desee, siempre y cuando deje al menos 100 ejecuciones simultáneas sin reservar para funciones que no estén configuradas con un límite por función. Para obtener más información, consulte Escalado de funciones de Lambda
Sintaxis de la solicitud
PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1
Content-type: application/json
{
"ReservedConcurrentExecutions": 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:
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í
-
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- ReservedConcurrentExecutions
-
El número de ejecuciones simultáneas que reserva para la función.
Tipo: entero
Rango válido: valor mínimo de 0.
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"ReservedConcurrentExecutions": 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.
- ReservedConcurrentExecutions
-
El número de ejecuciones simultáneas que están reservadas para esta función. Para obtener más información, consulte Administración de la simultaneidad reservada de Lambda.
Tipo: entero
Rango válido: valor mínimo de 0.
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:
