azure-resource-lookup

Descripción general

¿Qué es azure-resource-lookup?

azure-resource-lookup es un skill de descubrimiento y generación de informes para Azure que te ayuda a listar, encontrar e inspeccionar recursos de Azure de casi cualquier tipo en varias suscripciones y grupos de recursos.

Utiliza Azure Resource Graph (ARG) para ejecutar consultas rápidas entre suscripciones sobre los metadatos de Azure Resource Manager (ARM). Esto lo hace especialmente adecuado para preguntas de tipo inventario, como:

• "list websites"
• "list virtual machines"
• "list my VMs in subscription X"
• "show storage accounts in this resource group"
• "find container apps in region Y"
• "what resources do I have?"

En segundo plano, azure-resource-lookup traduce estas intenciones en consultas ARG para que obtengas vistas estructuradas y casi en tiempo real de tu entorno sin tener que escribir KQL a mano para cada petición.

¿A quién va dirigido este skill?

azure-resource-lookup está orientado a:

• Ingenieros de cloud y plataforma que necesitan visibilidad rápida de los recursos de Azure en muchas suscripciones.
• Equipos de DevOps y SRE que quieren buscar tipos de recursos, estados o etiquetas específicos como parte de sus flujos operativos.
• Equipos de seguridad y cumplimiento que necesitan verificar que existan las etiquetas o configuraciones requeridas.
• Desarrolladores que quieren una forma sencilla de responder "¿dónde se está ejecutando esta app/componente?" o "¿qué recursos creó este despliegue?" sin navegar manualmente por Azure Portal.

Si tu necesidad principal es reporting, inventario y descubrimiento de recursos en Azure, este skill encaja bien.

¿Qué problemas resuelve azure-resource-lookup?

Utiliza azure-resource-lookup cuando necesites:

• Listar recursos de cualquier tipo común
  • Máquinas virtuales, aplicaciones web, cuentas de almacenamiento, container apps, bases de datos y más.
• Mostrar recursos por ámbito
  • Restringir los resultados a una suscripción concreta, a un conjunto de suscripciones o a un grupo de recursos específico.
• Ejecutar búsquedas entre suscripciones
  • Responder preguntas como "show all storage accounts in all production subscriptions" sin cambiar de contexto.
• Encontrar recursos huérfanos o sin uso
  • Detectar discos sin adjuntar, NICs sin uso, IPs inactivas y otros candidatos claros de limpieza.
• Comprobar cobertura y convenciones de etiquetas
  • Localizar recursos sin las etiquetas obligatorias o agrupar recursos por valores de etiqueta (como env, owner, costCenter).
• Crear un inventario de recursos
  • Contar recursos por tipo, región o suscripción para documentación o auditoría.
• Filtrar por estado del recurso
  • Encontrar recursos detenidos, con problemas de salud o con aprovisionamiento fallido usando los metadatos indexados en Resource Graph.

Esto se ajusta a casos de uso de reporting y visibilidad en los que necesitas vistas claras y consultables de tu infraestructura existente en Azure.

¿Cuándo no es adecuado este skill?

azure-resource-lookup no está diseñado para:

• Desplegar o modificar recursos
  • No crea, actualiza ni elimina recursos de Azure.
• Análisis de costes y optimización
  • No calcula gasto, recomendaciones de rightsizing ni desgloses detallados de costes.
• Nubes que no sean Azure o recursos on-premises
  • Es específico para recursos de Azure Resource Manager expuestos a través de Azure Resource Graph.
• Herramientas profundas específicas de recursos
  • Para operaciones muy especializadas sobre recursos (por ejemplo, trabajo con esquemas de bases de datos, gestión de objetos de Kubernetes o cambios detallados en la configuración de VMs), deberías usar herramientas dedicadas u otros skills.

Si necesitas visibilidad operativa e inventario en Azure, azure-resource-lookup es una buena opción. Si necesitas cambios, automatización o analítica de costes, combínalo con otras herramientas.

Cómo usarlo

Requisitos previos

Antes de instalar y usar azure-resource-lookup, asegúrate de que:

• Tienes una cuenta de Azure con permisos adecuados para leer recursos en las suscripciones de destino.
• Azure Resource Graph está disponible en tu tenant (está habilitado de forma predeterminada en la mayoría de los escenarios).
• Tu agente o entorno de automatización puede autenticarse en Azure (mediante az login, managed identity o service principal, según tu configuración).

