# PutRuntimeManagementConfig
<a name="API_PutRuntimeManagementConfig"></a>

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](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html) (Actualizaciones de tiempo de ejecución).

## Sintaxis de la solicitud
<a name="API_PutRuntimeManagementConfig_RequestSyntax"></a>

```
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
<a name="API_PutRuntimeManagementConfig_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [FunctionName](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-FunctionName"></a>
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](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-Qualifier"></a>
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
<a name="API_PutRuntimeManagementConfig_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-RuntimeVersionArn"></a>
El ARN de la versión del tiempo de ejecución que desea que utilice la función.  
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](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-UpdateRuntimeOn"></a>
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](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-two-phase). 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](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-rollback).
Tipo: cadena  
Valores válidos: `Auto | Manual | FunctionUpdate`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_PutRuntimeManagementConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionArn": "string",
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

## Elementos de respuesta
<a name="API_PutRuntimeManagementConfig_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [FunctionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-FunctionArn"></a>
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](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-RuntimeVersionArn"></a>
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](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-UpdateRuntimeOn"></a>
El modo de actualización del tiempo de ejecución.  
Tipo: cadena  
Valores válidos: `Auto | Manual | FunctionUpdate` 

## Errores
<a name="API_PutRuntimeManagementConfig_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** 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](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de estado HTTP: 429

## Véase también
<a name="API_PutRuntimeManagementConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [SDK de AWS para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutRuntimeManagementConfig)