Início Rápido: Criar uma função no Azure usando o Visual Studio CodeQuickstart: Create a function in Azure using Visual Studio Code

Neste artigo, você usará o Visual Studio Code para criar uma função baseada em biblioteca de classes C# que responde a solicitações HTTP.In this article, you use Visual Studio Code to create a C# class library-based function that responds to HTTP requests. Após testar o código localmente, implante-o no ambiente sem servidor do Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Neste artigo, você usará o Visual Studio Code para criar uma função do JavaScript que responde a solicitações HTTP.In this article, you use Visual Studio Code to create a JavaScript function that responds to HTTP requests. Após testar o código localmente, implante-o no ambiente sem servidor do Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Neste artigo, você usará o Visual Studio Code para criar uma função do TypeScript que responde a solicitações HTTP.In this article, you use Visual Studio Code to create a TypeScript function that responds to HTTP requests. Após testar o código localmente, implante-o no ambiente sem servidor do Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Neste artigo, você usará o Visual Studio Code para criar uma função do PowerShell que responde a solicitações HTTP.In this article, you use Visual Studio Code to create a PowerShell function that responds to HTTP requests. Após testar o código localmente, implante-o no ambiente sem servidor do Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Neste artigo, você usará o Visual Studio Code para criar uma função do Python que responde a solicitações HTTP.In this article, you use Visual Studio Code to create a Python function that responds to HTTP requests. Após testar o código localmente, implante-o no ambiente sem servidor do Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Neste artigo, você usará o Visual Studio Code para criar uma função do Java que responde a solicitações HTTP.In this article, you use Visual Studio Code to create a Java function that responds to HTTP requests. Após testar o código localmente, implante-o no ambiente sem servidor do Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

A realização deste início rápido gera um pequeno custo de alguns centavos de dólar ou menos em sua conta do Azure.Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.

Também há uma versão baseada na CLI deste artigo.There's also a CLI-based version of this article.

Observação

Se o Visual Studio Code não for sua ferramenta de desenvolvimento preferida, confira nossos tutoriais semelhantes para desenvolvedores Java usando Maven, Gradle e IntelliJ IDEA.If Visual Studio Code isn't your prefered development tool, check out our similar tutorials for Java developers using Maven, Gradle and IntelliJ IDEA.

Configurar seu ambienteConfigure your environment

Antes de começar, verifique se você tem os seguintes requisitos implementados:Before you get started, make sure you have the following requirements in place:

  • Node.js, versões Active LTS e versões LTS de manutenção (10.14.1 recomendada).Node.js, Active LTS and Maintenance LTS versions (10.14.1 recommended). Use o comando node --version para verificar sua versão.Use the node --version command to check your version.

Criar seu projeto localCreate your local project

