Ver el almacenamiento de un nodo Proxmox con pvesh

Antes de asignar un disco a una máquina virtual (VM) o almacenamiento a un contenedor, confirma que el nodo de destino ve el almacén y que admite ese tipo de contenido. En Proxmox Virtual Environment (Proxmox VE), pvesh muestra la vista del nodo y pvesm status resume el estado y la capacidad.

Consultar los almacenes visibles para el nodo

pvesh permite consultar la interfaz de programación de aplicaciones (API) local desde el shell. Ejecuta estos ejemplos en el nodo Proxmox como root; los comandos solo leen información:

hostname
pvesh get /nodes
pvesh get /nodes/NOMBRE/storage

Sustituye NOMBRE por el nombre exacto del nodo que aparece en la lista de pvesh get /nodes. La salida incluye una fila por almacén. Revisa estos campos:

• storage: identificador configurado del almacén.
• type: tipo de almacenamiento, como dir, lvmthin, zfspool o nfs.
• active: indica si Proxmox puede utilizarlo en ese momento.
• content: tipos de contenido permitidos, como discos de VM, sistemas de archivos de contenedor o copias de seguridad.
• avail y total: espacio disponible y capacidad total, cuando el backend los proporciona.

Consultar un almacén concreto del nodo

Para revisar un solo almacén, añade su identificador a la ruta:

pvesh get /nodes/NOMBRE/storage/local

Cambia local por el nombre real de la primera consulta. Si ese almacén no está configurado para el nodo, la API devolverá un error en lugar de datos de capacidad.

Resumir estado y capacidad con pvesm status

pvesm status muestra el estado de los almacenes configurados. La salida suele incluir una fila por almacén y columnas como Name, Type, Status, Total, Used y Available. El estado y el espacio ayudan a identificar almacenes inactivos o con poco margen:

pvesm status

También puedes filtrar por un tipo de contenido o por un almacén:

pvesm status --content images
pvesm status --content rootdir
pvesm status --storage local

--content solo muestra almacenes que admiten ese tipo: images corresponde a discos de VM y rootdir a sistemas de archivos de contenedor. No enumera las VM, los contenedores ni los volúmenes guardados; para listar los volúmenes de un almacén, usa pvesm list local y sustituye local por su identificador.

Qué comprobar antes de asignar almacenamiento

Confirma que el almacén esté activo y que content incluya el tipo de recurso que necesitas. Puede tener espacio libre y aun así no aceptar discos de VM, sistemas de archivos de contenedor o copias de seguridad si ese contenido no está habilitado.

pvesh y pvesm status son consultas en estos ejemplos: no crean discos ni modifican almacenes, ni mueven máquinas ni reparan un backend. Si un almacén aparece inactivo, revisa primero su configuración y el backend correspondiente. Para cambiar la configuración hace falta otra operación; valora su impacto en las máquinas existentes antes de ejecutarla.