Expor APIs sem servidor de pontos de extremidade HTTP usando o Gerenciamento de API do Azure

  • Artigo

O Azure Functions integra-se ao Gerenciamento de API do Azure no portal para permitir que você exponha seus pontos de extremidade de função de gatilho HTTP como APIs REST. Estas APIs são descritas usando uma definição de OpenAPI. Esse arquivo JSON (ou YAML) contém informações sobre quais operações estão disponíveis em uma API. Ele inclui detalhes sobre como os dados de solicitação e resposta para a API devem ser estruturados. Ao integrar seu aplicativo de funções, o Gerenciamento de API pode gerar essas definições de OpenAPI.

Este artigo mostra como integrar seu aplicativo de funções ao Gerenciamento de API. Essa integração funciona nos aplicativos de funções desenvolvidos em qualquer linguagem com suporte. Você também pode importar seu aplicativo de funções do Gerenciamento de API do Azure.

Para funções de biblioteca de classes C#, você também pode usar o Visual Studio para criar e publicar API sem servidor que se integre ao Gerenciamento de API.

Criar uma instância de Gerenciamento de API

Para criar uma instância de Gerenciamento de API vinculada ao seu aplicativo de funções:

  1. Selecione o aplicativo de funções, escolha Gerenciamento de API no menu esquerdo e, em seguida, selecione Criar em Gerenciamento de API.

    Choose API Management

  2. Use as configurações do Gerenciamento de API conforme especificado na seguinte tabela:

    Configuração Valor sugerido Description
    Nome Nome globalmente exclusivo Um nome é gerado com base no nome do seu aplicativo de funções.
    Assinatura Sua assinatura A assinatura na qual este novo recurso será criado.
    Grupo de recursos myResourceGroup O mesmo recurso que seu aplicativo de funções, que deve estar definido para você.
    Localidade Local do serviço Considere escolher o mesmo local que seu aplicativo de funções.
    Nome da organização Contoso O nome da organização usado no portal do desenvolvedor e para notificações por email.
    Email do administrador seu email Email que recebeu notificações do sistema de Gerenciamento de API.
    Tipo de preços Consumo A camada de consumo não está disponível em todas as regiões. Para obter detalhes completos sobre preços, confira a Página de preços de Gerenciamento de API

    Create new API Management service

  3. Escolha Exportar para criar a instância de Gerenciamento de API. Isso pode demorar vários minutos.

  4. Depois que o Azure cria a instância, ele habilita a opção Habilitar Application Insights na página. Selecione-a para enviar logs para o mesmo local que o aplicativo de funções.

Importar funções

Depois que instância do Gerenciamento de API for criada, você poderá importar seus pontos de extremidade de função de gatilho HTTP. Este exemplo importa um ponto de extremidade chamado TurbineRepair.

  1. Na página de Gerenciamento de API, selecione Vincular API.

  2. Importar Funções do Azure é exibido com a função TurbineRepair realçada. Clique em Selecionar para continuar.

    Import Azure Functions into API Management

  3. Na página Criar com base no Aplicativo de Funções, aceite os padrões e selecione Criar.

    Create from Function App

    O Azure cria a API para a função.

Baixar a definição de OpenAPI

Depois que suas funções foram importadas, você pode baixar a definição de OpenAPI da instância do Gerenciamento de API.

  1. Selecione Baixar definição de OpenAPI na parte superior da página.

    Download OpenAPI definition

  2. Salve o arquivo JSON baixado e abra-o. Examine a definição.

Próximas etapas

Você já pode refinar a definição no Gerenciamento de API no portal. Também é possível saber mais sobre o Gerenciamento de API.

Editar a definição de OpenAPI no Gerenciamento de API