Nesta seção, você usará o Visual Studio Code para criar um projeto local do Azure Functions em sua linguagem escolhida.In this section, you use Visual Studio Code to create a local Azure Functions project in your chosen language. Mais adiante neste artigo, você publicará o código de função no Azure.Later in this article, you'll publish your function code to Azure.

  1. Escolha o ícone do Azure na Barra de atividade e, em seguida, na área Azure: Functions e selecione o ícone Criar projeto... .Choose the Azure icon in the Activity bar, then in the Azure: Functions area, select the Create new project... icon.

    Escolher Criar um projeto

  2. Escolha um local de diretório para o workspace do projeto e escolha Selecionar.Choose a directory location for your project workspace and choose Select.

    Observação

    Estas etapas foram projetadas para serem concluídas fora de um workspace.These steps were designed to be completed outside of a workspace. Nesse caso, não selecione uma pasta de projeto que faz parte de um workspace.In this case, do not select a project folder that is part of a workspace.

  3. Forneça as seguintes informações nos prompts:Provide the following information at the prompts:

    • Selecione uma linguagem de programação para o seu projeto de função: Escolha C#.Select a language for your function project: Choose C#.
    • Selecione uma linguagem de programação para o seu projeto de função: Escolha JavaScript.Select a language for your function project: Choose JavaScript.
    • Selecione uma linguagem de programação para o seu projeto de função: Escolha TypeScript.Select a language for your function project: Choose TypeScript.
    • Selecione uma linguagem de programação para o seu projeto de função: Escolha PowerShell.Select a language for your function project: Choose PowerShell.
    • Selecione uma linguagem de programação para o seu projeto de função: Escolha Python.Select a language for your function project: Choose Python.

    • Selecione um alias do Python para criar um ambiente virtual: Escolha a localização do seu interpretador do Python.Select a Python alias to create a virtual environment: Choose the location of your Python interpreter. Se a localização não for mostrada, digite o caminho completo no binário do Python.If the location isn't shown, type in the full path to your Python binary.

    • Selecione uma linguagem de programação para o seu projeto de função: Escolha Java.Select a language for your function project: Choose Java.

    • Forneça uma ID de grupo: Escolha com.function.Provide a group ID: Choose com.function.

    • Forneça uma ID de artefato: Escolha myFunction.Provide an artifact ID: Choose myFunction.

    • Forneça uma versão: Escolha 1.0-SNAPSHOT.Provide a version: Choose 1.0-SNAPSHOT.

    • Forneça um nome de pacote: Escolha com.function.Provide a package name: Choose com.function.

    • Forneça um nome de aplicativo: Escolha myFunction-12345.Provide an app name: Choose myFunction-12345.

    • Selecione um modelo para a primeira função do projeto: Escolha HTTP trigger.Select a template for your project's first function: Choose HTTP trigger.

    • Forneça um nome de função: Digite HttpExample.Provide a function name: Type HttpExample.

    • Forneça um namespace: Digite My.Functions.Provide a namespace: Type My.Functions.
    • Nível de autorização: Escolha Anonymous, que permite que qualquer pessoa chame seu ponto de extremidade de função.Authorization level: Choose Anonymous, which enables anyone to call your function endpoint. Para saber mais sobre o nível de autorização, confira Chaves de autorização.To learn about authorization level, see Authorization keys.
    • Selecione como você gostaria de abrir seu projeto: Escolha Add to workspace.Select how you would like to open your project: Choose Add to workspace.
  4. Usando essas informações, o Visual Studio Code gera um projeto do Azure Functions com um gatilho HTTP.Using this information, Visual Studio Code generates an Azure Functions project with an HTTP trigger. Você pode exibir os arquivos de projeto locais no Explorer.You can view the local project files in the Explorer. Para saber mais sobre os arquivos criados, confira Arquivos de projeto gerados.To learn more about files that are created, see Generated project files.

Executar a função localmenteRun the function locally

O Visual Studio Code integra-se ao Azure Functions Core Tools para permitir que você execute esse projeto em seu computador de desenvolvimento local antes de publicar no Azure.Visual Studio Code integrates with Azure Functions Core Tools to let you run this project on your local development computer before you publish to Azure.

  1. Para chamar sua função, pressione F5 para iniciar o projeto de aplicativo de funções.To call your function, press F5 to start the function app project. A saída do Core Tools é exibida no painel Terminal.Output from Core Tools is displayed in the Terminal panel.

  2. Se ainda não tiver instalado o Azure Functions Core Tools, selecione Instalar no prompt.If you haven't already installed Azure Functions Core Tools, select Install at the prompt. Quando o Core Tools for instalado, seu aplicativo será iniciado no painel Terminal.When the Core Tools are installed, your app starts in the Terminal panel. Você pode ver o ponto de extremidade de URL de sua função disparada por HTTP localmente.You can see the URL endpoint of your HTTP-triggered function running locally.

    Saída local do Azure

  3. Com o Core Tools em execução, navegue até a URL a seguir para executar uma solicitação GET, que inclui a cadeia de caracteres de consulta ?name=Functions.With Core Tools running, navigate to the following URL to execute a GET request, which includes ?name=Functions query string.

    http://localhost:7071/api/HttpExample?name=Functions

  4. Uma resposta é retornada, semelhante ao seguinte em um navegador:A response is returned, which looks like the following in a browser:

    Resposta da função localhost no navegador

  5. As informações sobre a solicitação são mostradas no painel Terminal.Information about the request is shown in Terminal panel.

    Execução de função no painel Terminal

  6. Pressione Ctrl + C para parar o Core Tools e desconectar o depurador.Press Ctrl + C to stop Core Tools and disconnect the debugger.