El skill se encuentra en el repositorio de GitHub microsoft/azure-skills, en skills/azure-resource-lookup, y está diseñado para integrarse en runtimes de agente compatibles que soporten skills de este repositorio.

Pasos de instalación

1. Añade el repositorio azure-skills y este skill

Si tu runtime de agente soporta npx skills (por ejemplo, la herramienta de skills de Microsoft), puedes añadir azure-resource-lookup directamente desde GitHub:

npx skills add https://github.com/microsoft/azure-skills --skill azure-resource-lookup

Este comando:

• Registra el repositorio microsoft/azure-skills como origen de skills.
• Instala la definición del skill azure-resource-lookup y el material de referencia asociado en tu entorno de agente.

Si tu plataforma usa un mecanismo diferente, indícale:

• Repository: https://github.com/microsoft/azure-skills
• Skill path: skills/azure-resource-lookup

y sigue los pasos documentados de tu plataforma para añadir un skill.

2. Revisa la definición del skill

Tras la instalación, abre SKILL.md en el directorio azure-resource-lookup. Este archivo incluye:

• La descripción oficial y los principales casos de uso.
• Guía sobre cuándo usar este skill frente a otros del mismo repositorio.

Úsalo para confirmar que el skill se ajusta a tu escenario (inventario y consulta de recursos en Azure).

3. Configura el acceso a Azure para tu agente

Configura el entorno en el que se ejecuta tu agente para que pueda consultar Azure Resource Graph. Los patrones más habituales incluyen:

• Inicio de sesión interactivo con Azure CLI para pruebas locales:

  az login
  

• Service principal para automatización no interactiva:

  az login --service-principal -u <APP_ID> -p <PASSWORD_OR_CERT> --tenant <TENANT_ID>
  

• Managed identity cuando se ejecuta en servicios alojados en Azure que la soportan.

El skill aprovecha los metadatos de los recursos, por lo que normalmente requiere permisos de Reader o similares de solo lectura en las suscripciones sobre las que se realizan consultas.

4. Conecta el skill a tu agente

La mayoría de plataformas de agentes que soportan este repositorio expondrán el skill automáticamente una vez instalado. En las interfaces de configuración o en manifiestos JSON, asegúrate de que:

• azure-resource-lookup aparece entre los skills habilitados.
• El skill tiene acceso a las mismas credenciales de Azure configuradas en el paso anterior.

Consulta la documentación de tu framework de agente para completar cualquier configuración adicional entre skills y herramientas.

Consultar recursos de Azure con el skill

Prompts habituales en lenguaje natural

Una vez conectado, puedes interactuar con azure-resource-lookup usando prompts en lenguaje natural. Algunos ejemplos alineados con la intención de SKILL.md son:

• Listados de recursos

  • "List virtual machines in my production subscription."
  • "Show storage accounts in resource group rg-app-prod."
  • "List container apps in region westeurope."

• Búsquedas basadas en etiquetas

  • "Find resources tagged env=prod in all subscriptions."
  • "Which resources are missing the owner tag in subscription X?"

• Recursos huérfanos

  • "List unattached managed disks in all subscriptions."
  • "Show idle IP addresses that are not associated with any resource."

• Inventario y recuentos

  • "Count all resources by type across all subscriptions."
  • "How many storage accounts are in each region?"

• Consultas basadas en estado

  • "Show virtual machines that are stopped."
  • "List resources in a failed provisioning state."

El skill traduce estas peticiones en consultas de Azure Resource Graph y devuelve resultados estructurados, adecuados para informes o análisis posteriores.

Uso de patrones de consulta de Azure Resource Graph

Para escenarios más avanzados, revisa el archivo de referencia references/azure-resource-graph.md en el repositorio. En él se documentan:

• El formato estándar del comando az graph query:

  az graph query -q "<KQL>" --query "data[].{col1:field1, col2:field2}" -o table
  

• Tablas clave como Resources, ResourceContainers, HealthResources y otras.
• Conceptos básicos de KQL para Resource Graph, como =~ (comparación no sensible a mayúsculas/minúsculas), mv-expand, isempty() y tostring().
• Patrones prácticos de inventario como:
  • Conteo de recursos por tipo.
  • Agrupación de recursos por ubicación.

