Como criar uma API básica de gerenciamento de ativos com Azure Functions

Este artigo explica como criar uma API simulada básica para um aplicativo de gerenciamento de ativos usando Azure Functions. A API expõe uma única operação para retornar uma lista de ativos. Você também aprenderá a criar um conector personalizado no Power Platform usando API Management.

Essa API básica fornece uma lista de ativos simulada e está pronta para integração com o Power Platform usando um conector personalizado por meio de API Management.

Pré-requisitos

• Acesso ao portal Azure
• Ambiente do Power Platform com aplicativos de código habilitados

Criar uma nova função de Azure no Azure portal

1. Vá para o Azure portal.

2. Selecione Criar um recurso>Web>Aplicativo de Funções.

3. Selecione Consumo.

4. Preencha os detalhes necessários:

   Detalhes	Description
   Subscription	Selecione sua assinatura
   Grupo de Recursos	Criar um novo ou usar um existente
   Nome do aplicativo de funções	Escolher um nome exclusivo
   Pilha de tempo de execução	Node.js
   Região	Escolher uma região próxima a você

5. Selecione Examinar + criar e depois Criar.

   

6. Depois que a implantação for concluída, vá para o novo Aplicativo de Funções.

7. Selecione Criar função.

8. Se solicitado, selecione: Ambiente de desenvolvimento: Desenvolver no portal.

9. Selecione o gatilho HTTP como o modelo, dê-lhe o nome GetAssetse defina o nível de autorização como Anônimo porque nenhuma autenticação é necessária neste exemplo básico.

   

10. Selecione Criar para criar a função.

11. Na guia Código + Teste , substitua o código da função pelo código de API fictício da próxima seção.

12. Clique em Salvar.

Implementar a API simulada

Edite GetAssets/index.js para retornar uma lista simulada de ativos:

module.exports = async function (context, req) {
    context.res = {
        // status: 200, /* Defaults to 200 */
        body: [
            { id: 1, name: "Laptop", type: "Electronics", status: "Available" },
            { id: 2, name: "Projector", type: "Electronics", status: "In Use" },
            { id: 3, name: "Desk", type: "Furniture", status: "Available" },
            { id: 4, name: "Office Chair", type: "Furniture", status: "In Use" },
            { id: 5, name: "Monitor", type: "Electronics", status: "Available" },
            { id: 6, name: "Whiteboard", type: "Office Supply", status: "Available" },
            { id: 7, name: "Phone", type: "Electronics", status: "In Use" },
            { id: 8, name: "Tablet", type: "Electronics", status: "Available" },
            { id: 9, name: "Printer", type: "Electronics", status: "Maintenance" },
            { id: 10, name: "Filing Cabinet", type: "Furniture", status: "Available" }
        ]
    };
};

Exponha seu aplicativo de funções por meio do gerenciamento de API

1. No Azure portal, pesquise e selecione API Management services.

2. Selecione + Criar para criar uma nova instância de API Management. A camada Desenvolvedor é gratuita para desenvolvimento/teste.

3. Preencha os detalhes necessários e implante a instância.

4. Depois de implantado, abra sua instância de API Management.

5. No menu à esquerda, selecione APIs>+ Adicionar API>Aplicativo de Funções.

   

6. Selecione seu Aplicativo de Funções e a GetAssets função.

   

7. Conclua o assistente para importar sua função como uma operação de API.

8. Após a importação, vá para a API em API Management.

9. No menu superior, selecione Configurações para sua API.

10. Em Segurança, defina Assinatura exigida como Desativada. Isso remove a necessidade de uma chave de assinatura (chave de API) ao chamar a API.

    

11. Salve suas alterações.

Criar um conector personalizado no Power Platform usando API Management (de Azure portal)

1. Em API Management Services No menu à esquerda nas APIs, selecione Power Platform.

2. Selecione Criar um conector.

3. Selecione sua API:

   

4. Selecione seu ambiente e nome de exibição e, em seguida, selecione Criar. O conector personalizado é criado em seu ambiente selecionado.

5. Em Power Apps, acesse Conectores Personalizados para examinar, editar e testar seu novo conector.

   

Próximas etapas

• Crie um novo aplicativo de código usando esse conector personalizado com biblioteca cliente do Power Apps para aplicativos de código
• Expanda a API com mais operações conforme necessário. Não se esqueça de atualizar o conector com as novas operações quando você fizer isso.
• Proteja sua API ao avançar além do desenvolvimento/teste.