Tutorial: Uso de la extensión Azure API Management para Visual Studio Code a fin de importar y administrar las API

SE APLICA A: Consumo | Desarrollador | Básico | Estándar | Premium

En este tutorial, aprenderá a usar la extensión de Azure API Management para Visual Studio Code para operaciones comunes en API Management. Puede usar el entorno conocido de Visual Studio Code para importar, actualizar, probar y administrar API.

Nota:

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

En este artículo aprenderá a:

• Importación de una API en API Management
• Editar la API
• Aplicar las directivas de API Management
• Prueba de la API

Para obtener una introducción a más características de API Management, consulte Importación y publicación de la primera API.

Requisitos previos

• Conocer la terminología de Azure API Management.
• Instale Visual Studio Code y la extensión de Azure API Management más reciente para Visual Studio Code.
• Cree una instancia de API Management.

Importación de una API

En el ejemplo siguiente se importa una especificación de OpenAPI en formato JSON a API Management. En este ejemplo, se importa el código abierto API de Petstore.

1. En Visual Studio Code, seleccione el icono de Azure en la barra de actividades.

2. En el panel del Explorador, expanda la instancia de API Management que haya creado.

3. Haga clic con el botón derecho en API y seleccione Import from OpenAPI Link (Importar desde el vínculo de OpenAPI).

4. Cuando se le solicite, escriba los siguientes valores:

   1. Un vínculo de OpenAPI para el contenido en formato JSON. En este ejemplo: https://petstore.swagger.io/v2/swagger.json .

      Este archivo especifica el servicio back-end que implementa la API de ejemplo y las operaciones que admite.

   2. Un nombre de API, como petstore, que es único en la instancia de API Management. Este nombre solo puede contener letras, números y guiones. El primer y el último carácter deben ser alfanuméricos. Este nombre se utiliza en la ruta de acceso para llamar a la API.

Una vez que la API se haya importado correctamente, aparecerá en el panel del Explorador, y las operaciones de API disponibles se mostrarán bajo el nodo Operations (Operaciones).

Editar la API

Puede editar la API en Visual Studio Code. Por ejemplo, edite la descripción JSON de Resource Manager de la API en la ventana del editor para quitar el protocolo http usado para acceder a la API, que se resalta en el siguiente recorte:

Para editar el formato de OpenAPI, haga clic con el botón derecho en el nombre de la API en el panel del Explorador y seleccione Edit OpenAPI (Editar OpenAPI). Realice los cambios y después seleccione Archivo>Guardar.

Aplicación de directivas a la API

API Management proporciona directivas que puede configurar para las API. Las directivas son una colección de instrucciones. Estas instrucciones se ejecutan secuencialmente en la solicitud o respuesta de una API. Las directivas pueden ser globales, que se aplican a todas las API de la instancia de API Management, o específicas para un producto, una API o una operación de API.

En esta sección, se muestra cómo aplicar directivas comunes de entrada y salida a la API.

1. En el panel Explorador, seleccione Política en la API petstore que importó. El archivo de directivas se abre en la ventana del Editor. Este archivo configura las directivas para todas las operaciones de la API.

2. Actualice el archivo con el siguiente contenido.

   <policies>
       <inbound>
           <rate-limit calls="3" renewal-period="15" />
           <base />
       </inbound>
       <outbound>
           <set-header name="Custom" exists-action="override">
               <value>"My custom value"</value>
             </set-header>
           <base />
       </outbound>
       <on-error>
           <base />
       </on-error>
   </policies>
   

   • La rate-limit directiva de la inbound sección limita el número de llamadas a la API a 3 llamadas cada 15 segundos.
   • La directiva set-header de la sección outbound agrega un encabezado de respuesta personalizado con fines de demostración.

3. Guarde el archivo. Si se le solicita, seleccione Cargar para cargar el archivo en la nube.

Prueba de la API

Para probar la API, obtenga una clave de suscripción y, a continuación, realice una solicitud a la puerta de enlace de API Management.

Establecimiento de la clave de suscripción

Necesita una clave de suscripción para su instancia de API Management para probar la API importada y las políticas que se aplican.

1. En el panel del Explorador, haga clic con el botón derecho en el nombre de la instancia de API Management.

2. Seleccione Copy Subscription Key (Copiar la clave de suscripción). Esta clave es para la suscripción de acceso integrada que se crea al crear una instancia de API Management.

   

   Precaución

   La suscripción de acceso completo permite el acceso a cada API en esta instancia de API Management y solo debe ser utilizada por usuarios autorizados. Nunca la use para el acceso de API rutinario o inserte la clave de acceso completo en las aplicaciones cliente.

Prueba de una operación de API

1. En el panel del Explorador, expanda el nodo Operaciones debajo de la API petstore importada.

2. Seleccione una operación, como [GET] Find pet by ID, y, después, haga clic con el botón derecho en ella y seleccione Operación de prueba.

3. En la ventana del editor, sustituya 5 por el parámetro petId en la dirección URL de la solicitud.

4. En la ventana del editor, junto a Ocp-Apim-Subscription-Key, pegue la clave de suscripción que copió.

5. Seleccione Enviar solicitud.

   

Si la solicitud es correcta, el back-end responde con 200 OK y algunos datos.

Observe los siguientes detalles en la respuesta:

• El encabezado Custom se agrega a la respuesta.

Ahora pruebe la directiva de limitación de velocidad. Seleccione Enviar solicitud varias veces en una fila. Después de enviar demasiadas solicitudes en el período configurado, obtendrá la respuesta 429 Too Many Requests.

Procesamiento de solicitudes de seguimiento

Opcionalmente, puede obtener información detallada de seguimiento de solicitudes para ayudarle a depurar y solucionar problemas de la API.

Para conocer los pasos para habilitar el seguimiento de una API, consulte Habilitación del seguimiento de una API. Para limitar la divulgación no intencionada de información confidencial, el seguimiento de forma predeterminada solo se permite durante 1 hora.

Limpieza de recursos

Cuando ya no la necesite, elimine la instancia de API Management; para ello, haga clic con el botón derecho y seleccione Abrir en el portal para eliminar el servicio API Management y su grupo de recursos.

O bien, puede seleccionar Eliminar API Management para eliminar solo la instancia de API Management. Esta operación no elimina su grupo de recursos.

Contenido relacionado

La extensión API Management proporciona más características para trabajar con las API, como:

• Creación, comprensión y depuración de directivas de Azure API Management (disponibles en el nivel de servicio Desarrollador)
• Uso de valores con nombre en directivas de Azure API Management