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

O Azure Functions se integra ao Gerenciamento de API do Azure no portal para permitir que você exponha os endpoints das funções de gatilho HTTP como APIs REST. Essas 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 da API devem ser estruturados. Ao integrar seu aplicativo de funções, você pode fazer com que o Gerenciamento de API gere essas definições de OpenAPI.

Este artigo mostra como integrar seu aplicativo de funções ao Gerenciamento de API. Essa integração funciona para aplicativos de funções desenvolvidos em qualquer idioma 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 a API sem servidor que se integra ao Gerenciamento de API.

Criar a instância de Gerenciamento de API

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

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

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

   Configurações	Valor sugerido	Descrição
   Subscrição	Sua assinatura	A assinatura sob a qual esse novo recurso é criado.
   Grupo de recursos	GrupoDeRecursosMeu	O mesmo recurso que seu aplicativo de funções, que deve estar definido para você.
   Região	Local do serviço	Considere escolher o mesmo local que seu aplicativo de funções.
   Nome do recurso	Nome globalmente exclusivo	Um nome é gerado com base no nome do aplicativo de funções.
   Nome da organização	Contoso	O nome da organização usada no portal do desenvolvedor e para notificações por email.
   Email do administrador	o seu e-mail	Email que recebeu notificações do sistema de Gestão de API.
   Tipo de preços	Consumo	A camada de consumo não está disponível em todas as regiões. Para obter detalhes de preços completos, consulte a página de preços do Gerenciamento de API

3. Escolha Examinar + criar e criar para criar a instância de Gerenciamento de API, o que pode levar vários minutos.

Importar funções

Depois que a instância de Gerenciamento de API for criada, você poderá importar seus endpoints de funções acionadas por HTTP. Este exemplo importa um ponto de extremidade chamado TurbineRepair.

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

2. O Import Azure Functions abre destacando a função TurbineRepair. Selecione Selecionar para continuar.

3. Na página Criar a partir do Aplicativo de Funções , aceite os padrões e selecione Criar. O Azure cria a API para a função.

Baixar a definição de OpenAPI

Depois que suas funções tiverem sido importadas, você poderá baixar a definição openapi da instância de Gerenciamento de API.

1. Selecione Baixar a definição openapi na parte superior da página.

   

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