Executar a função localmenteRun the function locally

O Azure Functions Core Tools é integrado ao Visual Studio Code para permitir que você execute e depure um projeto do Azure Functions localmente.Azure Functions Core Tools integrates with Visual Studio Code to let you run and debug an Azure Functions project locally. Para obter detalhes sobre como depurar no Visual Studio Code, confira Depurar o Azure Functions do PowerShell localmente.For details on how to debug in Visual Studio Code, see Debug PowerShell Azure Functions locally.

  1. Pressione F5 para iniciar o projeto de aplicativo de funções.Press F5 to start the function app project. A saída do Core Tools é exibida no painel Terminal.Output from Core Tools is displayed in the Terminal panel.

  2. No painel Terminal, copie o ponto de extremidade de URL da sua função disparada por HTTP.In the Terminal panel, copy the URL endpoint of your HTTP-triggered function.

    Saída local do Azure

  3. Acrescente a cadeia de caracteres de consulta ?name=<yourname> a esta URL e, em seguida, use Invoke-RestMethod em um segundo prompt de comando do PowerShell para executar a solicitação, da seguinte maneira:Append the query string ?name=<yourname> to this URL, and then use Invoke-RestMethod in a second PowerShell command prompt to execute the request, as follows:

    PS > Invoke-RestMethod -Method Get -Uri http://localhost:7071/api/HttpTrigger?name=PowerShell
    Hello PowerShell
    

    Você também pode executar a solicitação GET em um navegador com base na seguinte URL:You can also execute the GET request from a browser from the following URL:

    http://localhost:7071/api/HttpExample?name=PowerShell

    Quando você chama o ponto de extremidade do HttpTrigger sem passar um parâmetro name como um parâmetro de consulta ou no corpo, a função retorna um erro BadRequest.When you call the HttpTrigger endpoint without passing a name parameter either as a query parameter or in the body, the function returns a BadRequest error. Quando você examinar o código em run.ps1, verá que esse erro ocorre por design.When you review the code in run.ps1, you see that this error occurs by design.

  4. As informações sobre a solicitação são mostradas no painel Terminal.Information about the request is shown in Terminal panel.

    Execução de função no painel Terminal

  5. Ao terminar, pressione Ctrl + C para interromper o Core Tools.When done, press Ctrl + C to stop Core Tools.

Após verificar se a função foi executada corretamente no computador local, é hora de publicar o projeto no Azure.After you've verified that the function runs correctly on your local computer, it's time to publish the project to Azure.

Após verificar se a função foi executada corretamente no computador local, é hora de usar o Visual Studio Code para publicar o projeto diretamente no Azure.After you've verified that the function runs correctly on your local computer, it's time to use Visual Studio Code to publish the project directly to Azure.

Entrar no AzureSign in to Azure

Antes de poder publicar seu aplicativo, você precisa entrar no Azure.Before you can publish your app, you must sign in to Azure.

  1. Se ainda não estiver conectado, escolha o ícone do Azure na barra Atividade e, em seguida, na área Azure: Functions, escolha Entrar no Azure… . Se você ainda não tiver uma, poderá Criar uma conta gratuita do Azure .If you aren't already signed in, choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose Sign in to Azure.... If you don't already have one, you can Create a free Azure account. Os alunos podem clicar aqui para criar uma conta gratuita do Azure for StudentsStudents can click here to Create a free Azure for Students account

    Resposta da função localhost no navegador

    Se você já tiver entrado, vá para a próxima seção.If you're already signed in, go to the next section.

  2. Quando solicitado no navegador, escolha sua conta do Azure e entre usando suas credenciais de conta do Azure.When prompted in the browser, choose your Azure account and sign in using your Azure account credentials.

  3. Após entrar com êxito, você poderá fechar a nova janela do navegador.After you've successfully signed in, you can close the new browser window. As assinaturas que pertencem à sua conta do Azure são exibidas na barra lateral.The subscriptions that belong to your Azure account are displayed in the Side bar.