Aunque no ejecutes az graph query manualmente, estos patrones te ayudan a entender qué hace el skill internamente y cómo interpretar sus resultados.

Integración en flujos de trabajo e informes

Como azure-resource-lookup se centra en inventario y descubrimiento de solo lectura, encaja de forma natural en:

• Dashboards operativos: alimenta herramientas de reporting con los resultados para obtener vistas diarias de recuentos y cobertura de recursos.
• Controles de gobierno y cumplimiento: analiza periódicamente etiquetas faltantes o configuraciones no permitidas.
• Campañas de limpieza: identifica discos huérfanos, NICs sin uso o IPs inactivas antes de ejecutar flujos de eliminación con otras herramientas.
• Revisiones de despliegues y entornos: verifica qué recursos existen en cada entorno después de los despliegues.

Utiliza este skill como capa de información dentro de flujos de trabajo más amplios: te dice qué existe y en qué estado, mientras que otras herramientas se encargan de aplicar cambios cuando corresponde.

Preguntas frecuentes (FAQ)

¿En qué se basa realmente azure-resource-lookup internamente?

azure-resource-lookup está diseñado para trabajar con Azure Resource Graph, el servicio indexado de metadatos de Azure para recursos ARM. Lanza consultas de estilo ARG para buscar y filtrar rápidamente recursos a través de suscripciones y grupos de recursos, y luego devuelve esos resultados a través de tu agente.

¿Puedo usar azure-resource-lookup para crear o eliminar recursos de Azure?

No. azure-resource-lookup es un skill de descubrimiento y reporting de solo lectura. No está pensado para desplegar, cambiar ni eliminar recursos de Azure. Para esas tareas, combínalo con herramientas de despliegue como plantillas ARM/Bicep, Terraform u otros skills de automatización.

¿Este skill es compatible con nubes que no sean Azure?

No. azure-resource-lookup es específico de los recursos de Azure Resource Manager expuestos a través de Azure Resource Graph. No consulta AWS, GCP ni entornos on-premises.

¿Es adecuado azure-resource-lookup para análisis o optimización de costes?

No directamente. Aunque puedes usarlo para inventariar recursos (lo que a menudo es un insumo para el trabajo de costes), el skill no está diseñado para la optimización de costes. No ofrece cálculos de coste, estimaciones de precio ni recomendaciones de rightsizing.

¿Qué permisos se requieren para usar este skill?

Necesitas al menos acceso de lectura (por ejemplo, el rol Reader) a las suscripciones y grupos de recursos que quieras consultar. Como azure-resource-lookup es de solo lectura y utiliza Resource Graph, normalmente no son necesarios permisos elevados más allá de lectura.

¿En qué se diferencia azure-resource-lookup de la búsqueda de recursos en Azure Portal?

Azure Portal ofrece búsqueda y filtrado interactivos. azure-resource-lookup, en cambio, proporciona:

• Consultas scriptables y repetibles en muchas suscripciones.
• Salida estructurada que agentes y flujos de trabajo pueden consumir automáticamente.
• Puntos de entrada en lenguaje natural, para que no tengas que escribir KQL a mano para cada pregunta.

Es especialmente útil cuando necesitas inventario y descubrimiento consistentes y automatizados, en lugar de búsquedas manuales puntuales.

¿Dónde puedo ver más ejemplos de consultas?

Dentro del directorio azure-resource-lookup en el repositorio microsoft/azure-skills, abre:

• SKILL.md para un resumen de comportamiento y notas de uso.
• references/azure-resource-graph.md para patrones concretos de consultas de Azure Resource Graph y consejos de KQL.

Utiliza estos ejemplos como referencia para entender y ampliar el tipo de preguntas que planteas a través del skill.

¿Cuándo debería elegir otro skill en su lugar?

Plantéate usar otro skill adicional o alternativo cuando necesites:

• Cambiar infraestructura (crear, actualizar, eliminar o escalar recursos).
• Gestionar cargas de trabajo dentro de los recursos (por ejemplo, despliegue de aplicaciones, esquemas de bases de datos u objetos de Kubernetes).
• Realizar análisis detallados de costes, rendimiento o seguridad más allá de reporting a nivel de metadatos.

En esos casos, utiliza azure-resource-lookup para descubrimiento e inventario, y luego da paso a herramientas especializadas de despliegue, monitorización o seguridad para los siguientes pasos.