PutRuntimeManagementConfig - AWS Lambda
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosVer também

PutRuntimeManagementConfig

Define a configuração de gerenciamento de runtime para a versão de uma função. Para obter mais informações, consulte Runtime updates (Atualizações do tempo de execução).

Sintaxe da Solicitação

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 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

Qualifier

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

RuntimeVersionArn

O ARN da versão de runtime que você deseja que a função use.

nota

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

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

Tipo: string

Valores Válidos: Auto | Manual | FunctionUpdate

Obrigatório: sim

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

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

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.

FunctionArn

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

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

O modo de atualização de runtime.

Tipo: string

Valores Válidos: Auto | Manual | FunctionUpdate

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: