Exposición de API sin servidor desde puntos de conexión HTTP mediante Azure API Management

Azure Functions se integra con Azure API Management en el portal para permitirle exponer los puntos de conexión de la función de desencadenador HTTP como API REST. Estas API se describen mediante una definición de OpenAPI. Este archivo JSON (o YAML) contiene información sobre qué operaciones están disponibles en una API. Incluye detalles sobre cómo se deben estructurar los datos de solicitud y respuesta de la API. Al integrar la aplicación de funciones, puede hacer que API Management genere estas definiciones de OpenAPI.

En este artículo se muestra cómo integrar la aplicación de funciones con API Management. Esta integración funciona para las aplicaciones de funciones desarrolladas en cualquier lenguaje compatible. También puede importar la aplicación de funciones desde Azure API Management.

En el caso de las funciones de biblioteca de clases de C#, también puede usar Visual Studio para crear y publicar api sin servidor que se integren con API Management.

Creación de la instancia de API Management

Para crear una instancia de API Management vinculada a la aplicación de funciones:

1. Seleccione la aplicación de funciones, elija API Management en el menú de la izquierda y, a continuación, seleccione Crear nuevo en API Management.

2. Use la configuración de API Management como se especifica en la tabla siguiente:

   Configuración	Valor sugerido	Descripción
   Suscripción	Su suscripción	La suscripción en la que se crea este nuevo recurso.
   Grupo de recursos	myResourceGroup	El mismo recurso que la aplicación de función, que debe establecerse automáticamente.
   Región	Ubicación del servicio	Considere la posibilidad de elegir la misma ubicación que en el caso de la aplicación de funciones.
   Nombre del recurso	Nombre único global	Se genera un nombre basado en el nombre de la aplicación de funciones.
   Nombre de la organización	Contoso	Nombre de la organización usada en el portal para desarrolladores y para las notificaciones por correo electrónico.
   Correo electrónico del administrador	su correo electrónico	Correo electrónico que recibe las notificaciones del sistema desde API Management.
   Nivel de precios	Consumo	El nivel de consumo no está disponible en todas las regiones. Para obtener detalles completos sobre los precios, consulte la página de precios de API Management.

3. Elija Revisar y crear y, a continuación, Crear para crear la instancia de API Management, que puede tardar varios minutos.

Funciones de importación

Una vez que se haya creado la instancia de API Management, puede importar sus puntos de conexión de funciones activadas por HTTP. En este ejemplo se importa un endpoint denominado TurbineRepair.

1. En la página API Management, seleccione Vincular API.

2. Se abre Importar Azure Functions con la función TurbineRepair resaltada. Elija Seleccionar para continuar.

3. En la página Crear desde function App , acepte los valores predeterminados y, a continuación, seleccione Crear. Azure crea la API para la función.

Descarga de la definición de OpenAPI

Una vez importadas las funciones, puede descargar la definición de OpenAPI desde la instancia de API Management.

1. Seleccione Descargar definición de OpenAPI en la parte superior de la página.

   

2. Guarde el archivo JSON descargado y ábralo. Revise la definición.

Pasos siguientes

Ahora puede refinar la definición de API Management en el portal. También puede obtener más información acerca de API Management.

Edición de la definición de OpenAPI en API Management