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

As Funções Azure permitem executar o seu código num ambiente sem servidor sem ter de criar primeiro uma máquina virtual (VM) ou publicar uma aplicação web.Azure Functions lets you run your code in a serverless environment without having to first create a virtual machine (VM) or publish a web application. Neste artigo, aprende a usar as Funções Azure para criar uma função de gatilho HTTP "hello world" no portal Azure.In this article, you learn how to use Azure Functions to create a "hello world" HTTP trigger function in the Azure portal.

Recomendamos que desenvolva as suas funções localmente e publique numa aplicação de função em Azure.We recommend that you develop your functions locally and publish to a function app in Azure.
Use um dos seguintes links para começar com o seu ambiente de desenvolvimento local escolhido e linguagem:Use one of the following links to get started with your chosen local development environment and language:

Visual Studio CodeVisual Studio Code Solicitação de terminal/comandoTerminal/command prompt Visual StudioVisual Studio
• Começar com C #• Get started with C#
• Começa com a Java.• Get started with Java
• Começar com JavaScript• Get started with JavaScript
• Começa com o PowerShell• Get started with PowerShell
• Começa com a Python• Get started with Python
• Começar com C #• Get started with C#
• Começa com a Java.• Get started with Java
• Começar com JavaScript• Get started with JavaScript
• Começa com o PowerShell• Get started with PowerShell
• Começa com a Python• Get started with Python
Começar com C #Get started with C#

Se não tiver uma subscrição 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.

Iniciar sessão no AzureSign in to Azure

Inicie sessão no portal do Azure com a sua conta do Azure.Sign in to the Azure portal with your Azure account.

Criar uma aplicação de funçõesCreate a function app

