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 Storage HTML o ADF JSON.

Por defecto, el resultado es una copia de seguridad restaurable: junto a los cuerpos de página, space get guarda los adjuntos de cada página y un manifiesto del árbol de páginas y carpetas, las versiones, las etiquetas y las propiedades de contenido. space check la compara con el espacio en vivo y space restore la devuelve a Confluence.

Usa esto para copia de seguridad y recuperación ante desastres, análisis técnico, investigación de migración, preservación nativa o procesamiento posterior personalizado, y no para una salida inmediata en Markdown.

Obtener por clave


acs2md space get by-key SPACE_KEY [flags]

Aliases: key, k

Ejemplos


# Una copia de seguridad restaurable: cuerpos storage, adjuntos, etiquetas, propiedades, manifiesto
acs2md space get by-key DOCS --output-dir ./backups/
 
# ADF JSON para un pipeline de procesamiento
acs2md space get by-key DOCS --format atlas_doc_format
 
# Solo los cuerpos de página, la ejecución más rápida
acs2md space get by-key DOCS --include-attachments=false \
  --include-labels=false --include-properties=false
 
# 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	Descripción
`--output-dir`	—	`./output`	Directorio base de salida; siempre se añade `<space-key>/`
`--format`	`-f`	`storage`	Formato del cuerpo: `storage` o `atlas_doc_format`
`--status`	`-s`	`current`	Estado de página: `all`, `current`, `archived`, `trashed`, `deleted`, `draft`
`--conflict-resolution`	—	`overwrite`	Conflictos de nombre de archivo: `suffix`, `overwrite`, `skip`, `versioned`
`--sync`	—	`false`	Vuelve a descargar páginas cambiadas; elimina archivos retirados en origen. Mutuamente excluyente con `--incremental`.
`--incremental`	—	`true`	Vuelve a descargar páginas cambiadas; conserva archivos retirados en origen. Mutuamente excluyente con `--sync`.
`--manifest`	—	`true`	Escribe `.backup-manifest.json` (necesario para restaurar)
`--include-attachments`	—	`true`	Descarga los adjuntos de las páginas (llamadas API adicionales)
`--include-labels`	—	`true`	Registra las etiquetas de página (una llamada API por página)
`--include-properties`	—	`true`	Registra las propiedades de contenido (una llamada API por página)

El formato por defecto cambió a storage en v1.0.12 (antes era atlas_doc_format). Storage hace referencia a adjuntos y páginas por nombre, algo que sobrevive a una restauración que les asigna nuevos ID. Pasa --format atlas_doc_format para el comportamiento anterior. Un directorio que ya contiene una copia de seguridad conserva su formato salvo que pases --format, de modo que una copia de seguridad programada nunca mezcla archivos .html y .json.

Obtener por ID


acs2md space get by-id SPACE_ID [flags]

Descarga todas las páginas de un espacio usando el ID numérico 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 jerarquía del espacio:


backups/DOCS/                              # siempre se añade la clave del espacio
  .backup-manifest.json                    # árbol de páginas y carpetas, versiones, etiquetas, propiedades, adjuntos
  .get-sync-state.json                     # seguimiento de versiones para --sync / --incremental
  getting-started.html
  guides.html
  guides/
    quickstart.html
    advanced-usage.html
  attachments/
    3134096561/                            # un directorio por ID de página
      runbook.pdf

Con --format atlas_doc_format, los archivos de página tienen extensión .json en lugar de .html.

Copias de seguridad restaurables

Por defecto, space get escribe todo lo que necesita una restauración, no solo los cuerpos de página.

El manifiesto (.backup-manifest.json) registra, para cada página: su ID, título, estado, padre y posición entre sus hermanas, la versión que contiene la copia de seguridad y un SHA-256 de su archivo de cuerpo. También registra el nombre, el tipo, la descripción y la página de inicio del espacio, y cada carpeta de Confluence bajo la que están las páginas, de modo que el árbol de páginas puede reconstruirse aunque las carpetas no tengan archivo propio. Las rutas del manifiesto son relativas, así que la copia de seguridad puede moverse o copiarse a otra máquina. Conserva el manifiesto junto a los archivos.

Las etiquetas y las propiedades de contenido se registran en el manifiesto, con una llamada API por página para cada una. Desactívalas con --include-labels=false y --include-properties=false.

Los adjuntos se guardan en attachments/<page-id>/, y el manifiesto registra de cada uno su título en Confluence, ID de archivo, tipo de medio, versión, tamaño y SHA-256. Un título con caracteres que ningún sistema de archivos acepta se guarda con un nombre seguro; el manifiesto conserva el título original. Un adjunto que no se puede descargar se notifica y se registra sin archivo, para que nada falte en silencio. Los adjuntos sin cambios no se vuelven a descargar en la siguiente ejecución. Desactívalos con --include-attachments=false.

Qué formato. storage (el predeterminado) es la opción segura para restaurar: hace referencia a adjuntos y a otras páginas por nombre, así que las referencias sobreviven a una restauración que les asigna nuevos ID. atlas_doc_format no pierde información y es más fácil de procesar, pero hace referencia a los adjuntos por ID de archivo; space restore reescribe esas referencias cuando vuelve a subir los archivos.

Lo que una copia de seguridad no puede contener. Los ID de páginas y adjuntos, los autores, las fechas de creación y el historial de versiones pertenecen a Confluence. Una restauración recupera el contenido y el árbol, pero no esos datos. Las páginas que están bajo una carpeta se escriben en el nivel superior del directorio del espacio, porque solo las páginas tienen archivos; el manifiesto conserva su posición real en el árbol.

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; también retira esas páginas y sus adjuntos del manifiesto
--incremental vuelve a descargar páginas cambiadas pero conserva archivos locales cuando la página origen desaparece de Confluence

Una página cuya versión no ha cambiado se omite, y también sus adjuntos: un adjunto añadido sin una nueva versión de página se recoge la próxima vez que la página cambie. Ejecuta con --incremental=false para una actualización completa. Una página que falta en el manifiesto siempre se vuelve a descargar, así que la primera ejecución de v1.0.12 sobre una copia de seguridad tomada con una versión anterior descarga cada página una vez para completarla.

Esto hace que space get sirva tanto para espejos estrictos de continuidad como para flujos orientados a preservación 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 después salida en Markdown

Ejemplos prácticos

Copia de seguridad restaurable cada noche


acs2md space get by-key DOCS --output-dir /backups
acs2md space check by-key DOCS --backup-dir /backups --fail-on-drift

Preservación 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