Criar uma função no Azure que é acionada pelo armazenamento de Blob

Saiba como criar uma função acionada quando os arquivos são carregados ou atualizados em um contêiner de armazenamento de Blob.

Nota

A edição no portal só é suportada para funções JavaScript, PowerShell e C# Script. A edição Python no portal é suportada apenas quando executada no plano de consumo. Para criar uma aplicação de script em C# que ofereça suporte à edição no portal, deve escolher uma versão do runtime que suporte o modelo em processo.

Sempre que possível, deve desenvolver as suas funções localmente.

Para saber mais sobre as limitações na edição de código de função no portal do Azure, consulte Limitações de desenvolvimento no portal do Azure.

Pré-requisitos

• Uma subscrição do Azure. Se não tiver uma, crie uma conta gratuita antes de começar.

Criar uma aplicação de Funções do Azure

1. A partir do menu do portal do Azure ou a partir da Home page, selecione Criar um recurso.

2. Na página Novo , selecione Aplicativo de função.

3. Em Selecione uma opção de hospedagem, selecione Consumo>Selecione para criar seu aplicativo no plano de consumo padrão. Nesta opção de hospedagem sem servidor, você paga apenas pelo tempo em que suas funções são executadas. O plano Premium também oferece escalonamento dinâmico. Quando executa num plano do Serviço de Aplicações, tem de gerir o dimensionamento da sua aplicação de funções.

4. Na página Noções básicas, use as configurações do aplicativo de função conforme especificado na tabela a seguir:

   Configuração	Valor sugerido	Descrição
   Subscrição	a sua subscrição	A subscrição ao abrigo da qual cria a sua nova aplicação funcional.
   Grupo de Recursos	myResourceGroup	Nome para o novo grupo de recursos no qual você cria seu aplicativo de função. Você deve criar um novo grupo de recursos porque há limitações conhecidas ao criar novos aplicativos de função em um grupo de recursos existente.
   Nome da Aplicação de Funções	Nome globalmente exclusivo	Nome que identifica a sua nova aplicação de funções. Os carateres válidos são a-z (não sensível a maiúsculas e minúsculas), 0-9 e -. Para garantir um nome de aplicativo exclusivo, você pode, opcionalmente, habilitar o nome de host padrão exclusivo seguro, que está atualmente em visualização.
   Pilha de execução	Idioma Preferencial	Escolha um tempo de execução que suporte a sua linguagem de programação de funções favorita. A edição no portal só está disponível para JavaScript, PowerShell, Python, TypeScript e script C#. Para criar uma aplicação de script em C# que ofereça suporte à edição no portal, deve escolher uma versão do runtime que suporte o modelo em processo. A biblioteca de classes C# e as funções Java devem ser desenvolvidas localmente.
   Versão	Número de versão	Escolha a versão do seu tempo de execução instalado.
   Região	Região preferida	Selecione uma região perto de você ou perto de outros serviços que suas funções possam acessar.
   Sistema Operativo	Windows	Um sistema operacional é pré-selecionado para você com base na seleção da pilha de tempo de execução, mas você pode alterar a configuração, se necessário. A edição no portal só é suportada no Windows.

5. Aceite as opções padrão nas guias restantes, incluindo o comportamento padrão de criar uma nova conta de armazenamento na guia Armazenamento e uma nova instância do Application Insight na guia Monitoramento . Você também pode optar por usar uma conta de armazenamento existente ou uma instância do Application Insights.

6. Selecione Rever + criar para rever a configuração da aplicação que escolheu e, em seguida, selecione Criar para provisionar e implementar a aplicação funcional.

7. Selecione o ícone Notificações no canto superior direito do portal e observe a mensagem Implantação bem-sucedida .

8. Selecione Ir para o recurso para ver a sua nova aplicação de funções. Você também pode selecionar Fixar no painel. Afixar facilita o retorno a este recurso da aplicação funcional a partir do seu painel.

   

Você criou com sucesso seu novo aplicativo de função. Em seguida, cria uma função na nova aplicação de funções.

Criar uma função acionada por um armazenamento de Blobs do Azure

