Exercício - Integrar API da Web habilitada para OpenAPI com o Gerenciamento de API do Azure

Concluído

Neste exercício, você vai integrar seu aplicativo de API Web em execução no Serviço de Aplicativo ao Gerenciamento de API do Azure por meio do Visual Studio.

Observação

No exercício anterior, você criou um aplicativo de API Web do ASP.NET Core com o recurso OpenAPI habilitado. Você usará o aplicativo para este exercício.

Integrar o aplicativo de API Web ao Gerenciamento de API do Azure por meio do Visual Studio

O aplicativo de API Web está pronto para ser publicado. Para implantar o aplicativo de API Web, execute as etapas abaixo.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione o menu Publicar. Selecione +Novo perfil se o menu a seguir não aparecer.

    Captura de tela mostrando como selecionar o menu de publicação.

  2. Na caixa de diálogo modal Publicar, selecione Azure e escolha o botão Avançar.

    Escolher destino de publicação.

  3. Selecione Serviço de Aplicativo do Azure (Windows) e escolha o botão Avançar.

    Escolher destino específico.

  4. Como você já publicou seu aplicativo de API da Web em uma instância do Serviço de Aplicativo do Azure na unidade anterior, você pode vê-lo no modal de diálogo. Selecione a instância do Serviço de Aplicativo e selecione o botão Avançar.

    Escolher Serviço de Aplicativo existente.

  5. Embora você possa usar uma instância existente do Azure API Management, se desejar, vamos criar uma nova por meio do Visual Studio. Selecione o botão do modal de diálogo para criar uma nova instância do Azure Gerenciamento de API.

    Selecione Criar novo Gerenciamento de API.

  6. Quando uma nova caixa de diálogo API no Gerenciamento de API é exibida, a maioria dos valores de campo obrigatórios são preenchidos automaticamente. Você pode usar os campos pré-preenchidos ou alterá-los. Preencha todos os valores de campo. Ainda não há, no entanto, nenhuma instância do Gerenciamento de API. Selecione o botão Novo... do modal de diálogo.

    Criar nova API no Gerenciamento de APIs.

  7. Outra janela de diálogo pop-up aparece para criar uma nova instância do Azure Gerenciamento de API. Todos os valores de campo já foram preenchidos. Você pode usá-los ou alterá-los. Selecione o botão OK.

    Criar novo gerenciamento de API.

  8. Após o fechamento da caixa de diálogo modal Gerenciamento de API do Azure, a caixa de diálogo modal API no Gerenciamento de API mostra o nome da instância do Gerenciamento de API. Selecione o botão Criar.

    Criar nova API no Gerenciamento de API Preenchido.

  9. A instância do Gerenciamento de API do Azure está pronta para ser integrada ao aplicativo de API Web da instância do Serviço de Aplicativo do Azure. Selecione o botão Concluir.

    Concluir publicação no Gerenciamento de API.

  10. Seu aplicativo de API Web está pronto para ser implantado. Marque a mensagem Dependências de Serviço na parte inferior da janela do Visual Studio e confirme se a instância de Gerenciamento de API do Azure também está configurada para integração. Selecione o botão Publicar no Visual Studio.

    Publicar API Web.

  11. Quando o aplicativo de API Web é publicado, o Visual Studio te notifica por meio de um banner.

    API da Web publicada.

Como você também criou a instância do Gerenciamento de API do Azure e integrou o aplicativo de API Web a ela, é possível verificá-la no portal do Azure.

Verificar a integração da API Web no Gerenciamento de API do Azure

  1. Para verificar se a API Web foi integrada ao Gerenciamento de API do Azure, abra um navegador da Web e faça logon no portal do Azure. Insira a palavra-chave gerenciamento de API na barra de pesquisa na parte superior do portal do Azure. Quando aparecer Serviços do Gerenciamento de API, selecione-o.

    Gerenciamento de API de pesquisa.

  2. Selecione sua instância de Gerenciamento de API do Azure.

    Instâncias do Gerenciamento de API.

  3. No menu à esquerda, em APIs, selecione a API de Gerenciamento de Inventário. Escolha a operação /api/WarehouseLocations – GET e selecione a guia Teste, no meio da página.

    Gerenciamento de API – API.

  4. Selecione o botão Enviar para enviar uma solicitação de teste para a API Web.

    Gerenciamento de API – Teste de API.

  5. A resposta da solicitação de API é exibida.

    Gerenciamento de API – Resultado do teste de API.

Parabéns! Você integrou seu aplicativo de API Web ao Gerenciamento de API do Azure por meio do Visual Studio.