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
$LATESTou um número de versão publicada. Se nenhum valor for especificado, a configuração da versão$LATESTserá 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 | FunctionUpdateObrigató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,
nullserá 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:
