APIs REST sem servidor usando o Azure Functions
O Azure Functions é um serviço de computação essencial que você usa para criar APIs baseadas em REST sem servidor. Os gatilhos HTTP expõem pontos de extremidade REST que podem ser chamados por seus clientes, como navegadores, aplicativos móveis e outros serviços de back-end. Com suporte nativo para rotas, uma única função acionada por HTTP pode expor uma API REST altamente funcional. O Functions também fornece seu próprio esquema básico de autorização baseado em chave para ajudar a limitar o acesso apenas a clientes específicos. Para obter mais informações, consulte Gatilho HTTP do Azure Functions
Em alguns cenários, você pode precisar de sua API para dar suporte a um conjunto mais complexo de comportamentos REST. Por exemplo, talvez seja necessário combinar vários pontos de extremidade de função HTTP em uma única API. Você também pode querer passar solicitações para um ou mais serviços baseados em REST de back-end. Por fim, suas APIs podem exigir um grau mais alto de segurança que permita monetizar seu uso.
Atualmente, a abordagem recomendada para criar APIs mais complexas e robustas com base em suas funções é usar os serviços de API abrangentes fornecidos pelo Gerenciamento de API do Azure. O Gerenciamento de API usa um modelo baseado em políticas para permitir que você controle o roteamento, a segurança e a integração com OpenAPI. Ele também suporta políticas avançadas, como monetização de limitação de taxa. As versões anteriores do tempo de execução do Functions usavam o recurso Proxies de Funções herdado.
Importante
Os proxies do Azure Functions são um recurso herdado para as versões 1.x a 3.x do tempo de execução do Azure Functions. O suporte para proxies pode ser reativado na versão 4.x para que você atualize com êxito seus aplicativos de função para a versão de tempo de execução mais recente. Assim que possível, você deve alternar para integrar seus aplicativos de função com o Gerenciamento de API do Azure. O API Management permite-lhe tirar partido de um conjunto de funcionalidades mais completo para definir, proteger, gerir e rentabilizar as suas APIs baseadas em Funções. Para obter mais informações, consulte Integração de gerenciamento de API.
Para saber como reativar o suporte a proxies no Functions versão 4.x, consulte Reativar proxies no Functions v4.x.
Mudando de proxies de funções para gerenciamento de API
Ao mudar de Proxies de Funções para o uso do Gerenciamento de API, você deve integrar seu aplicativo de função a uma instância de Gerenciamento de API e, em seguida, configurar a instância de Gerenciamento de API para se comportar como o proxy anterior. A seção a seguir fornece links para os artigos relevantes que ajudam você a ter sucesso no uso do Gerenciamento de API com o Azure Functions.
Se você tiver desafios ao migrar de proxies ou se o Gerenciamento de API do Azure não abordar seus cenários específicos, publique uma solicitação no fórum de comentários do Gerenciamento de API.
Integração com o Gerenciamento de API
O Gerenciamento de API permite importar um aplicativo de função existente. Após a importação, cada ponto de extremidade de função acionada por HTTP se torna uma API que você pode modificar e gerenciar. Após a importação, você também pode usar o Gerenciamento de API para gerar um arquivo de definição OpenAPI para suas APIs. Durante a importação, todos os pontos de extremidade com um nível de admin autorização são ignorados. Para obter mais informações sobre como usar o Gerenciamento de API com Funções, consulte os seguintes artigos:
| Artigo | Description |
|---|---|
| Expor APIs sem servidor de pontos de extremidade HTTP usando o Gerenciamento de API do Azure | Mostra como criar uma nova instância de Gerenciamento de API a partir de um aplicativo de função existente no portal do Azure. Suporta todos os idiomas. |
| Criar APIs sem servidor no Visual Studio usando o Azure Functions e a integração do Gerenciamento de API | Mostra como usar o Visual Studio para criar um projeto C# que usa a extensão OpenAPI. A extensão OpenAPI permite que você defina suas APIs .NET aplicando atributos diretamente ao seu código C#. |
| Guia de início rápido: criar uma nova instância de serviço de Gerenciamento de API do Azure usando o portal do Azure | Crie uma nova instância de Gerenciamento de API no portal. Depois de criar uma instância de Gerenciamento de API, você pode conectá-la ao seu aplicativo de função. Outros métodos de criação que não sejam de portal são suportados. |
| Importar um aplicativo de função do Azure como uma API no Gerenciamento de API do Azure | Mostra como importar um aplicativo de função existente para expor pontos de extremidade de gatilho HTTP existentes como uma API gerenciada. Este artigo oferece suporte à criação de uma nova API e à adição dos pontos de extremidade a uma API gerenciada existente. |
Depois de expor os pontos de extremidade do aplicativo de função usando o Gerenciamento de API, os artigos a seguir fornecem informações gerais sobre como gerenciar suas APIs baseadas em funções na instância de Gerenciamento de API.
| Artigo | Description |
|---|---|
| Editar uma API | Mostra como trabalhar com uma API existente hospedada no Gerenciamento de API. |
| Políticas na Gestão de API do Azure | No Gerenciamento de API, os editores podem alterar o comportamento da API por meio da configuração usando políticas. As políticas são uma coleção de instruções que são executadas sequencialmente no pedido ou na resposta de uma API. |
| API Management policy reference (Referência de política da Gestão de API) | Referência que detalha todas as políticas de Gerenciamento de API suportadas. |
| Exemplos de políticas de Gestão de API | Coleta útil de exemplos usando políticas de Gerenciamento de API em cenários-chave. |
Proxies de funções herdadas
O recurso Proxies de funções herdado também fornece um conjunto de funcionalidades básicas da API para a versão 3.x e a versão mais antiga do tempo de execução do Functions.
Importante
Os proxies do Azure Functions são um recurso herdado para as versões 1.x a 3.x do tempo de execução do Azure Functions. O suporte para proxies pode ser reativado na versão 4.x para que você atualize com êxito seus aplicativos de função para a versão de tempo de execução mais recente. Assim que possível, você deve alternar para integrar seus aplicativos de função com o Gerenciamento de API do Azure. O API Management permite-lhe tirar partido de um conjunto de funcionalidades mais completo para definir, proteger, gerir e rentabilizar as suas APIs baseadas em Funções. Para obter mais informações, consulte Integração de gerenciamento de API.
Para saber como reativar o suporte a proxies no Functions versão 4.x, consulte Reativar proxies no Functions v4.x.
Algumas dicas básicas sobre como executar tarefas equivalentes usando o Gerenciamento de API foram adicionadas ao artigo Proxies de funções. No momento, não temos documentação ou ferramentas para ajudá-lo a migrar uma implementação existente de Proxies de Funções para o Gerenciamento de API.