Expor ou disponibilizar APIs sem servidor a partir de endpoints HTTP usando o Azure API Management

O Azure Functions integra-se com a Gestão de API do Azure no portal para permitir expor os seus pontos de extremidade da função de gatilho HTTP como APIs REST. Essas APIs são descritas usando uma definição 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ção, você pode fazer com que o Gerenciamento de API gere essas definições de OpenAPI.

Este artigo mostra como integrar seu aplicativo de função ao Gerenciamento de API. Essa integração funciona para aplicativos funcionais desenvolvidos em qualquer idioma suportado. Você também pode importar seu aplicativo de função 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 integram ao Gerenciamento de API.

Criar a instância de Gerenciamento de API

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

1. Selecione o aplicativo de função, escolha Gerenciamento de API no menu à esquerda e, em seguida, selecione Criar novo em 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	A sua subscrição	A assinatura sob a qual esse novo recurso é criado.
   Grupo de recursos	meuGrupoDeRecursos	O mesmo recurso que a sua aplicação de funções, e que será configurado para si.
   Região	Localização do serviço	Considere escolher a mesma localização da sua aplicação de funções.
   Nome do recurso	Nome globalmente exclusivo	Um nome é gerado com base no nome do seu aplicativo de função.
   Nome da organização	Contoso	O nome da organização usado no portal do desenvolvedor e para notificações por e-mail.
   E-mail do administrador	o seu email	E-mail que recebeu notificações de sistema da Gestão de API.
   Nível 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, consulte a página de preços do Gerenciamento de API

3. Escolha Rever + criar e, em seguida, 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 pontos de extremidade de função acionados por HTTP. Este exemplo importa um endpoint chamado TurbineRepair.

1. Na página de Gestão de API, selecione Associar API.

2. O Import Azure Functions abre-se com a função TurbineRepair em destaque. Escolha Selecionar para continuar.

3. Na página Criar a partir da Aplicação de Função , aceite as predefinições e, em seguida, selecione Criar. O Azure cria a API para a função.

Faça o download da definição da OpenAPI

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

1. Selecione Download OpenAPI definition na parte superior da página.

   

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

Próximos passos

Agora você pode refinar a definição em Gerenciamento de API no portal. Você também pode saber mais sobre o Gerenciamento de API.

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