Depuración de directivas de Azure API Management en Visual Studio Code
Artículo
SE APLICA A: Desarrollador
Las directivas de Azure API Management proporcionan funcionalidades eficaces que ayudan a los editores de API a abordar cuestiones transversales, como la autenticación, la autorización, la limitación, el almacenamiento en caché y la transformación. Las directivas son una colección de declaraciones que se ejecutan secuencialmente en la solicitud o respuesta de una API.
Esta característica usa la suscripción de acceso completo (nivel de servicio) integrada (nombre para mostrar "Suscripción de acceso completo integrada") para la depuración.
Importante
API Management ya no admite suscripciones para el seguimiento o el encabezado Ocp-Apim-Trace.
Para mejorar la seguridad, ahora se puede habilitar el seguimiento en el nivel de una API individual al obtener un token de tiempo limitado mediante la API de REST de API Management y pasar el token en una solicitud a la puerta de enlace. Para más información, vea Habilitación del seguimiento de una API.
Tenga cuidado al habilitar el seguimiento, ya que puede exponer información confidencial en los datos de seguimiento. Asegúrese de tener las medidas de seguridad adecuadas para proteger los datos de seguimiento.
Inicio de una sesión de depuración
Iniciar Visual Studio Code
Diríjase a la extensión de API Management en las extensiones de Azure.
Busque la instancia de API Management que quiere depurar.
Busque la API y la operación que quiere depurar.
Haga clic con el botón derecho en la operación y seleccione Start Policy Debugging (Iniciar la depuración de directiva).
En este momento, la extensión intentará iniciar y establecer una sesión de depuración con la puerta de enlace de API Management.
Envío de una solicitud de prueba
Cuando se establezca la sesión de depuración, la extensión abrirá un nuevo editor que nos permitirá crear y enviar una solicitud HTTP de prueba a esta operación con la extensión de cliente REST.
Observará que el encabezado Ocp-Apim-Debug ya se ha agregado a la solicitud. Este encabezado es obligatorio y el valor se debe establecer en la clave de suscripción de acceso a todo de nivel de servicio para desencadenar la funcionalidad de depuración en la puerta de enlace de API Management.
Modifique la solicitud HTTP en el editor según el escenario de prueba. A continuación, haga clic en Enviar solicitud para enviar la solicitud de prueba a la puerta de enlace de API Management.
Depuración de directivas
Después de enviar la solicitud HTTP de prueba, la extensión abrirá la ventana depuración que muestra las directivas vigentes de esta operación y se detendrá en la primera directiva efectiva.
Para seguir la canalización de la directiva, puede realizar un paso único a través de directivas individuales o establecer un punto de interrupción en una directiva y pasar directamente a esa directiva.
En el panel Variables, puede inspeccionar los valores de las variables creadas por el sistema y creadas por el usuario. En el panel Puntos de interrupción, puede ver la lista de todos los puntos de interrupción que se han establecido. En el panel Pila de llamadas, puede ver el ámbito de la directiva vigente actual.
Si se produce un error durante la ejecución de la directiva, verá los detalles del error en la directiva en la que se produjo.
Sugerencia
Recuerde hacer clic en el botón Detener para salir de la sesión de depuración cuando termine.
Aprenda a depurar de forma eficaz una aplicación .NET con Visual Studio Code para corregir los errores rápidamente. Use el depurador interactivo de Visual Studio Code para analizar y corregir las aplicaciones de C#.
Cree soluciones de un extremo a otro en Microsoft Azure para crear Azure Functions, implementar y administrar aplicaciones web, desarrollar soluciones que usen Azure Storage, etc.
Aprenda a crear y administrar fragmentos de directivas reutilizables en Azure API Management. Los fragmentos de directiva son elementos XML que contienen configuraciones de directiva que se pueden incluir en cualquier definición de directiva.
Introducción a las directivas de API Management, que cambian el comportamiento de la API mediante la configuración Las instrucciones de directiva se ejecutan secuencialmente en una solicitud o respuesta de API.
Índice de referencia para todas las directivas y configuraciones de Azure API Management. Las directivas permiten que el publicador de la API cambie el comportamiento de esta mediante la configuración.
