Expor APIs sem servidor a partir de pontos finais HTTP com o Azure Gestão de API

  • Artigo

Funções do Azure integra-se no Azure Gestão de API no portal para permitir expor os pontos finais da função de acionador HTTP como APIs REST. Estas APIs são descritas com uma definição OpenAPI. Este ficheiro JSON (ou YAML) contém informações sobre que operações estão disponíveis numa API. Inclui detalhes sobre como os dados de pedido e resposta da API devem ser estruturados. Ao integrar a sua aplicação de funções, pode ter Gestão de API gerar estas definições de OpenAPI.

Este artigo mostra-lhe como integrar a sua aplicação de funções com Gestão de API. Esta integração funciona para aplicações de funções desenvolvidas em qualquer linguagem suportada. Também pode importar a aplicação de funções do Azure Gestão de API.

Para funções de biblioteca de classes C#, também pode utilizar o Visual Studio para criar e publicar API sem servidor que se integra com Gestão de API.

Criar a instância Gestão de API

Para criar uma instância Gestão de API ligada à sua aplicação de funções:

  1. Selecione a aplicação de funções, selecione Gestão de API no menu esquerdo e, em seguida, selecione Criar novoem Gestão de API.

    Selecione Gestão de API

  2. Utilize as definições de Gestão de API conforme especificado na tabela seguinte:

    Definição Valor sugerido Descrição
    Nome Nome globalmente exclusivo É gerado um nome com base no nome da sua aplicação de funções.
    Subscrição A sua subscrição A subscrição na qual este novo recurso é criado.
    Grupo de recursos myResourceGroup O mesmo recurso que a sua aplicação de funções, que deve ser definido para si.
    Localização Localização do serviço Considere escolher a mesma localização que a sua aplicação de funções.
    Nome da organização Contoso O nome da organização utilizada no portal do programador e para notificações por e-mail.
    E-mail do administrador o seu e-mail Email que receberam notificações do sistema de Gestão de API.
    Escalão de preço Consumo O escalão de consumo não está disponível em todas as regiões. Para obter detalhes de preços completos, veja a página de preços do Gestão de API

    Criar novo serviço de Gestão de API

  3. Selecione Exportar para criar a instância Gestão de API, o que pode demorar vários minutos.

  4. Depois de o Azure criar a instância, ativa a opção Ativar o Application Insights na página. Selecione-a para enviar registos para o mesmo local que a aplicação de funções.

Funções de importação

Após a criação da instância Gestão de API, pode importar os pontos finais da função acionada por HTTP. Este exemplo importa um ponto final chamado TurbineRepair.

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

  2. A Funções do Azure Importar é aberta com a função TurbineRepair realçada. Selecione Selecionar para continuar.

    Importar Funções do Azure para Gestão de API

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

    Criar a partir da Aplicação de Funções

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

Transferir a definição de OpenAPI

Depois de as suas funções terem sido importadas, pode transferir a definição OpenAPI da instância Gestão de API.

  1. Selecione Transferir definição openAPI na parte superior da página.

    Transferir a definição OpenAPI

  2. Guarde o ficheiro JSON transferido e, em seguida, abra-o. Reveja a definição.

Passos seguintes

Agora, pode refinar a definição no Gestão de API no portal. Também pode saber mais sobre Gestão de API.

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