Publicar o projeto no AzurePublish the project to Azure

Nesta seção, você criará um aplicativo de funções e os recursos relacionados em sua assinatura do Azure e, em seguida, implantará seu código.In this section, you create a function app and related resources in your Azure subscription and then deploy your code.

Importante

Publicar em um aplicativo de funções existente substitui o conteúdo desse aplicativo no Azure.Publishing to an existing function app overwrites the content of that app in Azure.

  1. Escolha o ícone do Azure na Barra de atividade e, em seguida, na área Azure: Functions, escolha o botão Implantar no aplicativo de funções... .Choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose the Deploy to function app... button.

    Publicar seu projeto no Azure

  2. Forneça as seguintes informações nos prompts:Provide the following information at the prompts:

    • Selecione a pasta: escolha uma pasta do seu workspace ou navegue até uma que contenha seu aplicativo de funções.Select folder: Choose a folder from your workspace or browse to one that contains your function app. Você não verá isso se já tiver um aplicativo de funções válido aberto.You won't see this if you already have a valid function app opened.

    • Selecione a assinatura: Escolha a assinatura a ser usada.Select subscription: Choose the subscription to use. Essa opção não será exibida caso você possua apenas uma assinatura.You won't see this if you only have one subscription.

    • Selecione o aplicativo de funções no Azure: Escolha + Create new Function App.Select Function App in Azure: Choose + Create new Function App. (Não escolha a opção Advanced, que não é abordada neste artigo.)(Don't choose the Advanced option, which isn't covered in this article.)

    • Insira um nome exclusivo globalmente para o aplicativo de funções: Digite um nome que seja válido em um caminho de URL.Enter a globally unique name for the function app: Type a name that is valid in a URL path. O nome que você digitar é validado para ter certeza de que ele é exclusivo no Azure Functions.The name you type is validated to make sure that it's unique in Azure Functions.

    • Selecione um runtime: Escolha a versão do Python em que você está executando localmente.Select a runtime: Choose the version of Python you've been running on locally. É possível usar o comando python --version para verificar sua versão.You can use the python --version command to check your version.
    • Selecione um runtime: Escolha a versão do Node.js em que você está executando localmente.Select a runtime: Choose the version of Node.js you've been running on locally. É possível usar o comando node --version para verificar sua versão.You can use the node --version command to check your version.
    • Selecione uma localização para novos recursos: Para obter um melhor desempenho, escolha uma região perto de você.Select a location for new resources: For better performance, choose a region near you.
  3. Quando concluído, os seguintes recursos do Azure serão criados em sua assinatura, usando nomes baseados em seu nome do aplicativo de funções:When completed, the following Azure resources are created in your subscription, using names based on your function app name:

    • Um grupo de recursos, que é um contêiner lógico para recursos relacionados.A resource group, which is a logical container for related resources.
    • Uma conta de Armazenamento do Azure padrão, que mantém o estado e outras informações sobre seus projetos.A standard Azure Storage account, which maintains state and other information about your projects.
    • Um plano de consumo, que define o host subjacente para o aplicativo de funções sem servidor.A consumption plan, which defines the underlying host for your serverless function app.
    • Um aplicativo de funções, que fornece o ambiente para a execução do código de função.A function app, which provides the environment for executing your function code. Um aplicativo de funções lhe permite agrupar funções como uma unidade lógica para facilitar o gerenciamento, a implantação e o compartilhamento de recursos dentro do mesmo plano de hospedagem.A function app lets you group functions as a logical unit for easier management, deployment, and sharing of resources within the same hosting plan.
    • Uma instância do Application Insights conectada ao aplicativo de funções, que controla o uso de sua função sem servidor.An Application Insights instance connected to the function app, which tracks usage of your serverless function.

    Uma notificação é exibida depois que seu aplicativo de funções é criado e o pacote de implantação é aplicado.A notification is displayed after your function app is created and the deployment package is applied.

  4. Escolha Exibir Saída nessa notificação para exibir a criação e os resultados da implantação, incluindo os recursos do Azure que você criou.Select View Output in this notification to view the creation and deployment results, including the Azure resources that you created. Se você perder a notificação, selecione o ícone de sino no canto inferior direito para vê-lo novamente.If you miss the notification, select the bell icon in the lower right corner to see it again.

    Criar notificação completa

