Importación de una aplicación de funciones de Azure como API en Azure API Management

2025-06-05

SE APLICA A: Todos los niveles de API Management

Azure API Management admite la importación de aplicaciones de funciones de Azure como nuevas API o anexarlas a las API existentes. El proceso genera automáticamente una clave de host en la aplicación de funciones de Azure, que luego se asigna a un valor con nombre en API Management.

Nota:

Actualmente esta característica no está disponible en las áreas de trabajo.

En este artículo se describe cómo importar una aplicación de funciones de Azure como UNA API en Azure API Management y probar la API.

Aprenderá a:

Importación de una aplicación de funciones de Azure como API
Anexar una aplicación de funciones de Azure a una API
Ver la nueva clave de host de aplicación de funciones y el valor con nombre de API Management
Prueba de la API en Azure Portal

Prerrequisitos

Complete el inicio rápido Creación de una instancia de Azure API Management.
Asegúrese de que tiene una aplicación de funciones de Azure en la suscripción. Para obtener más información, consulte Introducción a Azure Functions. La función debe tener un desencadenador HTTP. El nivel de autorización debe establecerse en Anónimo o Función.

Nota:

También puede usar la extensión de API Management para Visual Studio Code para importar y administrar las API. Complete el tutorial de la extensión de API Management para empezar.

Importación de una aplicación de funciones de Azure como una nueva API

Para crear una nueva API desde una aplicación de funciones de Azure:

Vaya a su servicio API Management en el portal de Azure.
Seleccione APIs> en el panel izquierdo.
En Crear desde un recurso de Azure, seleccione Function App:
Seleccione el botón Examinar :
Haga clic en el botón Seleccionar en Configurar las opciones necesarias para elegir entre la lista de aplicaciones de funciones disponibles:
Busque la aplicación de funciones desde la que desea importar funciones, selecciónela y, a continuación, haga clic en Seleccionar:
Seleccione las funciones que desea importar y haga clic en Seleccionar. Solo puede importar funciones que tengan un desencadenador HTTP y un nivel de autorización anónimo o de función .
Cambie a la vista Completa y asigne un producto a la nueva API.
Nota:

Los productos son asociaciones de una o varias API que se ofrecen a los desarrolladores a través del portal para desarrolladores. En primer lugar, los desarrolladores deben suscribirse a un producto para acceder a la API. Cuando se suscriben, obtienen una clave de suscripción para cualquier API del producto. Si creó la instancia de API Management, es administrador y está suscrito a todos los productos de forma predeterminada.

En algunos planes de tarifa, las instancias de API Management incluyen dos productos de ejemplo predeterminados:
- Iniciador
- Sin límite
Según sea necesario, especifique otras opciones de configuración. También puede especificar la configuración más adelante a través de la pestaña Configuración . Esta configuración se explica en el tutorial Importación y publicación de la primera API .
Selecciona Crear.

Anexar una aplicación de funciones a una API existente

Para anexar una aplicación de funciones a una API existente:

En la instancia del servicio Azure API Management, seleccione API API> en el panel izquierdo.
Elija una API a la que desea importar una aplicación de funciones. Seleccione los puntos suspensivos (...) junto a la API y, a continuación, seleccione Importar:
Seleccione el icono aplicación de funciones :
En la ventana Importar desde aplicación de funciones, seleccione Examinar:
Haga clic en el botón Seleccionar en Configurar las opciones necesarias para elegir entre la lista de aplicaciones de funciones disponibles:
Busque la aplicación de funciones desde la que desea importar funciones, selecciónela y, a continuación, haga clic en Seleccionar:
Seleccione las funciones que desea importar y, a continuación, haga clic en Seleccionar:
Seleccione Importar:

Autorización

Al importar una aplicación de funciones de Azure, estos elementos se generan automáticamente:

Una clave de host en la aplicación de funciones. La clave se denomina apim-<your API Management service instance name>.
Valor con nombre en la instancia de API Management que tiene el nombre <your Azure function app instance name>-key. Este valor contiene la clave de host.

En el caso de las API creadas después del 4 de abril de 4, 2019, la clave de host se pasa en las solicitudes HTTP desde API Management a la aplicación de funciones en un encabezado. Las API más antiguas pasan la clave de host como un parámetro de consulta. Puede cambiar este comportamiento mediante la llamada a la PATCH BackendAPI REST en la Backend entidad asociada a la aplicación de funciones.

Advertencia

Al quitar o cambiar el valor de clave de host de la aplicación de funciones de Azure o el valor denominado de Administración de API, se deshabilitará la comunicación entre los servicios. Los valores no se sincronizan automáticamente.

Si necesita rotar la clave de host, asegúrese de cambiar también el valor con nombre en API Management.

Acceso a una clave de host de la aplicación de funciones

Vaya a la instancia de aplicación de funciones de Azure:
En la sección Funciones del panel izquierdo, seleccione Claves de aplicación:
Busque las claves en la sección Claves de host :

Acceso al valor con nombre en API Management

Vaya a la instancia de API Management y seleccione API>Valores con nombre en el panel izquierdo. La clave de la aplicación de funciones de Azure se almacena allí.

Prueba de la nueva API en Azure Portal

Puede llamar a operaciones directamente desde Azure Portal. Mediante Azure Portal es una manera cómoda de ver y probar las operaciones de una API.

Seleccione la API que ha creado en la sección anterior.
Seleccione la pestaña Prueba.
Seleccione la operación que desea probar.
- La página muestra los campos de los parámetros de consulta y de los encabezados.
- Uno de los encabezados es Ocp-Apim-Subscription-Key. Este encabezado es para la clave de suscripción de producto asociada a la API.
- Si creó la instancia de API Management, es administrador, por lo que la clave se rellena automáticamente.
Seleccione Enviar.

Cuando la prueba se realiza correctamente, el back-end responde con 200 OK y algunos datos.

Compartir a través de