# 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\$1, 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](#getting-started-more-resources). **dica** Para saber como construir **soluções com tecnologia sem servidor**, confira o [Guia do desenvolvedor com tecnologia sem servidor](https://docs.aws.amazon.com/serverless/latest/devguide/). ## Pré-requisitos ### Inscrever-se para uma Conta da AWS Se você ainda não tem uma Conta da AWS, siga as etapas abaixo para criar uma. **Como cadastrar uma Conta da AWS** 1. Abra [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup). 1. Siga as instruções online. Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). A AWS envia um e-mail de confirmação depois que o processo de inscrição é concluído. A qualquer momento, é possível exibir as atividades da conta atual e gerenciar sua conta acessando [https://aws.amazon.com/](https://aws.amazon.com/) e selecionando **Minha conta**. ### Criar um usuário com acesso administrativo Depois de se cadastrar em uma Conta da AWS, proteja seu Usuário raiz da conta da AWS, habilite o Centro de Identidade do AWS IAM 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** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/) 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](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) no *Guia do usuário do Início de Sessão da AWS*. 1. 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)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) no *Guia do usuário do IAM*. **Criar um usuário com acesso administrativo** 1. Habilita o Centro de Identidade do IAM. Para obter instruções, consulte [Habilitar o Centro de Identidade do AWS IAM](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) no *Guia do usuário do Centro de Identidade do AWS IAM*. 1. 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](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) no *Guia do usuário do Centro de Identidade do AWS IAM*. **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](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html), no *Guia do usuário do Início de Sessão da AWS*. **Atribuir acesso a usuários adicionais** 1. 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](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) no *Guia do usuário do Centro de Identidade do AWS IAM*. 1. Atribua usuários a um grupo e, em seguida, atribua o acesso de logon único ao grupo. Para obter instruções, consulte [Adicionar grupos](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) no *Guia do usuário do Centro de Identidade do AWS IAM*. ## 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) para visualizar os registros da invocação de suas funções. **Criar uma função do Lambda hello world com o console** 1. Abra a [página Funções](https://console.aws.amazon.com/lambda/home#/functions) do console do Lambda. 1. Escolha a opção **Criar função**. 1. Selecione **Criar do zero**. 1. No painel **Informações básicas**, para **Nome da função**, insira `myLambdaFunction`. 1. Em **Runtime**, escolha **Node.js 24** ou **Python 3.14**. 1. Deixe **arquitetura** definido como **x86\$164** 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](lambda-intro-execution-role.md) 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. ------ #### [ Node.js ] **Modificar o código no console** 1. Escolha a guia **Código**. No editor de código integrado do console, você deve ver o código da função que o Lambda criou. Se você não vir a guia **index.mjs** no editor de código, selecione **index.mjs** no explorador de arquivos, conforme mostrado no diagrama a seguir. ![\[\]](http://docs.aws.amazon.com/pt_br/lambda/latest/dg/images/getting-started-tutorial/nodejs_code_editor.png) 1. Cole o código a seguir na guia **index.mjs**, substituindo o código que o Lambda criou. ``` export const handler = async (event, context) => { const length = event.length; const width = event.width; let area = calculateArea(length, width); console.log(`The area is ${area}`); console.log('CloudWatch log group: ', context.logGroupName); let data = { "area": area, }; return JSON.stringify(data); function calculateArea(length, width) { return length * width; } }; ``` 1. Na seção **DEPLOY**, escolha **Implantar** para atualizar o código da função: ![\[\]](http://docs.aws.amazon.com/pt_br/lambda/latest/dg/images/getting-started-tutorial/deploy-console.png) **Entender seu código de função** Antes de passar para a próxima etapa, vamos analisar o código da função e entender alguns conceitos-chave do Lambda. + O manipulador do Lambda: Sua função Lambda contém uma função Node.js chamada `handler`. Uma função do Lambda em Node.js pode conter mais de uma função Node.js, mas a função *manipuladora* é sempre o ponto de entrada para seu código. Quando sua função é invocada, o Lambda executa esse método. Quando você criou sua função Hello world usando o console, o Lambda definiu automaticamente o nome do método manipulador para sua função como `handler`. Certifique-se de não editar o nome dessa função Node.js. Caso faça isso, o Lambda não poderá executar seu código quando você invocar sua função. Para saber mais sobre o manipulador Lambda em Node.js, consulte [Definir o manipulador de função do Lambda em Node.js](nodejs-handler.md). + O objeto do evento Lambda: A função `handler` recebe dois argumentos, `event` e `context`. Um *evento* no Lambda corresponde a um documento formatado em JSON que contém dados para a sua função processar. Se sua função for invocada por outro AWS service (Serviço da AWS), o objeto de evento via conter informações sobre o evento que causou a invocação. Por exemplo, se sua função for invocada ao fazer o upload de um objeto em um bucket do Amazon Simple Storage Service (Amazon S3), o evento vai conter o nome do bucket e a chave do objeto. Neste exemplo, você criará um evento no console inserindo um documento formatado em JSON com dois pares de valores-chave. + O objeto de contexto Lambda: O segundo argumento que sua função assume é `context`. O Lambda passa o *objeto de contexto* para sua função automaticamente. O objeto de contexto contém informações sobre a invocação da função e o ambiente de execução. Você pode usar o objeto de contexto para gerar informações sobre a invocação da sua função para fins de monitoramento. Neste exemplo, sua função usa o parâmetro `logGroupName` para gerar o nome de seu grupo de logs do CloudWatch. Para saber mais sobre o objeto de contexto do Lambda em Node.js, consulte [Usar o objeto de contexto do Lambda para recuperar informações das funções em Node.js](nodejs-context.md). + Registro em log no Lambda: Com o Node.js, você pode usar métodos de console, como `console.log` e `console.error`, para enviar informações para o log da sua função. O código de exemplo usa instruções `console.log` para gerar a área calculada e o nome do grupo de logs do CloudWatch da função. Você também pode usar qualquer biblioteca de registro em log que grava em `stdout` ou `stderr`. Para saber mais, consulte [Registrar em log e monitorar funções do Lambda em Node.js](nodejs-logging.md). Para saber mais sobre registro em log em outros runtimes, consulte as páginas “Criar com” para ver os runtimes nos quais você está interessado. ------ #### [ Python ] **Modificar o código no console** 1. Escolha a guia **Código**. No editor de código integrado do console, você deve ver o código da função que o Lambda criou. Se você não vir a guia **lambda\$1function.py** no editor de código, selecione **lambda\$1function.py** no explorador de arquivos, conforme mostrado no diagrama a seguir. ![\[\]](http://docs.aws.amazon.com/pt_br/lambda/latest/dg/images/getting-started-tutorial/python_code_editor.png) 1. Cole o código a seguir na guia **lambda\$1function.py**, substituindo o código que o Lambda criou. ``` import json import logging logger = logging.getLogger() logger.setLevel(logging.INFO) def lambda_handler(event, context): # Get the length and width parameters from the event object. The # runtime converts the event object to a Python dictionary length = event['length'] width = event['width'] area = calculate_area(length, width) print(f"The area is {area}") logger.info(f"CloudWatch logs group: {context.log_group_name}") # return the calculated area as a JSON string data = {"area": area} return json.dumps(data) def calculate_area(length, width): return length*width ``` 1. Na seção **DEPLOY**, escolha **Implantar** para atualizar o código da função: ![\[\]](http://docs.aws.amazon.com/pt_br/lambda/latest/dg/images/getting-started-tutorial/deploy-console.png) **Entender seu código de função** Antes de passar para a próxima etapa, vamos analisar o código da função e entender alguns conceitos-chave do Lambda. + O manipulador do Lambda: Sua função do Lambda contém uma função Python chamada `lambda_handler`. Uma função do Lambda em Python pode conter mais de uma função Python, mas a função *manipulador* é sempre o ponto de entrada para seu código. Quando sua função é invocada, o Lambda executa esse método. Quando você criou sua função Hello world usando o console, o Lambda definiu automaticamente o nome do método manipulador para sua função como `lambda_handler`. Certifique-se de não editar o nome dessa função Python. Caso faça isso, o Lambda não poderá executar seu código quando você invocar sua função. Para saber mais sobre o manipulador Lambda em Python, consulte [Definir o manipulador de função do Lambda em Python](python-handler.md). + O objeto do evento Lambda: A função `lambda_handler` recebe dois argumentos, `event` e `context`. Um *evento* no Lambda corresponde a um documento formatado em JSON que contém dados para a sua função processar. Se sua função for invocada por outro AWS service (Serviço da AWS), o objeto de evento via conter informações sobre o evento que causou a invocação. Por exemplo, se sua função for invocada ao fazer o upload de um objeto em um bucket do Amazon Simple Storage Service (Amazon S3), o evento vai conter o nome do bucket e a chave do objeto. Neste exemplo, você criará um evento no console inserindo um documento formatado em JSON com dois pares de valores-chave. + O objeto de contexto Lambda: O segundo argumento que sua função assume é `context`. O Lambda passa o *objeto de contexto* para sua função automaticamente. O objeto de contexto contém informações sobre a invocação da função e o ambiente de execução. Você pode usar o objeto de contexto para gerar informações sobre a invocação da sua função para fins de monitoramento. Neste exemplo, sua função usa o parâmetro `log_group_name` para gerar o nome de seu grupo de logs do CloudWatch. Para saber mais sobre o objeto de contexto do Lambda em Python, consulte [Usar o objeto de contexto do Lambda para recuperar informações das funções em Python](python-context.md). + Registro em log no Lambda: Com o Python, você pode usar uma instrução `print` ou uma biblioteca de registro em log do Python para enviar informações ao log da sua função. Para ilustrar a diferença no que é capturado, o código de exemplo usa os dois métodos. Em uma aplicação de produção, recomendamos que você use uma biblioteca de registro em log. Para saber mais, consulte [Registrar em log e monitorar funções do Lambda em Python](python-logging.md). Para saber mais sobre registro em log em outros runtimes, consulte as páginas “Criar com” para ver os runtimes nos quais você está interessado. ------ ## 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** 1. Na seção **TEST EVENTS** do editor de código do console, escolha **Criar evento de teste**. ![\[\]](http://docs.aws.amazon.com/pt_br/lambda/latest/dg/images/getting-started-tutorial/test-event.png) 1. Em **Event Name (Nome do evento)**, insira **myTestEvent**. 1. Na seção **JSON do evento**, substitua o JSON padrão pelo seguinte: ``` { "length": 6, "width": 7 } ``` 1. 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: ![\[\]](http://docs.aws.amazon.com/pt_br/lambda/latest/dg/images/getting-started-tutorial/run-test-event.png) 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: ------ #### [ Node.js ] ``` Status: Succeeded Test Event Name: myTestEvent Response "{\"area\":42}" Function Logs START RequestId: 5c012b0a-18f7-4805-b2f6-40912935034a Version: $LATEST 2024-08-31T23:39:45.313Z 5c012b0a-18f7-4805-b2f6-40912935034a INFO The area is 42 2024-08-31T23:39:45.331Z 5c012b0a-18f7-4805-b2f6-40912935034a INFO CloudWatch log group: /aws/lambda/myLambdaFunction END RequestId: 5c012b0a-18f7-4805-b2f6-40912935034a REPORT RequestId: 5c012b0a-18f7-4805-b2f6-40912935034a Duration: 20.67 ms Billed Duration: 21 ms Memory Size: 128 MB Max Memory Used: 66 MB Init Duration: 163.87 ms Request ID 5c012b0a-18f7-4805-b2f6-40912935034a ``` ------ #### [ Python ] ``` Status: Succeeded Test Event Name: myTestEvent Response "{\"area\": 42}" Function Logs START RequestId: 2d0b1579-46fb-4bf7-a6e1-8e08840eae5b Version: $LATEST The area is 42 [INFO] 2024-08-31T23:43:26.428Z 2d0b1579-46fb-4bf7-a6e1-8e08840eae5b CloudWatch logs group: /aws/lambda/myLambdaFunction END RequestId: 2d0b1579-46fb-4bf7-a6e1-8e08840eae5b REPORT RequestId: 2d0b1579-46fb-4bf7-a6e1-8e08840eae5b Duration: 1.42 ms Billed Duration: 2 ms Memory Size: 128 MB Max Memory Used: 39 MB Init Duration: 123.74 ms Request ID 2d0b1579-46fb-4bf7-a6e1-8e08840eae5b ``` ------ 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** 1. Abra a [página Log groups](https://console.aws.amazon.com/cloudwatch/home#logs:) (Grupos de log) do console do CloudWatch. 1. 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. 1. Role para baixo e selecione o **Fluxo de logs** para as invocações da função que você deseja verificar. ![\[\]](http://docs.aws.amazon.com/pt_br/lambda/latest/dg/images/log-stream.png) Você deve ver uma saída semelhante a: ------ #### [ Node.js ] ``` INIT_START Runtime Version: nodejs:22.v13 Runtime Version ARN: arn:aws:lambda:us-west-2::runtime:e3aaabf6b92ef8755eaae2f4bfdcb7eb8c4536a5e044900570a42bdba7b869d9 START RequestId: aba6c0fc-cf99-49d7-a77d-26d805dacd20 Version: $LATEST 2024-08-23T22:04:15.809Z 5c012b0a-18f7-4805-b2f6-40912935034a INFO The area is 42 2024-08-23T22:04:15.810Z aba6c0fc-cf99-49d7-a77d-26d805dacd20 INFO CloudWatch log group: /aws/lambda/myLambdaFunction END RequestId: aba6c0fc-cf99-49d7-a77d-26d805dacd20 REPORT RequestId: aba6c0fc-cf99-49d7-a77d-26d805dacd20 Duration: 17.77 ms Billed Duration: 18 ms Memory Size: 128 MB Max Memory Used: 67 MB Init Duration: 178.85 ms ``` ------ #### [ Python ] ``` INIT_START Runtime Version: python:3.13.v16 Runtime Version ARN: arn:aws:lambda:us-west-2::runtime:ca202755c87b9ec2b58856efb7374b4f7b655a0ea3deb1d5acc9aee9e297b072 START RequestId: 9d4096ee-acb3-4c25-be10-8a210f0a9d8e Version: $LATEST The area is 42 [INFO] 2024-09-01T00:05:22.464Z 9315ab6b-354a-486e-884a-2fb2972b7d84 CloudWatch logs group: /aws/lambda/myLambdaFunction END RequestId: 9d4096ee-acb3-4c25-be10-8a210f0a9d8e REPORT RequestId: 9d4096ee-acb3-4c25-be10-8a210f0a9d8e Duration: 1.15 ms Billed Duration: 2 ms Memory Size: 128 MB Max Memory Used: 40 MB ``` ------ ## 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](lambda-intro-execution-role.md) que o console criou. **Como excluir a função do Lambda** 1. Abra a página [Functions](https://console.aws.amazon.com/lambda/home#/functions) (Funções) no console do Lambda. 1. Selecione a função que você criou. 1. Selecione **Ações**, **Excluir**. 1. Digite **confirm** no campo de entrada de texto e escolha **Delete** (Excluir). **Para excluir o grupo de logs** 1. Abra a [página Log groups](https://console.aws.amazon.com/cloudwatch/home#logs:) (Grupos de log) do console do CloudWatch. 1. Selecione o grupo de logs da função (`/aws/lambda/myLambdaFunction`). 1. Selecione **Actions (Ações)**, **Delete log group(s) (Excluir grupo(s) de log)**. 1. 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** 1. Abra a [página Roles](https://console.aws.amazon.com/iam/home?#/roles) (Funções) no console do AWS Identity and Access Management (IAM). 1. Selecione o perfil de execução da função (por exemplo, `myLambdaFunction-role-31exxmpl`). 1. Escolha **Excluir**. 1. 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. ------ #### [ Node.js ] [Implantar funções do Lambda em Node.js com arquivos .zip](nodejs-package.md) ------ #### [ Typescript ] [Implantar código TypeScript transcompilado no Lambda com arquivos .zip](typescript-package.md) ------ #### [ Python ] [Trabalhar com arquivos .zip para funções do Lambda em Python](python-package.md) ------ #### [ Ruby ] [Implantar funções do Lambda em Ruby com arquivos .zip](ruby-package.md) ------ #### [ Java ] [Implantar funções do Lambda em Java com arquivos .zip ou JAR](java-package.md) ------ #### [ Go ] [Implantar funções do Lambda em Go com arquivos .zip](golang-package.md) ------ #### [ C\$1 ] [Criar e implantar funções do Lambda em C\$1 com arquivos .zip](csharp-package.md) ------ + 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](with-s3-example.md). + 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](services-apigateway-tutorial.md): 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](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-lambda-tutorial.html): 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](with-s3-tutorial.md): use uma função do Lambda para criar uma miniatura sempre que um arquivo de imagem for carregado em um bucket do Amazon S3.