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

Define a configuração de gerenciamento de runtime para a versão de uma função. Para obter mais informações, consulte [Runtime updates](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html) (Atualizações do tempo de execução).

## Sintaxe da Solicitação
<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 da Solicitação de URI
<a name="API_PutRuntimeManagementConfig_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [FunctionName](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-FunctionName"></a>
O nome da função do Lambda.  

**Formatos de nome**
+  **Nome da função**: `my-function`.
+  **ARN da função**: `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN parcial**: `123456789012:function:my-function`.
A restrição de comprimento se aplica apenas ao ARN completo. Se você especificar apenas o nome da função, ele será limitado a 64 caracteres.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.  
Padrão: `(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-_]+))?`   
Exigido: Sim

 ** [Qualifier](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-Qualifier"></a>
Especifique uma versão da função. Isso pode ser `$LATEST` ou um número de versão publicada. Se nenhum valor for especificado, a configuração da versão `$LATEST` será retornada.  
Restrições de Tamanho: Tamanho mínimo 1. Comprimento máximo de 128.  
Padrão: `(|[a-zA-Z0-9$_-]+)` 

## Corpo da Solicitação
<a name="API_PutRuntimeManagementConfig_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-RuntimeVersionArn"></a>
O ARN da versão de runtime que você deseja que a função use.  
Isso é necessário somente se você estiver usando o modo de atualização de runtime **Manual**.
Tipo: string  
Restrições de tamanho: tamanho mínimo de 26. Tamanho máximo de 2.048.  
Padrão: `^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$`   
Obrigatório: não

 ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-UpdateRuntimeOn"></a>
Especifique o modo de atualização de runtime.  
+  **Auto** (Automático) (padrão): atualize automaticamente para a versão de runtime mais recente e segura usando um [Lançamento da versão de runtime em duas fases](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-two-phase). Essa é a melhor opção para a maioria dos clientes por garantir que eles sempre se beneficiem das atualizações de runtime.
+  **Function update** (Atualização da função): o Lambda atualiza o runtime da função para a versão de runtime mais recente e segura quando você atualiza a função. Essa abordagem sincroniza as atualizações de runtime com as implantações de funções, fornecendo a você controle sobre quando as atualizações de runtime serão aplicadas e permitindo que você detecte e mitigue incompatibilidades raras de atualização de runtime com antecedência. Ao usar essa configuração, é necessário atualizar regularmente as funções para manter o runtime atualizado.
+  **Manual**: você especifica uma versão de runtime em sua configuração de função. A função usará essa versão de runtime indefinidamente. No caso raro em que uma nova versão de runtime é incompatível com uma função existente, é permitido reverter a função para uma versão de runtime anterior. Para obter mais informações, consulte [Reverter uma versão de runtime](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-rollback).
Tipo: string  
Valores Válidos: `Auto | Manual | FunctionUpdate`   
Obrigatório: sim

## Sintaxe da Resposta
<a name="API_PutRuntimeManagementConfig_ResponseSyntax"></a>

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

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [FunctionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-FunctionArn"></a>
O ARN da função.  
Tipo: string  
Padrão: `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>
O ARN do runtime que a função está configurada para usar. Se o modo de atualização do runtime for **manual**, o ARN será retornado, caso contrário, `null` será retornado.  
Tipo: string  
Restrições de tamanho: tamanho mínimo de 26. Tamanho máximo de 2.048.  
Padrão: `^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>
O modo de atualização de runtime.  
Tipo: string  
Valores Válidos: `Auto | Manual | FunctionUpdate` 

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

Para obter informações sobre os erros que todas as ações retornam, consulte [Erros comuns](CommonErrors.md).

 ** InvalidParameterValueException **   
Um dos parâmetros da solicitação não é válido.  
Código de Status HTTP: 400

 ** ResourceConflictException **   
O recurso já existe ou outra operação está em andamento.  
Código de status HTTP: 409

 ** ResourceNotFoundException **   
O recurso especificado na solicitação não existe.  
Código de Status HTTP: 404

 ** ServiceException **   
O serviço AWS Lambda encontrou um erro interno.  
Código de Status HTTP: 500

 ** TooManyRequestsException **   
O limite de throughput da solicitação foi excedido. Para obter mais informações, consulte [Cotas do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de status HTTP: 429

## Ver também
<a name="API_PutRuntimeManagementConfig_SeeAlso"></a>

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte:
+  [AWS Interface de linha de comando](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) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for 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 for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for 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)