PutFunctionConcurrency - AWS Lambda

PutFunctionConcurrency

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 para ver a configuração atual de uma função.

Use GetAccountSettings 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.

Sintaxe da Solicitação

PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1 Content-type: application/json { "ReservedConcurrentExecutions": number }

Parâmetros da Solicitação de URI

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

FunctionName

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 solicitação aceita os dados a seguir no formato JSON.

ReservedConcurrentExecutions

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

HTTP/1.1 200 Content-type: application/json { "ReservedConcurrentExecutions": number }

Elementos de Resposta

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

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.

Tipo: inteiro

Intervalo válido: valor mínimo de 0.

Erros

Para obter informações sobre os erros que todas as ações retornam, consulte Erros comuns.

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.

Código de status HTTP: 429

Ver também

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte: