Criar sua primeira função do Lambda
Para começar a usar o Lambda, use o console do Lambda para criar uma função. Em alguns minutos, você pode criar e implantar uma função e testá-la no console.
Ao executar o tutorial, você aprenderá alguns conceitos fundamentais do Lambda, como passar argumentos para sua função usando o objeto de evento do Lambda. Você também aprenderá a retornar as saídas de log da sua função e a visualizar os logs de invocação da função no Amazon CloudWatch Logs.
Para simplificar, você cria sua função usando o runtime do Python ou do Node.js. Com essas linguagens interpretadas, você pode editar o código da função diretamente no editor de código integrado do console. Com linguagens compiladas como Java e C#, você deve criar um pacote de implantação em sua máquina de compilação local e carregá-lo no Lambda. Para saber mais sobre a implantação de funções no Lambda usando outros runtimes, consulte os links na seção Recursos adicionais e próximas etapas.
dica
Para saber como construir soluções com tecnologia sem servidor, confira o Guia do desenvolvedor com tecnologia sem servidor.
Pré-requisitos
Se você ainda não tem uma Conta da AWS, siga as etapas abaixo para criar uma.
Como cadastrar uma Conta da AWS
Abra https://portal.aws.amazon.com/billing/signup
. Siga as instruções online.
Parte do procedimento de inscrição envolve receber uma chamada telefônica e inserir um código de verificação no teclado do telefone.
Quando você se inscreve para uma Conta da AWS, um Usuário raiz da conta da AWS é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.
AAWS envia um e-mail de confirmação depois que o processo de cadastramento é concluído. A qualquer momento, é possível exibir as atividades da conta atual e gerenciar sua conta acessando https://aws.amazon.com/
Depois de se cadastrar em uma Conta da AWS, proteja seu Usuário raiz da conta da AWS, habilite o AWS IAM Identity Center e crie um usuário administrativo para não usar o usuário-raiz em tarefas cotidianas.
Proteger o Usuário raiz da conta da AWS
-
Faça login no AWS Management Console
como o proprietário da conta ao escolher a opção Usuário-raiz e inserir o endereço de e-mail da Conta da AWS. Na próxima página, insira a senha. Para obter ajuda ao fazer login usando o usuário-raiz, consulte Fazer login como usuário-raiz no Guia do usuário do Início de Sessão da AWS.
-
Habilite a autenticação multifator (MFA) para o usuário-raiz.
Para obter instruções, consulte Habilitar um dispositivo MFA virtual para sua Conta da AWS de usuário-raiz (console) no Guia do usuário do IAM.
Criar um usuário com acesso administrativo
-
Habilita o Centro de Identidade do IAM.
Para obter instruções, consulte Habilitar o AWS IAM Identity Center no Guia do usuário do AWS IAM Identity Center.
-
No Centro de Identidade do IAM, conceda o acesso administrativo a um usuário.
Para obter um tutorial sobre como usar o Diretório do Centro de Identidade do IAM como a fonte de identidade, consulte Configurar o acesso dos usuários com o Diretório do Centro de Identidade do IAM padrão no Guia do usuário do AWS IAM Identity Center.
Iniciar sessão como o usuário com acesso administrativo
-
Para fazer login com o seu usuário do Centro de Identidade do IAM, use o URL de login enviado ao seu endereço de e-mail quando o usuário do Centro de Identidade do IAM foi criado.
Para obter ajuda para fazer login usando um usuário do Centro de Identidade do IAM, consulte Fazer login no portal de acesso da AWS, no Guia do usuário do Início de Sessão da AWS.
Atribuir acesso a usuários adicionais
-
No Centro de Identidade do IAM, crie um conjunto de permissões que siga as práticas recomendadas de aplicação de permissões com privilégio mínimo.
Para obter instruções, consulte Criar um conjunto de permissões no Guia do usuário do AWS IAM Identity Center.
-
Atribua usuários a um grupo e, em seguida, atribua o acesso de autenticação única ao grupo.
Para obter instruções, consulte Adicionar grupos no Guia do usuário do AWS IAM Identity Center.
Criar uma função do Lambda com o console
Neste exemplo, sua função usa um objeto JSON contendo dois valores inteiros rotulados "length"
e "width"
. A função multiplica esses valores para calcular uma área e a retorna como uma string JSON.
Sua função também imprime a área calculada, junto com o nome do grupo de logs do CloudWatch. Posteriormente, no tutorial, você aprenderá a usar o CloudWatch Logs para visualizar os registros da invocação de suas funções.
Criar uma função do Lambda hello world com o console
Abra a página Funções
do console do Lambda. -
Escolha a opção Criar função.
-
Selecione Criar do zero.
-
No painel Informações básicas, para Nome da função, insira
.myLambdaFunction
-
Em Runtime, escolha Node.js 22.x ou Python 3.13.
-
Deixe arquitetura definido como x86_64 e, em seguida, escolha Criar função.
Além de uma função simples que retorna a mensagem Hello from Lambda!
, o Lambda também cria um perfil de execução para sua função. Um perfil de execução é um perfil do AWS Identity and Access Management (IAM) que concede a uma função do Lambda permissão para acessar recursos e Serviços da AWS. Para sua função, o perfil criado pelo Lambda concede permissões básicas para gravar no CloudWatch Logs.
Use o editor de código integrado do console para substituir o código Hello world criado pelo Lambda com seu próprio código de função.
Invocação da função do Lambda usando o editor de códigos do console
Para invocar sua função usando o editor de códigos do console do Lambda, crie um evento de teste para enviar à sua função. O evento é um documento formatado em JSON contendo dois pares de valores-chave com as chaves "length"
e "width"
.
Criar o evento de teste
-
Na seção TEST EVENTS do editor de código do console, escolha Criar evento de teste.
-
Em Event Name (Nome do evento), insira
myTestEvent
. -
Na seção JSON do evento, substitua o JSON padrão pelo seguinte:
{ "length": 6, "width": 7 }
-
Escolha Salvar.
Para testar sua função e exibir os registros de invocação
Na seção TEST EVENTS do editor de código do console, selecione o ícone de execução ao lado do evento de teste:

Quando sua função terminar de ser executada, os logs de resposta e função serão exibidos na guia OUTPUT. Você deve ver resultados semelhantes ao seguinte:
Ao invocar a função fora do console do Lambda, use o CloudWatch Logs para exibir os resultados de execução da função.
Para visualizar os registros de invocação da sua função no CloudWatch Logs
-
Abra a página Log groups
(Grupos de log) do console do CloudWatch. -
Escolha o nome do grupo de logs para sua função (
/aws/lambda/myLambdaFunction
). Esse é o nome do grupo de logs que sua função imprimiu no console. -
Role para baixo e selecione o Fluxo de logs para as invocações da função que você deseja verificar.
Você deve ver uma saída semelhante a:
Limpeza
Quando você tiver terminado de trabalhar com a função de exemplo, exclua-a. Você também pode excluir o grupo de logs que armazena os logs da função e a função de execução que o console criou.
Como excluir a função do Lambda
-
Abra a página Functions
(Funções) no console do Lambda. -
Selecione a função que você criou.
-
Selecione Ações, Excluir.
-
Digite
confirm
no campo de entrada de texto e escolha Delete (Excluir).
Para excluir o grupo de logs
-
Abra a página Log groups
(Grupos de log) do console do CloudWatch. -
Selecione o grupo de logs da função (
/aws/lambda/myLambdaFunction
). -
Selecione Actions (Ações), Delete log group(s) (Excluir grupo(s) de log).
-
Na caixa de diálogo Delete log group(s) (Excluir grupo(s) de logs), escolha Delete (Excluir).
Para excluir a função de execução
-
Abra a página Roles
(Funções) no console do AWS Identity and Access Management (IAM). -
Selecione o perfil de execução da função (por exemplo,
myLambdaFunction-role-
).31exxmpl
-
Escolha Excluir.
-
Na caixa de diálogo Excluir perfil, insira o nome do perfil e, em seguida, escolha Excluir.
Recursos adicionais e próximas etapas
Agora que você criou e testou uma função do Lambda simples usando o console, siga estes próximos passos:
-
Aprenda a adicionar dependências à sua função e implantá-la usando um pacote de implantação .zip. Escolha seu idioma de preferência nos links a seguir.
-
Para saber como invocar uma função do Lambda usando outro AWS service (Serviço da AWS), consulte Tutorial: Usar um acionador do Amazon S3 para invocar uma função do Lambda.
-
Escolha um dos tutoriais a seguir para obter exemplos mais complexos do uso do Lambda com outros Serviços da AWS.
-
Tutorial: Uso do Lambda com API Gateway: crie uma API REST do Amazon API Gateway que invoca uma função do Lambda.
-
Usar uma função do Lambda para acessar um banco de dados do Amazon RDS: use uma função do Lambda para gravar dados em um banco de dados do Amazon Relational Database Service (Amazon RDS) por meio do RDS Proxy.
-
Usar um trigger do Amazon S3 para criar imagens em miniatura: use uma função do Lambda para criar uma miniatura sempre que um arquivo de imagem for carregado em um bucket do Amazon S3.
-