APIs REST sem servidor com Funções do Azure
Funções do Azure é um serviço de computação essencial que utiliza para criar APIs baseadas em REST sem servidor. Os acionadores HTTP expõem pontos finais REST que podem ser chamados pelos seus clientes, como browsers, aplicações móveis e outros serviços de back-end. Com o suporte nativo para rotas, uma única função acionada por HTTP pode expor uma API REST altamente funcional. As funções também fornecem o seu próprio esquema básico de autorização baseado em chaves para ajudar a limitar o acesso apenas a clientes específicos. Para obter mais informações, veja Funções do Azure acionador HTTP
Em alguns cenários, poderá precisar da sua API para suportar um conjunto mais complexo de comportamentos REST. Por exemplo, poderá ter de combinar vários pontos finais de função HTTP numa única API. Também poderá querer transmitir pedidos através de um ou mais serviços baseados em REST de back-end. Por fim, as suas APIs podem exigir um maior grau de segurança que lhe permite rentabilizar a sua utilização.
Atualmente, a abordagem recomendada para criar APIs mais complexas e robustas com base nas suas funções é utilizar os serviços de API abrangentes fornecidos pelo Azure Gestão de API. Gestão de API utiliza um modelo baseado em políticas para lhe permitir controlar o encaminhamento, a segurança e a integração de OpenAPI. Também suporta políticas avançadas, como a limitação da taxa de monetização. As versões anteriores do runtime das Funções utilizaram a funcionalidade Proxies de Funções legada.
Importante
Funções do Azure proxies é uma funcionalidade legada para as versões 1.x a 3.x do Funções do Azure runtime. O suporte para proxies pode ser reativado na versão 4.x para atualizar com êxito as suas aplicações de funções para a versão mais recente do runtime. Assim que possível, deve mudar para a integração das suas aplicações de funções com o Azure Gestão de API. 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, veja integração de Gestão de API.
Para saber como reativar o suporte de proxies nas Funções versão 4.x, consulte Reativar proxies nas Funções v4.x.
Mover de Proxies de Funções para Gestão de API
Ao passar de Proxies de Funções para utilizar Gestão de API, tem de integrar a sua aplicação de funções numa instância de Gestão de API e, em seguida, configurar a instância Gestão de API para se comportar como o proxy anterior. A secção seguinte fornece ligações para os artigos relevantes que o ajudam a utilizar Gestão de API com Funções do Azure.
Se tiver desafios ao mover-se de proxies ou se o Azure Gestão de API não abordar os seus cenários específicos, publique um pedido no fórum de comentários Gestão de API.
integração de Gestão de API
Gestão de API permite-lhe importar uma aplicação de funções existente. Após a importação, cada ponto final da função acionada por HTTP torna-se uma API que pode modificar e gerir. Após a importação, também pode utilizar Gestão de API para gerar um ficheiro de definição OpenAPI para as suas APIs. Durante a importação, todos os pontos finais com um nível de adminautorização são ignorados. Para obter mais informações sobre como utilizar Gestão de API com Funções, consulte os seguintes artigos:
| Artigo | Descrição |
|---|---|
| Expor APIs sem servidor a partir de pontos finais HTTP com o Azure Gestão de API | Mostra como criar uma nova instância de Gestão de API a partir de uma aplicação de funções existente no portal do Azure. Suporta todos os idiomas. |
| Criar APIs sem servidor no Visual Studio com a integração de Funções do Azure e Gestão de API | Mostra como utilizar o Visual Studio para criar um projeto C# que utiliza a extensão OpenAPI. A extensão OpenAPI permite-lhe definir as suas APIs .NET ao aplicar atributos diretamente ao código C#. |
| Início Rápido: Criar uma nova instância de serviço do Azure Gestão de API com o portal do Azure | Crie uma nova instância Gestão de API no portal. Depois de criar uma instância Gestão de API, pode ligá-la à sua aplicação de funções. São suportados outros métodos de criação não portais. |
| Importar uma aplicação de funções do Azure como uma API no Azure Gestão de API | Mostra como importar uma aplicação de funções existente para expor pontos finais de acionador HTTP existentes como uma API gerida. Este artigo suporta a criação de uma nova API e a adição dos pontos finais a uma API gerida existente. |
Depois de ter os pontos finais da aplicação de funções expostos com Gestão de API, os artigos seguintes fornecem informações gerais sobre como gerir as APIs baseadas em Funções na instância do Gestão de API.
| Artigo | Descrição |
|---|---|
| Editar uma API | Mostra-lhe como trabalhar com uma API existente alojada no Gestão de API. |
| Políticas na Gestão de API do Azure | No Gestão de API, os publicadores podem alterar o comportamento da API através da configuração através de políticas. As políticas são uma coleção de instruções que são executadas sequencialmente no pedido ou resposta de uma API. |
| Referência de política da API Management | Referência que detalha todas as políticas de Gestão de API suportadas. |
| Exemplos de políticas de Gestão de API | Coleção útil de exemplos com políticas de Gestão de API em cenários-chave. |
Proxies de Funções Legadas
A funcionalidade Proxies de Funções legadas também fornece um conjunto de funcionalidades de API básicas para a versão 3.x e versão mais antiga do runtime das Funções.
Importante
Funções do Azure proxies é uma funcionalidade legada para as versões 1.x a 3.x do Funções do Azure runtime. O suporte para proxies pode ser reativado na versão 4.x para atualizar com êxito as suas aplicações de funções para a versão mais recente do runtime. Assim que possível, deve mudar para a integração das suas aplicações de funções com o Azure Gestão de API. 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, veja integração de Gestão de API.
Para saber como reativar o suporte de proxies nas Funções versão 4.x, consulte Reativar proxies nas Funções v4.x.
Algumas sugestões básicas sobre como realizar tarefas equivalentes com Gestão de API foram adicionadas ao artigo Proxies de Funções. Atualmente, não temos documentação ou ferramentas para o ajudar a migrar uma implementação de Proxies de Funções existente para Gestão de API.