Buscar en el tenant en vivo

ajat search consulta el tenant de Jira configurado a través de la API de Automation y devuelve los resúmenes de reglas que coinciden. Úsalo cuando quieras una respuesta fresca — «¿qué reglas están actualmente DISABLED?» — sin ejecutar primero un ajat export completo.

Es un comando deliberadamente ligero. Devuelve solo el UUID, el nombre y el scope de cada regla coincidente. La comparación más rica que necesitan las operaciones en bloque vive en el catálogo de exportación local y está disponible mediante la familia de comandos ajat rule.

ajat funciona únicamente con Atlassian Jira Cloud Automation. No admite Jira Server ni Jira Data Center. ajat search llama al tenant de Jira Cloud en vivo, por lo que requiere credenciales válidas y una configuración funcional — ejecuta ajat doctor primero si tienes dudas.

Uso


ajat search [--trigger <type>] [--state ENABLED|DISABLED] \
            [--author <accountId>] [--scope <ari>]... \
            [--limit <n>] [--page-size <n>] \
            [--format table|json]

Todos los filtros son opcionales y se combinan con AND del lado del servidor. Sin filtros, se listan todas las reglas del tenant.

Flags

Flag	Predeterminado	Descripción
`--trigger`	(ninguno)	Filtra por el tipo de componente trigger de la regla (p. ej. `jira.issue.created`).
`--state`	(ninguno)	Filtra por estado de la regla: `ENABLED` o `DISABLED`.
`--author`	(ninguno)	Filtra por `actor.accountId`.
`--scope`	`[]`	Filtra por `ruleScopeARI`. Repetible — coincide cualquier regla que lleve cualquiera de los ARI listados.
`--limit`	`0`	Se detiene tras devolver como máximo esta cantidad de coincidencias. `0` significa sin límite.
`--page-size`	`100`	Tamaño de página del cursor para el bucle de la API subyacente (`1`–`100`).
`--format`	`table`	Formato de salida: `table` o `json`.

Ejemplos


# Toda regla ENABLED cuyo trigger sea issue.created
ajat search --state ENABLED --trigger jira.issue.created
 
# Toda regla DISABLED, limitada a las primeras 10 (revisión rápida)
ajat search --state DISABLED --limit 10
 
# Reglas creadas por una cuenta específica, como JSON para scripting
ajat search --author 5b1...:abc --format json
 
# Todas las reglas que lleven cualquiera de dos scope ARIs
ajat search --scope ari:cloud:jira::site/AAA --scope ari:cloud:jira::site/BBB

Formatos de salida

Tabla (predeterminado)

Un encabezado de resumen refleja el filtro activo, seguido de una tabla UUID / Name / Scope:


Search
  state   : ENABLED
  trigger : jira.issue.created
  matches : 17

 UUID                                  Name                      Scope
 ────────────────────────────────────  ────────────────────────  ──────────
 11111111-…                            Auto-triage incoming      global
 ...

JSON

Un único objeto autodescriptivo que contiene el eco del filtro más los resúmenes coincidentes — ideal para canalizar a jq:


ajat search --state DISABLED --format json | jq '.matches | length'


{
  "filter": {
    "state": "DISABLED"
  },
  "matches": [
    {
      "uuid": "11111111-…",
      "name": "Auto-triage incoming",
      "ruleScopeARIs": [],
      "updated": 1772715265.948
    }
  ]
}

Como el JSON se mantiene autodescriptivo, el seguimiento por script es directo:


# Recoge los UUIDs de cada regla creada por una cuenta
ajat search --author 5b1...:abc --format json | jq -r '.matches[].uuid'

Cuándo usar `search` frente a `export` + informes

ajat search llama a la API en vivo y devuelve resúmenes; ajat export escribe una instantánea local completa que consumen los informes y los selectores de ajat rule. Elige cada uno así.

Usa ajat search cuando:

No tengas una exportación reciente en disco y solo necesites inspeccionar, no mutar.
Quieras verificar un cambio reciente sin volver a exportar.
Solo te importe el UUID, el nombre y el scope — el endpoint de resumen no devuelve etiquetas, conteos de condiciones ni esquemas de componentes.

Usa ajat export más informes cuando:

Necesites los cuerpos completos de las reglas — triggers, condiciones, acciones, ramas, etiquetas y destinos de integración.
Quieras análisis sin conexión y compartible (inventory, collision, consistency, risk, workflow) sin dependencia de Jira en vivo.
Te prepares para operaciones en bloque, revisión de deriva, restauración o una auditoría.

Para mutación en bloque — habilitar, deshabilitar, eliminar o actualizar scope — sigue usando los comandos ajat rule sobre una exportación local. Los selectores por etiqueta, patrón de nombre y conteo de componentes no tienen equivalente del lado de la API, así que ajat search no puede impulsarlos.

Códigos de salida

Código	Significado
`0`	Búsqueda completada (incluso con cero coincidencias).
`1`	Fallo de arranque o configuración.
`130`	Interrumpido por `SIGINT` / `SIGTERM`.

Relacionado

ajat export — instantánea completa a disco; lo que consumen los informes y los comandos de reglas en bloque.
ajat rule — mutaciones en bloque seleccionadas del catálogo local.
Informes — cinco informes HTML autocontenidos sobre una instantánea de exportación.
Utilidades — doctor y el resto de la superficie de diagnóstico.