Criar sua primeira função no portal do AzureCreate your first function in the Azure portal

O Azure Functions lhe permite executar seu código em um ambiente sem servidor sem que seja preciso primeiro criar uma VM ou publicar um aplicativo Web.Azure Functions lets you execute your code in a serverless environment without having to first create a VM or publish a web application. Neste artigo, aprenda a usar o Functions para criar a função "Olá, Mundo" no portal do Azure.In this article, learn how to use Functions to create a "hello world" function in the Azure portal.

Criar um aplicativo de funções no portal do Azure

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Observação

Os desenvolvedores de C# devem considerar criar sua primeira função no Visual Studio 2019 em vez de usar o portal.C# developers should consider creating your first function in Visual Studio 2019 instead of in the portal.

Fazer logon no AzureLog in to Azure

Entre no portal do Azure em https://portal.azure.com com sua conta do Azure.Sign in to the Azure portal at https://portal.azure.com with your Azure account.

Criar um aplicativo de funçõesCreate a function app

Você deve ter um aplicativo de funções para hospedar a execução de suas funções.You must have a function app to host the execution of your functions. Um aplicativo de funções permite a você agrupar funções como uma unidade lógica para facilitar o gerenciamento, implantação e compartilhamento de recursos.A function app lets you group functions as a logic unit for easier management, deployment, and sharing of resources.

  1. No menu do portal do Azure, selecione Criar um recurso.From the Azure portal menu, select Create a resource.

    Adicionar recurso usando o menu do portal do Azure

  2. Na página Novo, selecione Computação > Aplicativo de Funções.In the New page, select Compute > Function App.

  3. Use as configurações do aplicativo de funções especificadas na tabela abaixo da imagem.Use the function app settings as specified in the table below the image.

    Noções básicas

    ConfiguraçãoSetting Valor sugeridoSuggested value DESCRIÇÃODescription
    AssinaturaSubscription Sua assinaturaYour subscription A assinatura na qual este novo aplicativo de funções será criado.The subscription under which this new function app is created.
    Grupo de RecursosResource Group myResourceGroupmyResourceGroup Nome do novo grupo de recursos no qual criar o seu aplicativo de funções.Name for the new resource group in which to create your function app.
    Nome do aplicativo de funçõesFunction App name Nome globalmente exclusivoGlobally unique name Nome que identifica seu novo aplicativo de funções.Name that identifies your new function app. Os caracteres válidos são a-z (não diferencia maiúsculas de minúsculas), 0-9 e -.Valid characters are a-z (case insensitive), 0-9, and -.
    PublicarPublish CódigoCode Opção para publicar arquivos de código ou um contêiner do Docker.Option to publish code files or a Docker container.
    Pilha de runtimeRuntime stack Linguagem preferencialPreferred language Escolha um runtime compatível com sua linguagem de programação de funções favorita.Choose a runtime that supports your favorite function programming language. Escolha .NET para funções C# e F#.Choose .NET for C# and F# functions.
    RegiãoRegion Região preferencialPreferred region Escolha uma região perto de você ou perto de outros serviços que suas funções acessam.Choose a region near you or near other services your functions access.

    Selecione o botão Avançar: Hospedagem > .Select the Next : Hosting > button.

  4. Insira as configurações a seguir para a hospedagem.Enter the following settings for hosting.

    Hosting

    ConfiguraçãoSetting Valor sugeridoSuggested value DESCRIÇÃODescription
    Conta de armazenamentoStorage account Nome globalmente exclusivoGlobally unique name Crie uma conta de armazenamento usada pelo seu aplicativo de funções.Create a storage account used by your function app. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres e podem conter apenas números e letras minúsculas.Storage account names must be between 3 and 24 characters in length and may contain numbers and lowercase letters only. Use também uma conta existente, que precisará atender aos requisitos da conta de armazenamento.You can also use an existing account, which must meet the storage account requirements.
    Sistema operacionalOperating system Sistema operacional preferencialPreferred operating system Um sistema operacional é pré-selecionado para você com base na seleção da pilha de runtime, mas você pode alterar a configuração, se necessário.An operating system is pre-selected for you based on your runtime stack selection, but you can change the setting if necessary.
    PlanoPlan Plano de consumoConsumption plan Plano de hospedagem que define como os recursos são alocados para seu aplicativo de funções.Hosting plan that defines how resources are allocated to your function app. No Plano de Consumo padrão, os recursos são adicionados dinamicamente conforme exigido por suas funções.In the default Consumption Plan, resources are added dynamically as required by your functions. Nesta hospedagem sem servidor, você só paga pelo tempo durante o qual suas funções são executadas.In this serverless hosting, you only pay for the time your functions run. Quando você executa em um Plano do Serviço de Aplicativo, deve gerenciar o dimensionamento do aplicativo de funções.When you run in an App Service plan, you must manage the scaling of your function app.

    Selecione o botão Avançar: Monitoramento > .Select the Next : Monitoring > button.

  5. Insira as configurações a seguir para o monitoramento.Enter the following settings for monitoring.

    Monitoramento

    ConfiguraçãoSetting Valor sugeridoSuggested value DESCRIÇÃODescription
    Application InsightsApplication Insights PadrãoDefault Cria um recurso do Application Insights do mesmo nome do aplicativo na região com suporte mais próxima.Creates an Application Insights resource of the same App name in the nearest supported region. Ao expandir essa configuração, você pode alterar o Novo nome do recurso ou escolher um Local diferente em uma geografia do Azure onde deseja armazenar seus dados.By expanding this setting, you can change the New resource name or choose a different Location in an Azure geography where you want to store your data.

    Selecione Examinar + Criar para examinar as seleções de configuração de aplicativo.Select Review + Create to review the app configuration selections.

  6. Selecione Criar para provisionar e implantar o aplicativo de funções.Select Create to provision and deploy the function app.

  7. Selecione o ícone da Notificação no canto superior direito do portal e veja se a mensagem Implantação concluída com êxito é exibida.Select the Notification icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

    Notificação de implantação

  8. Selecione Ir para recursos para exibir o novo aplicativo de funções.Select Go to resource to view your new function app. Você também pode selecionar Fixar no painel.You can also select Pin to dashboard. A fixação torna mais fácil retornar a esse recurso de aplicativo de função no seu painel.Pinning makes it easier to return to this function app resource from your dashboard.