Precisa de uma aplicação Function App para alojar a execução das suas funções.You must have a function app to host the execution of your functions. Uma aplicação de função permite-lhe agrupar funções como uma unidade lógica para facilitar a gestão, implementação, escala e partilha de recursos.A function app lets you group functions as a logical unit for easier management, deployment, scaling, and sharing of resources.

  1. A partir do menu do portal do Azure ou a partir da Home page, selecione Criar um recurso.From the Azure portal menu or the Home page, select Create a resource.

  2. Na nova página, selecione App de Função computacional > Function App.In the New page, select Compute > Function App.

  3. Na página Basics, utilize as definições da aplicação de função conforme especificado na tabela seguinte.On the Basics page, use the function app settings as specified in the following table.

    DefiniçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    SubscriçãoSubscription A sua subscriçãoYour subscription A subscrição sob a qual esta nova aplicação de função é criada.The subscription under which this new function app is created.
    Grupo de RecursosResource Group myResourceGroupmyResourceGroup Nome do grupo de recursos novo no qual a aplicação Function App vai ser criada.Name for the new resource group in which to create your function app.
    Nome da app de funçãoFunction App name Nome globalmente exclusivoGlobally unique name Nome que identifica a sua aplicação Function App nova.Name that identifies your new function app. Caracteres válidos são a-z (caso insensível), 0-9 e - .Valid characters are a-z (case insensitive), 0-9, and -.
    PublicarPublish CódigoCode Opção para publicar ficheiros de código ou um contentor de Docker.Option to publish code files or a Docker container.
    Pilha de tempo de execuçãoRuntime stack Linguagem preferencialPreferred language Escolha um tempo de execução que suporte a sua linguagem de programação de funções favorita.Choose a runtime that supports your favorite function programming language. Escolha .NET Core para funções C# e F#.Choose .NET Core for C# and F# functions.
    VersãoVersion Número da versãoVersion number Escolha a versão do seu tempo de execução instalado.Choose the version of your installed runtime.
    RegiãoRegion Região preferidaPreferred region Escolha uma região perto de si ou de outros serviços aos quais as suas funções acedem.Choose a region near you or near other services your functions access.

    Noções básicas

  4. Selecione Seguinte : Hospedagem.Select Next : Hosting. Na página 'Hospedagem', insira as seguintes definições.On the Hosting page, enter the following settings.

    DefiniçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    Conta de armazenamentoStorage account Nome globalmente exclusivoGlobally unique name Crie uma conta de armazenamento para ser utilizada pela sua aplicação 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 de comprimento e podem conter apenas números e letras minúsculas.Storage account names must be between 3 and 24 characters in length and can contain numbers and lowercase letters only. Também pode utilizar uma conta existente, que deve satisfazer os requisitos da conta de armazenamento.You can also use an existing account, which must meet the storage account requirements.
    Sistema operativoOperating system Sistema operativo preferidoPreferred operating system Um sistema operativo é pré-selecionado para si com base na seleção da sua pilha de tempo de execução, mas pode alterar a definiçã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.
    PlanearPlan Consumo (Sem Servidor)Consumption (Serverless) O plano de alojamento que define a forma como os recursos são alocados à sua aplicação Function App.Hosting plan that defines how resources are allocated to your function app. No plano de consumo predefinido, os recursos são adicionados dinamicamente conforme exigido pelas suas funções.In the default Consumption plan, resources are added dynamically as required by your functions. Neste hospedagem sem servidor, paga-se apenas pelo tempo que as suas funções são executadas.In this serverless hosting, you pay only for the time your functions run. Quando executa num plano do Serviço de Aplicações, tem de gerir o dimensionamento da sua aplicação de funções.When you run in an App Service plan, you must manage the scaling of your function app.

    Hosting

  5. Selecione Seguinte : Monitorização.Select Next : Monitoring. Na página 'Monitor' insira as seguintes definições.On the Monitoring page, enter the following settings.

    DefiniçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    Application InsightsApplication Insights PredefiniçãoDefault Cria um recurso Application Insights com o mesmo nome app na região suportada mais próxima.Creates an Application Insights resource of the same App name in the nearest supported region. Ao expandir esta definição ou selecionar Criar novos, pode alterar o nome De Insights de Aplicação ou escolher uma região diferente numa geografia Azure onde pretende armazenar os seus dados.By expanding this setting or selecting Create new, you can change the Application Insights name or choose a different region in an Azure geography where you want to store your data.

    Monitorização

  6. Selecione Review + crie para rever as seleções de configuração da aplicação.Select Review + create to review the app configuration selections.

  7. Na página 'Rever + criar', rever as definições e, em seguida, selecionar Criar para provisão e implementar a aplicação de função.On the Review + create page, review your settings, and then select Create to provision and deploy the function app.

  8. Selecione o ícone notificações no canto superior direito do portal e observe a mensagem de implementação conseguida.Select the Notifications icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

  9. Selecione Ir para o recurso para ver a sua nova aplicação de funções.Select Go to resource to view your new function app. Também pode selecionar Pin para painel de instrumentos.You can also select Pin to dashboard. A fixação facilita o regresso a esta função de recurso de aplicação a partir do seu dashboard.Pinning makes it easier to return to this function app resource from your dashboard.

    Notificação de implantação

Em seguida, crie uma função na nova aplicação de função.Next, create a function in the new function app.

Criar uma função de gatilho HTTPCreate an HTTP trigger function

  1. A partir do menu esquerdo da janela Funções, selecione Funçõese selecione Adicione no menu superior.From the left menu of the Functions window, select Functions, then select Add from the top menu.

  2. A partir da janela Nova Função, selecione 'Desír do gatilho'.From the New Function window, select Http trigger.

    Escolha a função de gatilho HTTP

  3. Na janela Nova Função, aceite o nome predefinido para Nova Função, ou introduza um novo nome.In the New Function window, accept the default name for New Function, or enter a new name.

  4. Escolha o Anónimo na lista de abandono do nível de autorização e, em seguida, selecione Criar Função.Choose Anonymous from the Authorization level drop-down list, and then select Create Function.

    Azure cria a função de gatilho HTTP.Azure creates the HTTP trigger function. Agora, pode enviar um pedido HTTP para executar a função nova.Now, you can run the new function by sending an HTTP request.

