Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Azure Functions é um serviço de computação essencial que você usa para criar APIs baseadas em REST sem servidor. Os ativadores HTTP expõem endpoints REST que podem ser chamados pelos seus clientes, como navegadores, aplicações 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 Trigger 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 endereços de função HTTP numa única API. Você também pode querer passar solicitações para um ou mais serviços de back-end baseados em REST. 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 a monetização através do controlo de taxas. As versões anteriores do runtime de Funções usavam o recurso herdado Proxies das Funções.
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, deverá mudar para a integração das suas aplicações de funções com a Gestão 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 da gestão de API, deve integrar a sua aplicação de função a uma instância de gestão de API e, em seguida, configurar a instância de gestão 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 adminnível de 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 | 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 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 | Mostrar como importar uma aplicação de funções existente para expor endpoints de disparador HTTP existentes como uma API gerida. Este artigo abrange tanto a criação de uma nova API como a adição dos endpoints a uma API já gerida 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 | Descrição |
|---|---|
| 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 herdado Proxies de Funções também fornece um conjunto de funcionalidades básicas da API para a versão 3.x e versões mais antigas 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. Logo que possível, deve mudar para integrar as suas funções de aplicação com a Gestão 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 Gestão 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.