1. Packages
  2. Proxmox Virtual Environment (Proxmox VE)
  3. API Docs
  4. Cluster
  5. getNodes
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v7.13.0
published on Tuesday, Feb 10, 2026 by Daniel Muehlbachler-Pietrzykowski
proxmoxve logo
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v7.13.0
published on Tuesday, Feb 10, 2026 by Daniel Muehlbachler-Pietrzykowski

    Retrieves information about all available Proxmox VE nodes.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as proxmoxve from "@muhlba91/pulumi-proxmoxve";
    
    const example = proxmoxve.Cluster.getNodes({});
    export const dataProxmoxVirtualEnvironmentNodes = {
        names: example.then(example => example.names),
        cpuCount: example.then(example => example.cpuCounts),
        online: example.then(example => example.onlines),
    };
    
    import pulumi
    import pulumi_proxmoxve as proxmoxve
    
    example = proxmoxve.Cluster.get_nodes()
    pulumi.export("dataProxmoxVirtualEnvironmentNodes", {
        "names": example.names,
        "cpuCount": example.cpu_counts,
        "online": example.onlines,
    })
    
    package main
    
    import (
    	"github.com/muhlba91/pulumi-proxmoxve/sdk/v7/go/proxmoxve/cluster"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
    example, err := cluster.GetNodes(ctx, map[string]interface{}{
    }, nil);
    if err != nil {
    return err
    }
    ctx.Export("dataProxmoxVirtualEnvironmentNodes", interface{}Map{
    "names": example.Names,
    "cpuCount": example.CpuCounts,
    "online": example.Onlines,
    })
    return nil
    })
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using ProxmoxVE = Pulumi.ProxmoxVE;
    
    return await Deployment.RunAsync(() => 
    {
        var example = ProxmoxVE.Cluster.GetNodes.Invoke();
    
        return new Dictionary<string, object?>
        {
            ["dataProxmoxVirtualEnvironmentNodes"] = 
            {
                { "names", example.Apply(getNodesResult => getNodesResult.Names) },
                { "cpuCount", example.Apply(getNodesResult => getNodesResult.CpuCounts) },
                { "online", example.Apply(getNodesResult => getNodesResult.Onlines) },
            },
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.proxmoxve.Cluster.ClusterFunctions;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var example = ClusterFunctions.getNodes(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference);
    
            ctx.export("dataProxmoxVirtualEnvironmentNodes", Map.ofEntries(
                Map.entry("names", example.names()),
                Map.entry("cpuCount", example.cpuCounts()),
                Map.entry("online", example.onlines())
            ));
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: proxmoxve:Cluster:getNodes
          arguments: {}
    outputs:
      dataProxmoxVirtualEnvironmentNodes:
        names: ${example.names}
        cpuCount: ${example.cpuCounts}
        online: ${example.onlines}
    

    Using getNodes

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getNodes(opts?: InvokeOptions): Promise<GetNodesResult>
    function getNodesOutput(opts?: InvokeOptions): Output<GetNodesResult>
    def get_nodes(opts: Optional[InvokeOptions] = None) -> GetNodesResult
    def get_nodes_output(opts: Optional[InvokeOptions] = None) -> Output[GetNodesResult]
    func GetNodes(ctx *Context, opts ...InvokeOption) (*GetNodesResult, error)
    func GetNodesOutput(ctx *Context, opts ...InvokeOption) GetNodesResultOutput

    > Note: This function is named GetNodes in the Go SDK.

    public static class GetNodes 
    {
        public static Task<GetNodesResult> InvokeAsync(InvokeOptions? opts = null)
        public static Output<GetNodesResult> Invoke(InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetNodesResult> getNodes(InvokeOptions options)
    public static Output<GetNodesResult> getNodes(InvokeOptions options)
    
    fn::invoke:
      function: proxmoxve:Cluster/getNodes:getNodes
      arguments:
        # arguments dictionary

    getNodes Result

    The following output properties are available:

    CpuCounts List<int>
    The total number of logical CPUs on each node
    CpuUtilizations List<double>
    The CPU utilization on each node
    Id string
    The provider-assigned unique ID for this managed resource.
    MemoryAvailables List<int>
    The available memory in bytes on each node
    MemoryUseds List<int>
    The used memory in bytes on each node
    Names List<string>
    The node names
    Onlines List<bool>
    Whether a node is online
    SslFingerprints List<string>
    The SSL fingerprint for each node
    SupportLevels List<string>
    The support level for each node
    Uptimes List<int>
    The uptime in seconds for each node
    CpuCounts []int
    The total number of logical CPUs on each node
    CpuUtilizations []float64
    The CPU utilization on each node
    Id string
    The provider-assigned unique ID for this managed resource.
    MemoryAvailables []int
    The available memory in bytes on each node
    MemoryUseds []int
    The used memory in bytes on each node
    Names []string
    The node names
    Onlines []bool
    Whether a node is online
    SslFingerprints []string
    The SSL fingerprint for each node
    SupportLevels []string
    The support level for each node
    Uptimes []int
    The uptime in seconds for each node
    cpuCounts List<Integer>
    The total number of logical CPUs on each node
    cpuUtilizations List<Double>
    The CPU utilization on each node
    id String
    The provider-assigned unique ID for this managed resource.
    memoryAvailables List<Integer>
    The available memory in bytes on each node
    memoryUseds List<Integer>
    The used memory in bytes on each node
    names List<String>
    The node names
    onlines List<Boolean>
    Whether a node is online
    sslFingerprints List<String>
    The SSL fingerprint for each node
    supportLevels List<String>
    The support level for each node
    uptimes List<Integer>
    The uptime in seconds for each node
    cpuCounts number[]
    The total number of logical CPUs on each node
    cpuUtilizations number[]
    The CPU utilization on each node
    id string
    The provider-assigned unique ID for this managed resource.
    memoryAvailables number[]
    The available memory in bytes on each node
    memoryUseds number[]
    The used memory in bytes on each node
    names string[]
    The node names
    onlines boolean[]
    Whether a node is online
    sslFingerprints string[]
    The SSL fingerprint for each node
    supportLevels string[]
    The support level for each node
    uptimes number[]
    The uptime in seconds for each node
    cpu_counts Sequence[int]
    The total number of logical CPUs on each node
    cpu_utilizations Sequence[float]
    The CPU utilization on each node
    id str
    The provider-assigned unique ID for this managed resource.
    memory_availables Sequence[int]
    The available memory in bytes on each node
    memory_useds Sequence[int]
    The used memory in bytes on each node
    names Sequence[str]
    The node names
    onlines Sequence[bool]
    Whether a node is online
    ssl_fingerprints Sequence[str]
    The SSL fingerprint for each node
    support_levels Sequence[str]
    The support level for each node
    uptimes Sequence[int]
    The uptime in seconds for each node
    cpuCounts List<Number>
    The total number of logical CPUs on each node
    cpuUtilizations List<Number>
    The CPU utilization on each node
    id String
    The provider-assigned unique ID for this managed resource.
    memoryAvailables List<Number>
    The available memory in bytes on each node
    memoryUseds List<Number>
    The used memory in bytes on each node
    names List<String>
    The node names
    onlines List<Boolean>
    Whether a node is online
    sslFingerprints List<String>
    The SSL fingerprint for each node
    supportLevels List<String>
    The support level for each node
    uptimes List<Number>
    The uptime in seconds for each node

    Package Details

    Repository
    proxmoxve muhlba91/pulumi-proxmoxve
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the proxmox Terraform Provider.
    proxmoxve logo
    Viewing docs for Proxmox Virtual Environment (Proxmox VE) v7.13.0
    published on Tuesday, Feb 10, 2026 by Daniel Muehlbachler-Pietrzykowski
      Try Pulumi Cloud free. Your team will thank you.