Permisos del espacio

Los comandos space permissions listan los permisos de acceso configurados para un espacio de Confluence. Cada entrada de permiso describe a que principal, ya sea usuario, grupo o rol, se le concede una operacion concreta como leer, crear, eliminar o administrar.

Estos comandos son especialmente útiles cuando una exportación masiva o una migración debe entenderse en el contexto de ownership, acceso y gobernanza.

Permisos por clave


acs2md space permissions by-key SPACE_KEY [flags]

Ejemplos


# Lista todos los permisos de un espacio
acs2md space permissions by-key DOCS
 
# Salida JSON
acs2md space permissions by-key DOCS --format json
 
# Resuelve IDs de cuenta a nombres visibles
acs2md space permissions by-key DOCS --resolve-users
 
# Guarda en un archivo
acs2md space permissions by-key DOCS --format yaml --output perms.yaml
 
# Limita resultados
acs2md space permissions by-key DOCS --limit 50

Aliases

by-key también puede invocarse como key o k.

Flags

Flag	Short	Predeterminado	Descripcion
`--format`	`-f`	`table`	Formato de salida: `table`, `json`, `yaml`, `csv`, `tsv`
`--output`	`-o`	(stdout)	Ruta del archivo de salida
`--limit`	`-l`	`0`	Numero máximo de permisos a devolver (`0` = todos)
`--resolve-users`		`false`	Resuelve IDs de cuenta a nombres visibles (hace llamadas adicionales a la API)

Cuando --resolve-users esta activo, aparece una barra de progreso en stderr mientras se resuelven nombres de usuario. La salida en tabla incluye una columna “Principal” (nombre visible) y una columna “Principal ID”.

En v1.0.0, acs2md space permissions auto-página hasta alcanzar --limit o agotar el conjunto de resultados. El CLI actual no expone un flag --cursor.

Permisos por ID


acs2md space permissions by-id SPACE_ID [flags]

Lista permisos de un espacio usando su ID numerico en lugar de su clave. Usa los mismos flags que by-key.


acs2md space permissions by-id 65539 --resolve-users --format json

Aliases del comando

El comando permissions también puede invocarse como perms o perm.


# Estos son equivalentes
acs2md space permissions by-key DOCS
acs2md space perms by-key DOCS
acs2md space perm by-key DOCS

Modelo de permisos

Cada entrada de permiso incluye:

Campo	Descripcion
Principal	El usuario, grupo o rol al que se concede el permiso
Principal type	`user`, `group` o `role`
Operation	La accion permitida: `read`, `create`, `delete` o `administer`

Casos de uso

Compliance y auditoria — genera un informe de quien tiene acceso a espacios sensibles.
Gobernanza — verifica que los permisos del espacio sigan las politicas de acceso de tu organizacion.
Planificacion de migración — captura las estructuras de permisos antes de migrar contenido a otra plataforma.
Revision con negocio — usa --resolve-users cuando el informe vaya a revisarse con responsables no tecnicos, asumiendo el coste adicional de llamadas a la API.


# Exporta permisos de todos los espacios en un script
for key in $(acs2md space list --format json | jq -r '.results[].key'); do
  acs2md space perms by-key "$key" \
    --resolve-users \
    --format json \
    --output "permissions/${key}.json"
done

Si necesitas ver este tipo de salida dentro de un flujo más amplio de auditoría o exportación, consulta Flujos y comandos.