Criar uma função no Azure que é disparada por um temporizadorCreate a function in Azure that is triggered by a timer

Saiba como usar o Azure Functions para criar uma função sem servidor que é executada com base em um agendamento definido por você.Learn how to use Azure Functions to create a serverless function that runs based a schedule that you define.

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

Pré-requisitosPrerequisites

Para concluir este tutorial:To complete this tutorial:

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

Criar um Aplicativo de funções do AzureCreate an Azure Function app

  1. Selecione o botão Criar um recurso no canto superior esquerdo do portal do Azure e selecione Computação > Aplicativo de funções.Select the Create a resource button found on the upper left-hand corner of the Azure portal, then select Compute > Function App.

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

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

    Definir novas configurações do aplicativo de funções

    ConfiguraçãoSetting Valor sugeridoSuggested value DESCRIÇÃODescription
    Nome do aplicativoApp 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, 0-9 e -.Valid characters are a-z, 0-9, and -.
    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.
    SOOS WindowsWindows As opções de linguagem disponíveis dependem do sistema operacional do aplicativo de funções.The language options available depend on the OS of the function app. Por exemplo, o Python requer o Linux.For example, Python requires Linux.
    Plano de hospedagemHosting plan 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.
    LocalidadeLocation Europa OcidentalWest Europe 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.
    Pilha de tempo de execuçãoRuntime stack Linguagem preferencialPreferred language Escolha um tempo de execução 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.
    ArmazenamentoStorage 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. Você também pode usar uma conta existente, mas ela precisa atender aos requisitos da conta de armazenamento.You can also use an existing account, which must meets the storage account requirements.
    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.
  3. Selecione Criar para provisionar e implantar o aplicativo de funções.Select Create to provision and deploy the function app.

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

    Definir novas configurações do aplicativo de funções

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

Aplicativo de funções criado com êxito.

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 temporizadorCreate a timer triggered function

  1. Expanda seu aplicativo de funções e clique no botão + ao lado de Functions.Expand your function app and click the + button next to Functions. Se essa for a primeira função em seu aplicativo de funções, selecione No portal e depois Continuar.If this is the first function in your function app, select In-portal then Continue. Caso contrário, vá para a etapa três.Otherwise, go to step three.

    Página de início rápido de funções no portal do Azure

  2. Escolha Mais modelos e, em seguida, Concluir e exibir modelos.Choose More templates then Finish and view templates.

    Início Rápido do Functions, escolher mais modelos

  3. No campo de pesquisa, digite timer e defina o novo gatilho com as configurações especificadas na tabela abaixo da imagem.In the search field, type timer and configure the new trigger with the settings as specified in the table below the image.

    Criar uma função disparada pelo temporizador no portal do Azure.

    ConfiguraçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    NomeName PadrãoDefault Define o nome da sua função disparada por temporizador.Defines the name of your timer triggered function.
    AgendaSchedule 0 */1 * * * *0 */1 * * * * Uma expressão CRON de seis campos que agenda sua função para ser executada a cada minuto.A six field CRON expression that schedules your function to run every minute.
  4. Clique em Criar.Click Create. Uma nova função na linguagem de programação escolhida por você e que é executada a cada minuto é criada.A function is created in your chosen language that runs every minute.

  5. Verifique a execução, exibindo informações de rastreamento gravadas nos logs.Verify execution by viewing trace information written to the logs.

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

Agora você altera o agendamento da função para que ela seja executada uma vez por hora em vez de uma vez por minuto.Now, you change the function's schedule so that it runs once every hour instead of every minute.

Atualizar o agendamento do temporizadorUpdate the timer schedule

  1. Expanda sua função e clique em Integrar.Expand your function and click Integrate. É aqui que você define as associações de entrada e saída de sua função e também define o agendamento.This is where you define input and output bindings for your function and also set the schedule.

  2. Insira um novo valor de Agendamento por hora de 0 0 */1 * * * e depois clique em Salvar.Enter a new hourly Schedule value of 0 0 */1 * * * and then click Save.

As funções atualizam o agendamento do temporizador no Portal do Azure.

Agora você tem uma função que é executada uma vez a cada hora.You now have a function that runs once every hour.

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 uma função que é executada segundo um agendamento.You have created a function that runs based on a schedule. Para obter mais informações sobre gatilhos de temporizador, confira Agendar a execução de código com o Azure Functions.For more information about timer triggers, see Schedule code execution with Azure Functions.

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.