APIs REST sem servidor usando o Azure Functions
O Azure Functions é um serviço de computação essencial que você usa para criar APIs REST sem servidor. Os gatilhos HTTP expõem os pontos de extremidade REST que podem ser chamados pelos clientes, como navegadores, aplicativos móveis e outros serviços de back-end. Com suporte nativo para rotas, uma única função disparada 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 somente a clientes específicos. Para obter mais informações, confira Gatilho HTTP do Azure Functions
Em alguns cenários, talvez você precise da API para dar suporte a um conjunto mais complexo de comportamentos REST. Por exemplo, talvez seja necessário combinar vários pontos de extremidade da função HTTP em uma única API. Convém passar as solicitações por meio de um ou mais serviços baseados em REST de back-end. Por fim, as APIs podem exigir um grau maior de segurança que permita monetizar o uso.
Hoje, a abordagem recomendada para criar APIs mais complexas e robustas com base nas 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ítica para permitir que você controle o roteamento, a segurança e a integração do OpenAPI. Ele também dá suporte a políticas avançadas, como a limitação de taxa de monetização. As versões anteriores do runtime do Functions usavam o recurso herdado Proxies do Azure Functions.
Importante
Os proxies do Azure Functions são um recurso herdado para versões 1.x a 3.x do Azure Functions runtime. O suporte para proxies pode ser reabilitado na versão 4.x para atualizar com sucesso seus aplicativos de funções para a última versão do runtime. Assim que possível, você deverá alternar para integrar seus aplicativos de funções ao Gerenciamento de API do Azure. O Gerenciamento de API permite aproveitar um conjunto mais completo de recursos para definir, proteger, gerenciar e monetizar as APIs baseadas no Functions. Para obter mais informações, consulte Integração do Gerenciamento de API.
Para saber como reabilitar o suporte a proxies no Functions versão 4.x, consulte Reabilitar proxies no Functions v4.x.
Como migrar dos Proxies do Azure Functions para o Gerenciamento de API
Ao migrar do Proxies do Azure Functions para usar o Gerenciamento de API, você deve integrar o aplicativo de funções a uma instância de Gerenciamento de API e 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 êxito em usar o Gerenciamento de API com o Azure Functions.
Se você tiver dificuldades em migrar dos proxies ou se o Gerenciamento de API do Azure não resolver os cenários específicos, poste uma solicitação no fórum de comentários do Gerenciamento de API.
Integração ao Gerenciamento de API
O Gerenciamento de API permite importar um aplicativo de funções existente. Após a importação, cada ponto de extremidade da função disparada 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 do OpenAPI para as APIs. Durante a importação, todos os pontos de extremidade com um adminnível de autorização são ignorados. Para obter mais informações sobre como usar o Gerenciamento de API com o Functions, confira os seguintes artigos:
| Artigo | Descrição |
|---|---|
| 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 em um aplicativo de funções existente no portal do Azure. Dá suporte a todos os idiomas. |
| Criar APIs sem servidor no Visual Studio usando o Azure Functions e o 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 definir as APIs .NET, aplicando atributos diretamente ao código C#. |
| 'Início Rápido: Criar uma instância de serviço do 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 aplicativo de funções. Há suporte para outros métodos de criação que não são executados no portal. |
| Importar um Aplicativo de funções do Azure como uma API no Gerenciamento de API do Azure | Mostra como importar um aplicativo de funções existente para expor pontos de extremidade de gatilho HTTP existentes como uma API gerenciada. Este artigo dá suporte à criação de uma nova API e à adição dos pontos de extremidade a uma API gerenciada existente. |
Depois que você os pontos de extremidade do aplicativo de funções forem expostos usando o Gerenciamento de API, os artigos a seguir fornecem informações gerais sobre como gerenciar as APIs baseadas em funções na instância de Gerenciamento de API.
| Artigo | Descrição |
|---|---|
| Editar uma API | Mostra como trabalhar com uma API existente hospedada no Gerenciamento de API. |
| Políticas no Gerenciamento 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 um conjunto de instruções executadas em sequência, na solicitação ou na resposta de uma API. |
| referência de política de Gerenciamento de API | Referência que detalha todas as políticas de Gerenciamento de API com suporte. |
| Políticas de gerenciamento de API de exemplo | Coleção útil de exemplos que usam políticas de Gerenciamento de API nos principais cenários. |
Proxies do Azure Functions
O recurso herdado Proxies do Azure Functions também fornece um conjunto de funcionalidades básicas de API para a versão 3.x e a versão mais antiga do runtime do Functions.
Importante
Os proxies do Azure Functions são um recurso herdado para versões 1.x a 3.x do Azure Functions runtime. O suporte para proxies pode ser reabilitado na versão 4.x para atualizar com sucesso seus aplicativos de funções para a última versão do runtime. Assim que possível, você deverá alternar para integrar seus aplicativos de funções ao Gerenciamento de API do Azure. O Gerenciamento de API permite aproveitar um conjunto mais completo de recursos para definir, proteger, gerenciar e monetizar as APIs baseadas no Functions. Para obter mais informações, consulte Integração do Gerenciamento de API.
Para saber como reabilitar o suporte a proxies no Functions versão 4.x, consulte Reabilitar proxies no Functions v4.x.
Algumas dicas básicas de como executar tarefas equivalentes usando o Gerenciamento de API foram adicionadas ao artigo Proxies do Azure Functions. No momento, não temos documentação ou ferramentas para ajudar a migrar uma implementação de Proxies do Azure Functions existente para o Gerenciamento de API.