Executar a função no AzureRun the function in Azure

  1. De volta na área Azure: Functions na barra lateral, expanda o novo aplicativo de funções em sua assinatura.Back in the Azure: Functions area in the side bar, expand the new function app under your subscription. Expanda Funções, clique com o botão direito do mouse (Windows) ou Ctrl + clique (macOS) em HttpExample e escolha Copiar URL de função.Expand Functions, right-click (Windows) or Ctrl + click (macOS) on HttpExample, and then choose Copy function URL.

    Copiar a URL da função para o novo gatilho HTTP

  2. Cole essa URL para a solicitação HTTP na barra de endereços do navegador, adicione a cadeia de caracteres de consulta name como ?name=Functions no final desta URL e, em seguida, execute a solicitação.Paste this URL for the HTTP request into your browser's address bar, add the name query string as ?name=Functions to the end of this URL, and then execute the request. A URL que chama a função HTTP disparada deve estar no seguinte formato:The URL that calls your HTTP-triggered function should be in the following format:

    http://<functionappname>.azurewebsites.net/api/httpexample?name=Functions
    

    O seguinte exemplo mostra a resposta no navegador à solicitação GET remota retornada pela função:The following example shows the response in the browser to the remote GET request returned by the function:

    Resposta da função no navegador

Limpar os recursosClean up resources

Quando você passar para a próxima etapa, Adicionar uma associação de fila do Armazenamento do Azure à sua função, você precisará manter todos os seus recursos em vigor para se basear no que você já fez.When you continue to the next step, Add an Azure Storage queue binding to your function, you'll need to keep all your resources in place to build on what you've already done.

Caso contrário, você poderá usar as etapas a seguir para excluir o aplicativo de funções e recursos relacionados para evitar incorrer em custos adicionais.Otherwise, you can use the following steps to delete the function app and its related resources to avoid incurring any further costs.

  1. No Visual Studio Code, pressione F1 para abrir a paleta de comandos.In Visual Studio Code, press F1 to open the command palette. Na paleta de comandos, pesquise e selecione Azure Functions: Open in portal.In the command palette, search for and select Azure Functions: Open in portal.

  2. Escolha seu aplicativo de funções e pressione Enter.Choose your function app, and press Enter. A página do aplicativo de funções é aberta no portal do Azure.The function app page opens in the Azure portal.

  3. Na guia Visão geral, selecione o link nomeado ao lado de Grupo de recursos.In the Overview tab, select the named link next to Resource group.

    Selecione o grupo de recursos a ser excluído da página do aplicativo de funções.

  4. Na página Grupo de recursos, examine a lista de recursos incluídos e verifique se eles são aqueles que deseja excluir.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  5. Selecione Excluir grupo de recursos e siga as instruções.Select Delete resource group, and follow the instructions.

    A exclusão poderá levar alguns minutos.Deletion may take a couple of minutes. Ao ser concluída, uma notificação será exibida por alguns segundos.When it's done, a notification appears for a few seconds. Também é possível selecionar o ícone de sino na parte superior da página para exibir a notificação.You can also select the bell icon at the top of the page to view the notification.

Para saber mais sobre os custos do Functions, confira Estimar os custos do plano de consumo.To learn more about Functions costs, see Estimating Consumption plan costs.

Próximas etapasNext steps

Você usou o Visual Studio Code para criar um aplicativo de funções com uma função disparada por HTTP simples.You have used Visual Studio Code to create a function app with a simple HTTP-triggered function. No próximo artigo, você pode expandir essa função adicionando uma associação de saída.In the next article, you expand that function by adding an output binding. Essa associação grava a cadeia de caracteres da solicitação HTTP em uma mensagem em uma fila do Armazenamento de Filas do Azure.This binding writes the string from the HTTP request to a message in an Azure Queue Storage queue.