Criar uma função disparada pelo Armazenamento de Blobs do AzureCreate a function triggered by Azure Blob storage

Saiba como criar uma função disparada quando arquivos são carregados ou atualizados no Armazenamento de Blobs do Azure.Learn how to create a function triggered when files are uploaded to or updated in Azure Blob storage.

Exiba a mensagem nos logs.

Pré-requisitosPrerequisites

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 pelo Armazenamento de BlobsCreate a Blob storage 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 blob e escolha o modelo Gatilho de blob.In the search field, type blob and then choose the Blob trigger template.

  4. Se solicitado, selecione Instalar para instalar a extensão de Armazenamento do Azure em todas as dependências no aplicativo de funções.If prompted, select Install to install the Azure Storage extension any dependencies in the function app. Após a instalação ser bem-sucedida, selecione Continuar.After installation succeeds, select Continue.

    Instalar extensões de associação

  5. Use as configurações conforme especificado na tabela abaixo da imagem.Use the settings as specified in the table below the image.

    Crie a função disparada pelo Armazenamento de Blobs.

    ConfiguraçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    NomeName Exclusivo no aplicativo de funçõesUnique in your function app O nome dessa função disparada pelo blob.Name of this blob triggered function.
    CaminhoPath samples-workitems/{name}samples-workitems/{name} Local no Armazenamento de Blobs que está sendo monitorada.Location in Blob storage being monitored. O nome do arquivo do blob é passado na associação como o parâmetro name.The file name of the blob is passed in the binding as the name parameter.
    Conexão da conta de armazenamentoStorage account connection AzureWebJobsStorageAzureWebJobsStorage Você pode usar a conexão da conta de armazenamento que já está sendo usada por seu aplicativo de funções ou criar uma nova.You can use the storage account connection already being used by your function app, or create a new one.
  6. Clique em Criar para criar a função.Click Create to create your function.

Em seguida, você pode se conectar à sua conta de armazenamento do Azure e criar o contêiner samples-workitems.Next, you connect to your Azure Storage account and create the samples-workitems container.

Criar o contêinerCreate the container

  1. Em sua função, clique em Integrar, expanda Documentaçãoe copie Nome da conta e Chave de conta.In your function, click Integrate, expand Documentation, and copy both Account name and Account key. Você usa essas credenciais para conectar-se à conta de armazenamento.You use these credentials to connect to the storage account. Se você já tiver se conectado à conta de armazenamento, vá para a etapa 4.If you have already connected your storage account, skip to step 4.

    Obtenha as credenciais de conexão da conta de armazenamento.

  2. Execute a ferramenta Gerenciador de Armazenamento do Microsoft Azure, clique no ícone conectar-se à esquerda, escolha Usar um nome e chave de conta de armazenamento e clique em Avançar.Run the Microsoft Azure Storage Explorer tool, click the connect icon on the left, choose Use a storage account name and key, and click Next.

    Execute a ferramenta Gerenciador de Conta de Armazenamento.

  3. Insira o Nome da conta e Chave de conta da etapa 1, clique em Avançar e em Conectar.Enter the Account name and Account key from step 1, click Next and then Connect.

    Insira as credenciais de armazenamento e conecte-se.

  4. Expanda a conta de armazenamento anexada, clique com o botão direito do mouse em Contêineres de blob, clique em Criar contêiner de blob, digite samples-workitems e pressione enter.Expand the attached storage account, right-click Blob containers, click Create blob container, type samples-workitems, and then press enter.

    Crie uma fila de armazenamento.

Agora que você tem um contêiner de blob, você pode testar a função carregando um arquivo para o contêiner.Now that you have a blob container, you can test the function by uploading a file to the container.

Testar a funçãoTest the function

  1. De volta ao Portal do Azure, navegue até sua função, expanda os Logs na parte inferior da página e verifique se o streaming de log não está em pausa.Back in the Azure portal, browse to your function expand the Logs at the bottom of the page and make sure that log streaming isn't paused.

  2. No Gerenciador de Armazenamento, expanda sua conta de armazenamento, Contêineres de blob e samples-workitems.In Storage Explorer, expand your storage account, Blob containers, and samples-workitems. Clique em Carregar e depois em Carregar arquivos... .Click Upload and then Upload files....

    Carregue um arquivo para o contêiner de blob.

  3. Na caixa de diálogo Carregar arquivos, clique no campo Arquivos.In the Upload files dialog box, click the Files field. Navegue até um arquivo em seu computador local, por exemplo, um arquivo de imagem, selecione-o e clique em Abrir e depois em Carregar.Browse to a file on your local computer, such as an image file, select it and click Open and then Upload.

  4. Volte para os logs de função e verifique se o blob foi lido.Go back to your function logs and verify that the blob has been read.

    Exiba a mensagem nos logs.

    Observação

    Quando seu aplicativo de funções é executado no plano de consumo padrão, pode haver um atraso de até vários minutos entre o blob que está sendo adicionado ou atualizado e a função sendo disparada.When your function app runs in the default Consumption plan, there may be a delay of up to several minutes between the blob being added or updated and the function being triggered. Se você precisar de baixa latência em suas funções disparadas por blob, considere executar seu aplicativo de funções em um Plano do Serviço de Aplicativo.If you need low latency in your blob triggered functions, consider running your function app in an App Service plan.

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 quando um blob é adicionado a um Armazenamento de Blobs ou atualizado nele.You have created a function that runs when a blob is added to or updated in Blob storage. Para obter mais informações sobre gatilhos de armazenamento de blobs, consulte Associações de Armazenamento de Blobs do Azure Functions.For more information about Blob storage triggers, see Azure Functions Blob storage bindings.

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.