Listar espacios


acs2md space list [flags]

Lista todos los espacios de Confluence a los que tu cuenta tiene acceso. Usalo para descubrir claves de espacio antes de ejecutar una conversion.

Para la mayoria de operadores nuevos, este es el primer comando real de descubrimiento despues de doctor.

Ejemplos


# Lista todos los espacios en una tabla (predeterminado)
acs2md space list
 
# Salida en YAML
acs2md space list --format yaml
 
# Filtra solo espacios globales
acs2md space list --type global
 
# Salida JSON
acs2md space list --format json
 
# Guarda en un archivo
acs2md space list --format json --output spaces.json
 
# Limita resultados
acs2md space list --limit 20
 
# Muestra nombres de autor en lugar de IDs de cuenta
acs2md space list --resolve-users

Flags

Flag	Short	Predeterminado	Descripcion
`--format`	`-f`	`table`	Formato de salida: `table`, `json`, `yaml`, `csv`, `tsv`
`--output`	`-o`	(stdout)	Ruta del archivo de salida
`--type`	`-t`	(all)	Filtra por tipo de espacio: `global`, `personal`
`--status`	`-s`	(all)	Filtra por estado del espacio: `current`, `archived`
`--limit`	`-l`	`25`	Numero total de espacios a devolver (`0` = todos)
`--resolve-users`		`false`	Resuelve IDs de cuenta a nombres visibles (hace llamadas adicionales a la API)

acs2md space list auto-página en v1.0.0. El CLI actual no expone un flag --cursor. Cuando --resolve-users esta activo, aparece una barra de progreso en stderr mientras se resuelven nombres de usuario.

Ejemplo de salida (tabla)


ID       KEY       NAME                  TYPE      STATUS
─────────────────────────────────────────────────────────
100001   TEAMDOCS  Team Documentation    global    current
100002   ENG       Engineering           global    current
100003   ARCHIVE   Archive               global    archived
100004   ~alice    Alice Example         personal  current
100005   KB        Knowledge Base        global    current

El ejemplo se basa en una respuesta real del tenant, con nombres e identificadores anonimizados.

Ejemplo de salida (JSON)


{
  "_links": {
    "self": "",
    "next": ""
  },
  "results": [
    {
      "id": "100001",
      "key": "TEAMDOCS",
      "name": "Team Documentation",
      "type": "global",
      "status": "current",
      "homepageId": "100101",
      "createdAt": "2024-01-15T09:00:00.000Z",
      "authorId": "<redacted>"
    }
  ]
}

Paginacion automatica

Cuando hay mas resultados que --limit, acs2md space list sigue recuperando páginas de la API de Confluence hasta alcanzar el total solicitado o agotar el conjunto de resultados. Eso permite usar el comando directamente en scripts, sin bucles manuales con cursor.


# Devuelve todos los espacios globales actuales accesibles en un unico documento JSON
acs2md space list --type global --status current --limit 0 --format json

Usa salida JSON cuando necesites entregar los resultados a automatizacion, reporting o un proceso de revision con stakeholders.

Para un flujo completo de continuidad, migración o gobernanza basado en estos listados, consulta Flujos y comandos.