Em seguida, crie uma nova função no novo aplicativo de funções.Next, you create a function in the new function app.

Criar uma função disparada por HTTPCreate an HTTP triggered function

  1. Expanda seu novo aplicativo de funções e selecione o botão + ao lado de Functions, escolha No portal e selecione Continuar.Expand your new function app, then select the + button next to Functions, choose In-portal, and select Continue.

    Início rápido de funções para escolher uma plataforma.

  2. Escolha WebHook + API e, em seguida, selecione Criar.Choose WebHook + API and then select Create.

    Início rápido de funções no Portal do Azure.

Uma função é criada usando um modelo específico a um idioma para uma função disparada por HTTP.A function is created using a language-specific template for an HTTP triggered function.

Agora você pode executar a nova função enviando uma solicitação HTTP.Now, you can run the new function by sending an HTTP request.

Testar a funçãoTest the function

  1. Em sua nova função, clique em </> Obter URL da função na parte superior direita, selecione padrão (Tecla de função) e depois clique em Copiar.In your new function, click </> Get function URL at the top right, select default (Function key), and then click Copy.

    Copiar a URL da função do Portal do Azure

  2. Cole a URL de função na barra de endereços do navegador.Paste the function URL into your browser's address bar. Adicione o valor da cadeia de caracteres de consulta &name=<yourname> ao final desta URL e pressione Enter em seu teclado para executar a solicitação.Add the query string value &name=<yourname> to the end of this URL and press the Enter key on your keyboard to execute the request. Você deverá ver a resposta retornada pela função exibida no navegador.You should see the response returned by the function displayed in the browser.

    O exemplo a seguir mostra a resposta no navegador:The following example shows the response in the browser:

    Resposta da função no navegador.

    A URL da solicitação inclui uma chave que é necessária, por padrão, para acessar sua função via HTTP.The request URL includes a key that is required, by default, to access your function over HTTP.

  3. Quando a função é executada, informações de rastreamento são gravadas nos logs.When your function runs, trace information is written to the logs. Para ver a saída do rastreamento da execução anterior, volte para sua função no portal e clique na seta na parte inferior da tela para expandir os Logs.To see the trace output from the previous execution, return to your function in the portal and click the arrow at the bottom of the screen to expand the Logs.

    Visualizador de log de função no Portal do Azure.

Limpar recursosClean up resources

Outros inícios rápidos nessa coleção aproveitam esse início rápido.Other quick starts in this collection build upon this quick start. Se você planeja trabalhar com inícios rápidos subsequentes, tutoriais ou com qualquer serviço criado por você nesse início rápido, não limpe os recursos.If you plan to work with subsequent quick starts, tutorials, or with any of the services you have created in this quick start, do not clean up the resources.

Os Recursos no Azure se referem a aplicativos de funções, funções, contas de armazenamento e assim por diante.Resources in Azure refers to function apps, functions, storage accounts, and so forth. Eles são agrupados em grupos de recursos, e você pode excluir tudo junto ao excluir o grupo.They are grouped into resource groups, and you can delete everything in a group by deleting the group.

Você criou recursos para concluir esses guias de início rápido.You created resources to complete these quickstarts. Você pode ser cobrado por esses recursos, dependendo do status de conta e preços do serviço.You may be billed for these resources, depending on your account status and service pricing. Caso não precise mais dos recursos, é possível excluí-los desta maneira:If you don't need the resources anymore, here's how to delete them:

  1. No portal do Azure, vá até a página Grupo de recursos.In the Azure portal, go to the Resource group page.

    Para ir até essa página a partir da página de aplicativo de funções, selecione a guia Visão geral e depois selecione o link em Grupo de recursos.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    Selecione o grupo de recursos para excluir a partir da página do aplicativo de funções.

    Para ir até essa página a partir do painel, selecione Grupos de recursos e depois selecione o grupo de recursos que você usou para esse guia de início rápido.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

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

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

Próximas etapasNext steps

Você criou um aplicativo de funções com uma função simples disparada por HTTP.You've created a function app with a simple HTTP triggered function.

Agora que você criou sua primeira função, vamos adicionar uma associação de saída à função que grava uma mensagem na fila Armazenamento.Now that you have created your first function, let's add an output binding to the function that writes a message to a Storage queue.

Para obter mais informações, veja Associações HTTP do Azure Functions.For more information, see Azure Functions HTTP bindings.