Skip to content

Data Source: proxmox_ceph_status

Warning

Experimental. Schema and behavior may change in future releases. Pin the provider version if stability matters.

Retrieves Ceph status from Proxmox. Queries the per-node endpoint when node_name is set, otherwise the cluster-wide endpoint.

When node_name is set, the data source queries /nodes/{node}/ceph/status (the node-local view). When node_name is omitted, it queries /cluster/ceph/status (the cluster-wide view). Both endpoints return the same payload shape; only the failure modes differ when Ceph is misconfigured on a specific node.

Example Usage

// Cluster-wide Ceph status (hits GET /cluster/ceph/status).
data "proxmox_ceph_status" "cluster" {}

// Node-scoped Ceph status (hits GET /nodes/{node}/ceph/status).
data "proxmox_ceph_status" "node" {
  node_name = "pve"
}

output "ceph_health" {
  value = data.proxmox_ceph_status.cluster.health_status
}

output "ceph_fsid" {
  value = data.proxmox_ceph_status.cluster.fsid
}

output "ceph_quorum" {
  value = data.proxmox_ceph_status.cluster.quorum_names
}

Schema

Optional

  • node_name (String) Optional node name. When set, the data source queries the per-node endpoint; when omitted, it queries the cluster-wide endpoint.

Read-Only

  • fsid (String) Ceph cluster UUID.
  • health_status (String) Overall cluster health: HEALTH_OK, HEALTH_WARN, or HEALTH_ERR.
  • id (String) The Ceph cluster fsid.
  • quorum_names (List of String) Monitor names currently participating in the quorum.