1. Na sua aplicação de funções, selecione Descrição Geral e, em seguida, selecione + Criar em Funções.

2. Em Selecione um modelo, escolha o modelo de gatilho de Blob e selecione Avançar.

3. Em Detalhes do modelo, configure o novo gatilho com as configurações especificadas nesta tabela e selecione Criar:

   Configuração	Valor sugerido	Descrição
   Tipo de trabalho	Anexar ao aplicativo	Você só vê essa configuração para um aplicativo Python v2.
   Nova função	Exclusivo na aplicação Function App	Nome desta função acionada por um blob.
   Caminho	samples-workitems/{nome}	Localização no armazenamento de Blobs a ser monitorizada. O nome do ficheiro do blob é transmitido no enlace como o parâmetro name.
   Ligação da conta de armazenamento	AzureWebJobsStorage	Pode utilizar a ligação da conta de armazenamento que já está a ser utilizada pela sua aplicação Function App ou criar uma nova.

   O Azure cria a função acionada pelo Armazenamento de Blob com base nos valores fornecidos. Em seguida, crie o contêiner samples-workitems .

Criar o contentor

1. Retorne à página Visão geral do seu aplicativo de função, selecione seu Grupo de recursos e, em seguida, localize e selecione a conta de armazenamento no grupo de recursos.

2. Na página da conta de armazenamento, selecione Armazenamento de dados>Contêineres>+ Contêiner.

3. No campo Nome, digite samples-workitemse selecione Criar para criar um contêiner.

4. Selecione o novo samples-workitems contêiner, que você usa para testar a função carregando um arquivo para o contêiner.

Testar a função

1. Em uma nova janela do navegador, retorne à página do aplicativo de função e selecione Fluxo de log, que exibe o registro em tempo real do seu aplicativo.

2. Na página de samples-workitems contêiner, selecione Carregar>Procurar arquivos, navegue até um arquivo no computador local (como um arquivo de imagem) e escolha o arquivo.

3. Selecione Abrir e, em seguida, Carregar.

4. Volte para os logs do aplicativo de função e verifique se o blob foi lido.

   Nota

   Quando a aplicação de funções é executada no plano Consumo predefinido, pode haver um atraso de até vários minutos entre a inclusão ou atualização do blob e o acionamento da função. Se você precisar de baixa latência em suas funções acionadas por blob, considere uma dessas outras opções de gatilho de blob.

Limpar recursos

Outros guias de introdução desta coleção têm por base este guia de introdução. Se você planeja trabalhar com inícios rápidos, tutoriais ou com qualquer um dos serviços criados neste início rápido, não limpe os recursos.

Os recursos no Azure referem-se a aplicações de funções, funções, contas de armazenamento e assim sucessivamente. Eles são agrupados em grupos de recursos e você pode excluir tudo em um grupo excluindo o grupo.

Você criou recursos para concluir esses inícios rápidos. Você pode ser cobrado por esses recursos, dependendo do status da sua conta e do preço do serviço. Se já não precisar dos recursos, pode eliminá-los da seguinte forma:

1. No portal do Azure, visite a página Grupo de recursos.

   Para aceder a essa página a partir da página da aplicação de funções, selecione o separador Descrição Geral e, em seguida, selecione a ligação em Grupo de recursos.

   

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

2. Na página Grupo de recursos, revise a lista de recursos incluídos e verifique se eles são aqueles que você deseja excluir.

3. Selecione Excluir grupo de recursos e siga as instruções.

   A exclusão pode levar alguns minutos. Quando terminar, é apresentada uma notificação durante alguns segundos. Também pode selecionar o ícone de sino na parte superior da página para ver a notificação.

Próximos passos

Criou uma função que é executada quando um blob é adicionado ou atualizado no Armazenamento de blobs. Para mais informações sobre os acionadores do armazenamento de blobs, consulte Azure Functions Blob Storage Bindings (ligações de armazenamento de blobs do Azure Functions).

Agora que você criou sua primeira função, vamos adicionar uma ligação de saída à função que grava uma mensagem em uma fila de armazenamento.

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