Creación de una API básica de administración de recursos con Azure Functions (versión preliminar)

En este artículo se explica cómo crear una API ficticia básica para una aplicación de administración de recursos mediante Azure Functions. La API expone una sola operación para devolver una lista de recursos. También aprenderá a crear un conector personalizado en Power Platform mediante API Management.

Nota:

Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes de una versión oficial para que los clientes puedan obtener acceso anticipado y proporcionar comentarios.

Esta API básica proporciona una lista de recursos ficticio y está lista para la integración con Power Platform mediante un conector personalizado a través de API Management.

Prerrequisitos

• Acceso a Azure Portal
• Entorno de Power Platform con aplicaciones de código habilitadas

Creación de una nueva función de Azure en Azure Portal

1. Vaya a Azure Portal.

2. Seleccione Crear un recurso>>Web Function App.

3. Seleccione Consumo.

4. Rellene los detalles necesarios:

   Detalle	Description
   Subscription	Seleccionar su suscripción
   Grupo de recursos	Crear uno nuevo o usar uno existente
   Nombre de la aplicación de función	Elegir un nombre único
   Pila en tiempo de ejecución	Node.js.
   Region	Elija una región cercana a usted

5. Seleccione Revisar y crear y, a continuación, Crear.

   

6. Una vez completada la implementación, vaya a la nueva aplicación de funciones.

7. Seleccione Crear función.

8. Si se le pregunta, seleccione: Entorno de desarrollo: Desarrollar en el portal.

9. Seleccione desencadenador HTTP como plantilla, asígnele el nombre GetAssetsy establezca Nivel de autorización en Anónimo porque no se requiere autenticación en este ejemplo básico.

   

10. Seleccione Crear para crear la función.

11. En la pestaña Código y prueba , reemplace el código de función por el código de API ficticio de la sección siguiente.

12. Haga clic en Guardar.

Implementación de la API ficticia

Edite GetAssets/index.js para devolver una lista ficticia de recursos:

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" }
        ]
    };
};

Exponga su aplicación de funciones mediante API Management

1. En Azure Portal, busque y seleccione Servicios de API Management.

2. Seleccione + Crear para crear una nueva instancia de API Management. El nivel Desarrollador es gratuito para desarrollo y pruebas.

3. Rellene los detalles necesarios e implemente la instancia.

4. Una vez implementado, abra la instancia de API Management.

5. En el menú de la izquierda, seleccione APIs>+ Agregar API>Aplicación de Funciones.

   

6. Selecciona tu aplicación de funciones y la función GetAssets.

   

7. Completa el asistente para importar tu función como una operación de API.

8. Después de la importación, vaya a la API en API Management.

9. En el menú superior, seleccione Configuración para la API.

10. En Seguridad, establezca Suscripción necesaria en Desactivado. Esto elimina la necesidad de una clave de suscripción (clave de API) al llamar a la API.

    

11. Guarde los cambios.

Creación de un conector personalizado en Power Platform mediante API Management (desde Azure Portal)

1. En API Management Services En el menú izquierdo de las API, seleccione Power Platform.

2. Seleccione Crear un conector.

3. Seleccione la API:

   

4. Seleccione el entorno y el nombre para mostrar y, a continuación, seleccione Crear. El conector personalizado se crea en el entorno seleccionado.

5. En Power Apps, vaya a Conectores personalizados para revisar, editar y probar el nuevo conector.

   

Pasos siguientes

• Crear una nueva aplicación de código usando este conector personalizado con el SDK de Power Apps
• Expanda la API con más operaciones según sea necesario. No olvide actualizar el conector con las nuevas operaciones cuando lo haga.
• Proteja la API si va más allá del desarrollo o las pruebas.