Recuperar contenido del espacio

Los comandos space get descargan todas las páginas de un espacio de Confluence a un directorio local en su formato nativo. Funcionan como space convert, pero sin convertir a Markdown: las páginas se guardan como ADF JSON en bruto o Storage HTML.

Usa esto cuando el flujo objetivo sea análisis técnico, investigación de migración, preservación nativa o procesamiento posterior personalizado, y no una salida inmediata en Markdown.

Obtener por clave


acs2md space get by-key SPACE_KEY [flags]

Aliases: key, k

Ejemplos


# Descarga todas las páginas en formato ADF JSON (predeterminado)
acs2md space get by-key DOCS
 
# Descarga páginas en formato Storage HTML
acs2md space get by-key DOCS --format storage
 
# Especifica un directorio de salida personalizado
acs2md space get by-key DOCS --output-dir ./my-export/
 
# Descarga solo páginas archivadas
acs2md space get by-key DOCS --status archived
 
# Vuelve a descargar solo páginas cambiadas y elimina archivos locales de páginas retiradas
acs2md space get by-key DOCS --output-dir ./native-export --sync
 
# Vuelve a descargar solo páginas cambiadas pero conserva localmente las retiradas
acs2md space get by-key DOCS --output-dir ./native-archive --incremental

Flags

Flag	Short	Predeterminado	Descripcion
`--output-dir`	`-o`	`./output/<space-key>/`	Directorio de salida
`--format`	`-f`	`atlas_doc_format`	Formato nativo: `atlas_doc_format` o `storage`
`--status`	`-s`	`current`	Filtro por estado de página
`--conflict-resolution`	`-`	`overwrite`	Estrategia de conflictos a nivel de espacio
`--sync`	`-`	`false`	Hace seguimiento con `.get-sync-state.json`, vuelve a descargar solo páginas cambiadas y elimina archivos locales de páginas retiradas. Mutuamente excluyente con `--incremental`.
`--incremental`	`-`	`true`	Hace seguimiento con `.get-sync-state.json`, vuelve a descargar solo páginas cambiadas y conserva archivos locales de páginas retiradas. Mutuamente excluyente con `--sync`.

Obtener por ID


acs2md space get by-id SPACE_ID [flags]

Descarga todas las páginas de un espacio usando el ID numerico del espacio.

Aliases: id

Los flags y el comportamiento son equivalentes a space get by-key.


acs2md space get by-id 123456 --format storage --output-dir ./export/

Seguimiento del progreso

Las descargas nativas largas muestran una barra de progreso en tiempo real por stderr. Eso mantiene stdout limpio para redirecciones mientras sigue dando visibilidad al operador sobre la página actual y el avance global.

space get muestra el progreso de descarga de páginas
--resolve-users en space list sigue mostrando aparte el progreso de resolución de usuarios
usa el flag global --no-progress cuando necesites un log limpio en CI o una captura para demo

La salida de progreso va por stderr, por lo que los archivos redirigidos o el stdout canalizado no quedan contaminados por la barra de progreso.

Estructura de salida

Las páginas se guardan en un árbol de directorios que replica la jerarquia del espacio:


output/DOCS/
  getting-started.json
  api-reference.json
  guides/
    quickstart.json
    advanced-usage.json

Al usar --format storage, los archivos se guardan con extension .html en lugar de .json.

Si el seguimiento de sincronización esta activo, el directorio de salida también incluye .get-sync-state.json junto al contenido descargado.

Modo sync e incremental

space get es compatible con la misma forma de trabajo solo-de-cambios que space convert, pero registra las descargas nativas con .get-sync-state.json en lugar de .convert-sync-state.json.

--sync vuelve a descargar páginas cambiadas y elimina archivos locales cuando la página origen desaparece de Confluence
--incremental vuelve a descargar páginas cambiadas pero conserva archivos locales cuando la página origen desaparece de Confluence

Esto hace que space get sirva tanto para espejos estrictos de continuidad como para flujos orientados a preservacion nativa en archivo.

Cuando usar `space get` en lugar de `space convert`

usa space get cuando necesites cargas nativas de Confluence
usa space convert cuando necesites Markdown portable
usa ambos cuando un flujo de migración o troubleshooting necesite primero inspección nativa y despues salida en Markdown

Ejemplos practicos

Preservacion nativa para ingenieria de migración


acs2md space get by-key DOCS --format atlas_doc_format --output-dir ./native-docs

Archivo nativo repetible con refresco solo de cambios


acs2md space get by-key DOCS --format storage --output-dir ./native-archive --incremental