Testar a funçãoTest the function

  1. Na sua nova função de gatilho HTTP, selecione Código + Teste a partir do menu esquerdo e, em seguida, selecione Obter URL de função a partir do menu superior.In your new HTTP trigger function, select Code + Test from the left menu, then select Get function URL from the top menu.

    Selecione Obter URL de função

  2. Na caixa de diálogo URL da função Get, selecione o predefinimento da lista de drop-down e, em seguida, selecione a Cópia para o ícone da área de transferência.In the Get function URL dialog box, select default from the drop-down list, and then select the Copy to clipboard icon.

    Copiar o URL da função a partir do portal do Azure

  3. Cole o URL da função na barra de endereço do navegador.Paste the function URL into your browser's address bar. Adicione o valor da cadeia de consulta ?name=<your_name> ao final deste URL e prima Enter para executar o pedido.Add the query string value ?name=<your_name> to the end of this URL and press Enter to run the request.

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

    Resposta da função no browser.

    O URL do pedido inclui uma chave que é necessária, por predefinição, para aceder à sua função através de HTTP.The request URL includes a key that is required, by default, to access your function over HTTP.

  4. Quando a sua função é executada, são escritas informações de rastreio nos registos.When your function runs, trace information is written to the logs. Para ver a saída de vestígios, volte à página Code + Test no portal e expanda a seta de Logs na parte inferior da página.To see the trace output, return to the Code + Test page in the portal and expand the Logs arrow at the bottom of the page.

    Visualizador de registo de funções no portal do Azure.

Limpar os recursosClean up resources

Outros guias de introdução desta coleção têm por base este guia de introdução.Other quickstarts in this collection build upon this quickstart. Se planeia trabalhar com quickstarts subsequentes, tutoriais ou com qualquer um dos serviços que criou neste arranque rápido, não limpe os recursos.If you plan to work with subsequent quickstarts, tutorials, or with any of the services you have created in this quickstart, do not clean up the resources.

Os recursos no Azure referem-se a aplicações de funções, funções, contas de armazenamento e assim sucessivamente.Resources in Azure refer to function apps, functions, storage accounts, and so forth. Estão agrupados em grupos de recursos, e podes apagar tudo num grupo, eliminando o grupo.They're grouped into resource groups, and you can delete everything in a group by deleting the group.

Criou recursos para concluir estes guias de introdução.You created resources to complete these quickstarts. Poderá ser-lhe cobrado estes recursos, dependendo do seu estado da conta e dos preços dos serviços.You may be billed for these resources, depending on your account status and service pricing. Se já não precisar dos recursos, pode eliminá-los da seguinte forma:If you don't need the resources anymore, here's how to delete them:

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

    Para aceder a essa página a partir da página da aplicação de função, selecione o separador Descrição geral e, em seguida, selecione a ligação 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 a eliminar na página da aplicação de função.

    Para aceder a essa página a partir do dashboard, selecione Grupos de recursos e, em seguida, selecione o grupo de recursos que utilizou para este guia de introdução.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 do grupo Recursos, reveja a lista de recursos incluídos e verifique se são eles que pretende eliminar.In the Resource group page, review the list of included resources, and verify that they're the ones you want to delete.

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

    A eliminação pode demorar alguns minutos.Deletion may take a couple of minutes. Quando terminar, é apresentada uma notificação durante alguns segundos.When it's done, a notification appears for a few seconds. Também pode selecionar o ícone de sino na parte superior da página para ver a notificação.You can also select the bell icon at the top of the page to view the notification.

Passos seguintesNext steps

Agora que criou a sua primeira função, vamos adicionar uma ligação de saída à função que escreve uma mensagem para uma fila de armazenamento.Now that you've created your first function, let's add an output binding to the function that writes a message to a Storage queue.

Add messages to an Azure Storage queue using Functions (Utilizar as Funções para adicionar mensagens a uma fila do Armazenamento do Azure)Add messages to an Azure Storage queue using Functions