# PutFunctionConcurrency
<a name="API_PutFunctionConcurrency"></a>

Define o número máximo de execuções simultâneas para uma função e reserva capacidade para esse nível de simultaneidade.

As configurações de simultaneidade aplicam-se à função como um todo, incluindo todas as versões publicadas e a versão não publicada. Reservar simultaneidade garante que sua função tenha capacidade para processar o número especificado de eventos simultaneamente e impede que ela seja dimensionada além desse nível. Use [GetFunction](API_GetFunction.md) para ver a configuração atual de uma função.

Use [GetAccountSettings](API_GetAccountSettings.md) para ver o limite de simultaneidade regional. Você pode reservar simultaneidade para quantas funções quiser, desde que você deixe pelo menos 100 execuções simultâneas sem reservas para funções que não estão configuradas com um limite por função. Para obter mais informações, consulte [Escalabilidade de funções do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/invocation-scaling.html).

## Sintaxe da Solicitação
<a name="API_PutFunctionConcurrency_RequestSyntax"></a>

```
PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1
Content-type: application/json

{
   "ReservedConcurrentExecutions": number
}
```

## Parâmetros da Solicitação de URI
<a name="API_PutFunctionConcurrency_RequestParameters"></a>

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

 ** [FunctionName](#API_PutFunctionConcurrency_RequestSyntax) **   <a name="lambda-PutFunctionConcurrency-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

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

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

 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_RequestSyntax) **   <a name="lambda-PutFunctionConcurrency-request-ReservedConcurrentExecutions"></a>
O número de execuções simultâneas a serem reservadas para a função.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 0.  
Obrigatório: sim

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

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

{
   "ReservedConcurrentExecutions": number
}
```

## Elementos de Resposta
<a name="API_PutFunctionConcurrency_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.

 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_ResponseSyntax) **   <a name="lambda-PutFunctionConcurrency-response-ReservedConcurrentExecutions"></a>
O número de execuções simultâneas que estão reservadas para essa função. Para obter mais informações, consulte [Gerenciamento da simultaneidade reservada do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-concurrency.html).  
Tipo: inteiro  
Intervalo válido: valor mínimo de 0.

## Erros
<a name="API_PutFunctionConcurrency_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_PutFunctionConcurrency_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/PutFunctionConcurrency) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionConcurrency)