1. Packages
  2. Packages
  3. Proxmox Virtual Environment (Proxmox VE)
  4. API Docs
  5. cluster
  6. OptionsLegacy
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.1.0
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
Schema (JSON)
muhlba91/pulumi-proxmoxve

proxmoxve.cluster.OptionsLegacy

proxmoxve logo
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.1.0
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
Schema (JSON)
muhlba91/pulumi-proxmoxve

    Deprecated: Use proxmoxve.cluster.Options instead. This resource will be removed in v1.0.

    Manages Proxmox VE Cluster Datacenter options.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as proxmoxve from "@muhlba91/pulumi-proxmoxve";

const options = new proxmoxve.cluster.OptionsLegacy("options", {
    language: "en",
    keyboard: "pl",
    emailFrom: "ged@gont.earthsea",
    bandwidthLimitMigration: 555555,
    bandwidthLimitDefault: 666666,
    maxWorkers: 5,
    migrationCidr: "10.0.0.0/8",
    migrationType: "secure",
    nextId: {
        lower: 100,
        upper: 999999999,
    },
    notify: {
        haFencingMode: "never",
        haFencingTarget: "default-matcher",
        packageUpdates: "always",
        packageUpdatesTarget: "default-matcher",
        packageReplication: "always",
        packageReplicationTarget: "default-matcher",
    },
});

    import pulumi
import pulumi_proxmoxve as proxmoxve

options = proxmoxve.cluster.OptionsLegacy("options",
    language="en",
    keyboard="pl",
    email_from="ged@gont.earthsea",
    bandwidth_limit_migration=555555,
    bandwidth_limit_default=666666,
    max_workers=5,
    migration_cidr="10.0.0.0/8",
    migration_type="secure",
    next_id={
        "lower": 100,
        "upper": 999999999,
    },
    notify={
        "ha_fencing_mode": "never",
        "ha_fencing_target": "default-matcher",
        "package_updates": "always",
        "package_updates_target": "default-matcher",
        "package_replication": "always",
        "package_replication_target": "default-matcher",
    })

    package main

import (
	"github.com/muhlba91/pulumi-proxmoxve/sdk/v8/go/proxmoxve/cluster"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cluster.NewOptionsLegacy(ctx, "options", &cluster.OptionsLegacyArgs{
			Language:                pulumi.String("en"),
			Keyboard:                pulumi.String("pl"),
			EmailFrom:               pulumi.String("ged@gont.earthsea"),
			BandwidthLimitMigration: pulumi.Int(555555),
			BandwidthLimitDefault:   pulumi.Int(666666),
			MaxWorkers:              pulumi.Int(5),
			MigrationCidr:           pulumi.String("10.0.0.0/8"),
			MigrationType:           pulumi.String("secure"),
			NextId: &cluster.OptionsLegacyNextIdArgs{
				Lower: pulumi.Int(100),
				Upper: pulumi.Int(999999999),
			},
			Notify: &cluster.OptionsLegacyNotifyArgs{
				HaFencingMode:            pulumi.String("never"),
				HaFencingTarget:          pulumi.String("default-matcher"),
				PackageUpdates:           pulumi.String("always"),
				PackageUpdatesTarget:     pulumi.String("default-matcher"),
				PackageReplication:       "always",
				PackageReplicationTarget: "default-matcher",
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using ProxmoxVE = Pulumi.ProxmoxVE;

return await Deployment.RunAsync(() => 
{
    var options = new ProxmoxVE.Cluster.OptionsLegacy("options", new()
    {
        Language = "en",
        Keyboard = "pl",
        EmailFrom = "ged@gont.earthsea",
        BandwidthLimitMigration = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(555555) (example.pp:4,29-35)),
        BandwidthLimitDefault = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(666666) (example.pp:5,29-35)),
        MaxWorkers = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(5) (example.pp:6,29-30)),
        MigrationCidr = "10.0.0.0/8",
        MigrationType = "secure",
        NextId = new ProxmoxVE.Cluster.Inputs.OptionsLegacyNextIdArgs
        {
            Lower = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(100) (example.pp:10,13-16)),
            Upper = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(9.99999999e+08) (example.pp:11,13-22)),
        },
        Notify = new ProxmoxVE.Cluster.Inputs.OptionsLegacyNotifyArgs
        {
            HaFencingMode = "never",
            HaFencingTarget = "default-matcher",
            PackageUpdates = "always",
            PackageUpdatesTarget = "default-matcher",
            PackageReplication = "always",
            PackageReplicationTarget = "default-matcher",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import io.muehlbachler.pulumi.proxmoxve.cluster.OptionsLegacy;
import io.muehlbachler.pulumi.proxmoxve.cluster.OptionsLegacyArgs;
import com.pulumi.proxmoxve.cluster.inputs.OptionsLegacyNextIdArgs;
import com.pulumi.proxmoxve.cluster.inputs.OptionsLegacyNotifyArgs;
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) {
        var options = new OptionsLegacy("options", OptionsLegacyArgs.builder()
            .language("en")
            .keyboard("pl")
            .emailFrom("ged@gont.earthsea")
            .bandwidthLimitMigration(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(555555) (example.pp:4,29-35)))
            .bandwidthLimitDefault(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(666666) (example.pp:5,29-35)))
            .maxWorkers(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(5) (example.pp:6,29-30)))
            .migrationCidr("10.0.0.0/8")
            .migrationType("secure")
            .nextId(OptionsLegacyNextIdArgs.builder()
                .lower(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(100) (example.pp:10,13-16)))
                .upper(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(9.99999999e+08) (example.pp:11,13-22)))
                .build())
            .notify(OptionsLegacyNotifyArgs.builder()
                .haFencingMode("never")
                .haFencingTarget("default-matcher")
                .packageUpdates("always")
                .packageUpdatesTarget("default-matcher")
                .packageReplication("always")
                .packageReplicationTarget("default-matcher")
                .build())
            .build());

    }
}

    resources:
  options:
    type: proxmoxve:cluster:OptionsLegacy
    properties:
      language: en
      keyboard: pl
      emailFrom: ged@gont.earthsea
      bandwidthLimitMigration: 555555
      bandwidthLimitDefault: 666666
      maxWorkers: 5
      migrationCidr: 10.0.0.0/8
      migrationType: secure
      nextId:
        lower: 100
        upper: 9.99999999e+08
      notify:
        haFencingMode: never
        haFencingTarget: default-matcher
        packageUpdates: always
        packageUpdatesTarget: default-matcher
        packageReplication: always
        packageReplicationTarget: default-matcher

    Create OptionsLegacy Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new OptionsLegacy(name: string, args?: OptionsLegacyArgs, opts?: CustomResourceOptions);
    @overload
def OptionsLegacy(resource_name: str,
                  args: Optional[OptionsLegacyArgs] = None,
                  opts: Optional[ResourceOptions] = None)

@overload
def OptionsLegacy(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  bandwidth_limit_clone: Optional[int] = None,
                  bandwidth_limit_default: Optional[int] = None,
                  bandwidth_limit_migration: Optional[int] = None,
                  bandwidth_limit_move: Optional[int] = None,
                  bandwidth_limit_restore: Optional[int] = None,
                  console: Optional[str] = None,
                  crs_ha: Optional[str] = None,
                  crs_ha_rebalance_on_start: Optional[bool] = None,
                  description: Optional[str] = None,
                  email_from: Optional[str] = None,
                  ha_shutdown_policy: Optional[str] = None,
                  http_proxy: Optional[str] = None,
                  keyboard: Optional[str] = None,
                  language: Optional[str] = None,
                  mac_prefix: Optional[str] = None,
                  max_workers: Optional[int] = None,
                  migration_cidr: Optional[str] = None,
                  migration_type: Optional[str] = None,
                  next_id: Optional[OptionsLegacyNextIdArgs] = None,
                  notify: Optional[OptionsLegacyNotifyArgs] = None)
    func NewOptionsLegacy(ctx *Context, name string, args *OptionsLegacyArgs, opts ...ResourceOption) (*OptionsLegacy, error)
    public OptionsLegacy(string name, OptionsLegacyArgs? args = null, CustomResourceOptions? opts = null)
    public OptionsLegacy(String name, OptionsLegacyArgs args)
public OptionsLegacy(String name, OptionsLegacyArgs args, CustomResourceOptions options)

    type: proxmoxve:cluster:OptionsLegacy
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args OptionsLegacyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args OptionsLegacyArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args OptionsLegacyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args OptionsLegacyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args OptionsLegacyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    OptionsLegacy Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The OptionsLegacy resource accepts the following input properties:

    BandwidthLimitClone int
    Clone I/O bandwidth limit in KiB/s.
    BandwidthLimitDefault int
    Default I/O bandwidth limit in KiB/s.
    BandwidthLimitMigration int
    Migration I/O bandwidth limit in KiB/s.
    BandwidthLimitMove int
    Move I/O bandwidth limit in KiB/s.
    BandwidthLimitRestore int
    Restore I/O bandwidth limit in KiB/s.
    Console string
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    CrsHa string
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    CrsHaRebalanceOnStart bool
    Cluster resource scheduling setting for HA rebalance on start.
    Description string
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    EmailFrom string
    email address to send notification from (default is root@$hostname).
    HaShutdownPolicy string
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    HttpProxy string
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    Keyboard string
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    Language string
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    MacPrefix string
    Prefix for autogenerated MAC addresses.
    MaxWorkers int
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    MigrationCidr string
    Cluster wide migration network CIDR.
    MigrationType string
    Cluster wide migration type. Must be secure | insecure (default is secure).
    NextId Pulumi.ProxmoxVE.Cluster.Inputs.OptionsLegacyNextId
    The ranges for the next free VM ID auto-selection pool.
    Notify Pulumi.ProxmoxVE.Cluster.Inputs.OptionsLegacyNotify
    Cluster-wide notification settings.
    BandwidthLimitClone int
    Clone I/O bandwidth limit in KiB/s.
    BandwidthLimitDefault int
    Default I/O bandwidth limit in KiB/s.
    BandwidthLimitMigration int
    Migration I/O bandwidth limit in KiB/s.
    BandwidthLimitMove int
    Move I/O bandwidth limit in KiB/s.
    BandwidthLimitRestore int
    Restore I/O bandwidth limit in KiB/s.
    Console string
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    CrsHa string
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    CrsHaRebalanceOnStart bool
    Cluster resource scheduling setting for HA rebalance on start.
    Description string
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    EmailFrom string
    email address to send notification from (default is root@$hostname).
    HaShutdownPolicy string
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    HttpProxy string
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    Keyboard string
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    Language string
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    MacPrefix string
    Prefix for autogenerated MAC addresses.
    MaxWorkers int
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    MigrationCidr string
    Cluster wide migration network CIDR.
    MigrationType string
    Cluster wide migration type. Must be secure | insecure (default is secure).
    NextId OptionsLegacyNextIdArgs
    The ranges for the next free VM ID auto-selection pool.
    Notify OptionsLegacyNotifyArgs
    Cluster-wide notification settings.
    bandwidthLimitClone Integer
    Clone I/O bandwidth limit in KiB/s.
    bandwidthLimitDefault Integer
    Default I/O bandwidth limit in KiB/s.
    bandwidthLimitMigration Integer
    Migration I/O bandwidth limit in KiB/s.
    bandwidthLimitMove Integer
    Move I/O bandwidth limit in KiB/s.
    bandwidthLimitRestore Integer
    Restore I/O bandwidth limit in KiB/s.
    console String
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crsHa String
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crsHaRebalanceOnStart Boolean
    Cluster resource scheduling setting for HA rebalance on start.
    description String
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    emailFrom String
    email address to send notification from (default is root@$hostname).
    haShutdownPolicy String
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    httpProxy String
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard String
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language String
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    macPrefix String
    Prefix for autogenerated MAC addresses.
    maxWorkers Integer
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migrationCidr String
    Cluster wide migration network CIDR.
    migrationType String
    Cluster wide migration type. Must be secure | insecure (default is secure).
    nextId OptionsLegacyNextId
    The ranges for the next free VM ID auto-selection pool.
    notify_ OptionsLegacyNotify
    Cluster-wide notification settings.
    bandwidthLimitClone number
    Clone I/O bandwidth limit in KiB/s.
    bandwidthLimitDefault number
    Default I/O bandwidth limit in KiB/s.
    bandwidthLimitMigration number
    Migration I/O bandwidth limit in KiB/s.
    bandwidthLimitMove number
    Move I/O bandwidth limit in KiB/s.
    bandwidthLimitRestore number
    Restore I/O bandwidth limit in KiB/s.
    console string
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crsHa string
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crsHaRebalanceOnStart boolean
    Cluster resource scheduling setting for HA rebalance on start.
    description string
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    emailFrom string
    email address to send notification from (default is root@$hostname).
    haShutdownPolicy string
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    httpProxy string
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard string
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language string
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    macPrefix string
    Prefix for autogenerated MAC addresses.
    maxWorkers number
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migrationCidr string
    Cluster wide migration network CIDR.
    migrationType string
    Cluster wide migration type. Must be secure | insecure (default is secure).
    nextId OptionsLegacyNextId
    The ranges for the next free VM ID auto-selection pool.
    notify OptionsLegacyNotify
    Cluster-wide notification settings.
    bandwidth_limit_clone int
    Clone I/O bandwidth limit in KiB/s.
    bandwidth_limit_default int
    Default I/O bandwidth limit in KiB/s.
    bandwidth_limit_migration int
    Migration I/O bandwidth limit in KiB/s.
    bandwidth_limit_move int
    Move I/O bandwidth limit in KiB/s.
    bandwidth_limit_restore int
    Restore I/O bandwidth limit in KiB/s.
    console str
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crs_ha str
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crs_ha_rebalance_on_start bool
    Cluster resource scheduling setting for HA rebalance on start.
    description str
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    email_from str
    email address to send notification from (default is root@$hostname).
    ha_shutdown_policy str
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    http_proxy str
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard str
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language str
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    mac_prefix str
    Prefix for autogenerated MAC addresses.
    max_workers int
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migration_cidr str
    Cluster wide migration network CIDR.
    migration_type str
    Cluster wide migration type. Must be secure | insecure (default is secure).
    next_id OptionsLegacyNextIdArgs
    The ranges for the next free VM ID auto-selection pool.
    notify OptionsLegacyNotifyArgs
    Cluster-wide notification settings.
    bandwidthLimitClone Number
    Clone I/O bandwidth limit in KiB/s.
    bandwidthLimitDefault Number
    Default I/O bandwidth limit in KiB/s.
    bandwidthLimitMigration Number
    Migration I/O bandwidth limit in KiB/s.
    bandwidthLimitMove Number
    Move I/O bandwidth limit in KiB/s.
    bandwidthLimitRestore Number
    Restore I/O bandwidth limit in KiB/s.
    console String
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crsHa String
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crsHaRebalanceOnStart Boolean
    Cluster resource scheduling setting for HA rebalance on start.
    description String
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    emailFrom String
    email address to send notification from (default is root@$hostname).
    haShutdownPolicy String
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    httpProxy String
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard String
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language String
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    macPrefix String
    Prefix for autogenerated MAC addresses.
    maxWorkers Number
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migrationCidr String
    Cluster wide migration network CIDR.
    migrationType String
    Cluster wide migration type. Must be secure | insecure (default is secure).
    nextId Property Map
    The ranges for the next free VM ID auto-selection pool.
    notify Property Map
    Cluster-wide notification settings.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the OptionsLegacy resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing OptionsLegacy Resource

    Get an existing OptionsLegacy resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: OptionsLegacyState, opts?: CustomResourceOptions): OptionsLegacy
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        bandwidth_limit_clone: Optional[int] = None,
        bandwidth_limit_default: Optional[int] = None,
        bandwidth_limit_migration: Optional[int] = None,
        bandwidth_limit_move: Optional[int] = None,
        bandwidth_limit_restore: Optional[int] = None,
        console: Optional[str] = None,
        crs_ha: Optional[str] = None,
        crs_ha_rebalance_on_start: Optional[bool] = None,
        description: Optional[str] = None,
        email_from: Optional[str] = None,
        ha_shutdown_policy: Optional[str] = None,
        http_proxy: Optional[str] = None,
        keyboard: Optional[str] = None,
        language: Optional[str] = None,
        mac_prefix: Optional[str] = None,
        max_workers: Optional[int] = None,
        migration_cidr: Optional[str] = None,
        migration_type: Optional[str] = None,
        next_id: Optional[OptionsLegacyNextIdArgs] = None,
        notify: Optional[OptionsLegacyNotifyArgs] = None) -> OptionsLegacy
    func GetOptionsLegacy(ctx *Context, name string, id IDInput, state *OptionsLegacyState, opts ...ResourceOption) (*OptionsLegacy, error)
    public static OptionsLegacy Get(string name, Input<string> id, OptionsLegacyState? state, CustomResourceOptions? opts = null)
    public static OptionsLegacy get(String name, Output<String> id, OptionsLegacyState state, CustomResourceOptions options)
    resources:  _:    type: proxmoxve:cluster:OptionsLegacy    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    BandwidthLimitClone int
    Clone I/O bandwidth limit in KiB/s.
    BandwidthLimitDefault int
    Default I/O bandwidth limit in KiB/s.
    BandwidthLimitMigration int
    Migration I/O bandwidth limit in KiB/s.
    BandwidthLimitMove int
    Move I/O bandwidth limit in KiB/s.
    BandwidthLimitRestore int
    Restore I/O bandwidth limit in KiB/s.
    Console string
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    CrsHa string
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    CrsHaRebalanceOnStart bool
    Cluster resource scheduling setting for HA rebalance on start.
    Description string
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    EmailFrom string
    email address to send notification from (default is root@$hostname).
    HaShutdownPolicy string
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    HttpProxy string
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    Keyboard string
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    Language string
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    MacPrefix string
    Prefix for autogenerated MAC addresses.
    MaxWorkers int
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    MigrationCidr string
    Cluster wide migration network CIDR.
    MigrationType string
    Cluster wide migration type. Must be secure | insecure (default is secure).
    NextId Pulumi.ProxmoxVE.Cluster.Inputs.OptionsLegacyNextId
    The ranges for the next free VM ID auto-selection pool.
    Notify Pulumi.ProxmoxVE.Cluster.Inputs.OptionsLegacyNotify
    Cluster-wide notification settings.
    BandwidthLimitClone int
    Clone I/O bandwidth limit in KiB/s.
    BandwidthLimitDefault int
    Default I/O bandwidth limit in KiB/s.
    BandwidthLimitMigration int
    Migration I/O bandwidth limit in KiB/s.
    BandwidthLimitMove int
    Move I/O bandwidth limit in KiB/s.
    BandwidthLimitRestore int
    Restore I/O bandwidth limit in KiB/s.
    Console string
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    CrsHa string
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    CrsHaRebalanceOnStart bool
    Cluster resource scheduling setting for HA rebalance on start.
    Description string
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    EmailFrom string
    email address to send notification from (default is root@$hostname).
    HaShutdownPolicy string
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    HttpProxy string
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    Keyboard string
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    Language string
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    MacPrefix string
    Prefix for autogenerated MAC addresses.
    MaxWorkers int
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    MigrationCidr string
    Cluster wide migration network CIDR.
    MigrationType string
    Cluster wide migration type. Must be secure | insecure (default is secure).
    NextId OptionsLegacyNextIdArgs
    The ranges for the next free VM ID auto-selection pool.
    Notify OptionsLegacyNotifyArgs
    Cluster-wide notification settings.
    bandwidthLimitClone Integer
    Clone I/O bandwidth limit in KiB/s.
    bandwidthLimitDefault Integer
    Default I/O bandwidth limit in KiB/s.
    bandwidthLimitMigration Integer
    Migration I/O bandwidth limit in KiB/s.
    bandwidthLimitMove Integer
    Move I/O bandwidth limit in KiB/s.
    bandwidthLimitRestore Integer
    Restore I/O bandwidth limit in KiB/s.
    console String
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crsHa String
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crsHaRebalanceOnStart Boolean
    Cluster resource scheduling setting for HA rebalance on start.
    description String
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    emailFrom String
    email address to send notification from (default is root@$hostname).
    haShutdownPolicy String
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    httpProxy String
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard String
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language String
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    macPrefix String
    Prefix for autogenerated MAC addresses.
    maxWorkers Integer
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migrationCidr String
    Cluster wide migration network CIDR.
    migrationType String
    Cluster wide migration type. Must be secure | insecure (default is secure).
    nextId OptionsLegacyNextId
    The ranges for the next free VM ID auto-selection pool.
    notify_ OptionsLegacyNotify
    Cluster-wide notification settings.
    bandwidthLimitClone number
    Clone I/O bandwidth limit in KiB/s.
    bandwidthLimitDefault number
    Default I/O bandwidth limit in KiB/s.
    bandwidthLimitMigration number
    Migration I/O bandwidth limit in KiB/s.
    bandwidthLimitMove number
    Move I/O bandwidth limit in KiB/s.
    bandwidthLimitRestore number
    Restore I/O bandwidth limit in KiB/s.
    console string
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crsHa string
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crsHaRebalanceOnStart boolean
    Cluster resource scheduling setting for HA rebalance on start.
    description string
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    emailFrom string
    email address to send notification from (default is root@$hostname).
    haShutdownPolicy string
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    httpProxy string
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard string
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language string
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    macPrefix string
    Prefix for autogenerated MAC addresses.
    maxWorkers number
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migrationCidr string
    Cluster wide migration network CIDR.
    migrationType string
    Cluster wide migration type. Must be secure | insecure (default is secure).
    nextId OptionsLegacyNextId
    The ranges for the next free VM ID auto-selection pool.
    notify OptionsLegacyNotify
    Cluster-wide notification settings.
    bandwidth_limit_clone int
    Clone I/O bandwidth limit in KiB/s.
    bandwidth_limit_default int
    Default I/O bandwidth limit in KiB/s.
    bandwidth_limit_migration int
    Migration I/O bandwidth limit in KiB/s.
    bandwidth_limit_move int
    Move I/O bandwidth limit in KiB/s.
    bandwidth_limit_restore int
    Restore I/O bandwidth limit in KiB/s.
    console str
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crs_ha str
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crs_ha_rebalance_on_start bool
    Cluster resource scheduling setting for HA rebalance on start.
    description str
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    email_from str
    email address to send notification from (default is root@$hostname).
    ha_shutdown_policy str
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    http_proxy str
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard str
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language str
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    mac_prefix str
    Prefix for autogenerated MAC addresses.
    max_workers int
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migration_cidr str
    Cluster wide migration network CIDR.
    migration_type str
    Cluster wide migration type. Must be secure | insecure (default is secure).
    next_id OptionsLegacyNextIdArgs
    The ranges for the next free VM ID auto-selection pool.
    notify OptionsLegacyNotifyArgs
    Cluster-wide notification settings.
    bandwidthLimitClone Number
    Clone I/O bandwidth limit in KiB/s.
    bandwidthLimitDefault Number
    Default I/O bandwidth limit in KiB/s.
    bandwidthLimitMigration Number
    Migration I/O bandwidth limit in KiB/s.
    bandwidthLimitMove Number
    Move I/O bandwidth limit in KiB/s.
    bandwidthLimitRestore Number
    Restore I/O bandwidth limit in KiB/s.
    console String
    Select the default Console viewer. Must be applet | vv| html5 | xtermjs. You can either use the builtin java applet (VNC; deprecated and maps to html5), an external virt-viewer compatible application (SPICE), an HTML5 based vnc viewer (noVNC), or an HTML5 based console client (xtermjs). If the selected viewer is not available (e.g. SPICE not activated for the VM), the fallback is noVNC.
    crsHa String
    Cluster resource scheduling setting for HA. Must be static | basic (default is basic).
    crsHaRebalanceOnStart Boolean
    Cluster resource scheduling setting for HA rebalance on start.
    description String
    Datacenter description. Shown in the web-interface datacenter notes panel. This is saved as comment inside the configuration file.
    emailFrom String
    email address to send notification from (default is root@$hostname).
    haShutdownPolicy String
    Cluster wide HA shutdown policy. Must be freeze | failover | migrate | conditional (default is conditional).
    httpProxy String
    Specify external http proxy which is used for downloads (example: http://username:password@host:port/).
    keyboard String
    Default keyboard layout for vnc server. Must be de | de-ch | da | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sv | sl | tr.
    language String
    Default GUI language. Must be ca | da | de | en | es | eu | fa | fr | he | it | ja | nb | nn | pl | pt_BR | ru | sl | sv | tr | zh_CN | zh_TW.
    macPrefix String
    Prefix for autogenerated MAC addresses.
    maxWorkers Number
    Defines how many workers (per node) are maximal started on actions like 'stopall VMs' or task from the ha-manager.
    migrationCidr String
    Cluster wide migration network CIDR.
    migrationType String
    Cluster wide migration type. Must be secure | insecure (default is secure).
    nextId Property Map
    The ranges for the next free VM ID auto-selection pool.
    notify Property Map
    Cluster-wide notification settings.

    Supporting Types

    OptionsLegacyNextId, OptionsLegacyNextIdArgs

    Lower int
    The minimum number for the next free VM ID. Must be higher or equal to 100
    Upper int
    The maximum number for the next free VM ID. Must be less or equal to 999999999
    Lower int
    The minimum number for the next free VM ID. Must be higher or equal to 100
    Upper int
    The maximum number for the next free VM ID. Must be less or equal to 999999999
    lower Integer
    The minimum number for the next free VM ID. Must be higher or equal to 100
    upper Integer
    The maximum number for the next free VM ID. Must be less or equal to 999999999
    lower number
    The minimum number for the next free VM ID. Must be higher or equal to 100
    upper number
    The maximum number for the next free VM ID. Must be less or equal to 999999999
    lower int
    The minimum number for the next free VM ID. Must be higher or equal to 100
    upper int
    The maximum number for the next free VM ID. Must be less or equal to 999999999
    lower Number
    The minimum number for the next free VM ID. Must be higher or equal to 100
    upper Number
    The maximum number for the next free VM ID. Must be less or equal to 999999999

    OptionsLegacyNotify, OptionsLegacyNotifyArgs

    HaFencingMode string
    Cluster-wide notification settings for the HA fencing mode. Must be always | never.
    HaFencingTarget string
    Cluster-wide notification settings for the HA fencing target.
    PackageUpdates string
    Cluster-wide notification settings for package updates. Must be auto | always | never.
    PackageUpdatesTarget string
    Cluster-wide notification settings for the package updates target.
    Replication string
    Cluster-wide notification settings for replication. Must be always | never.
    ReplicationTarget string
    Cluster-wide notification settings for the replication target.
    HaFencingMode string
    Cluster-wide notification settings for the HA fencing mode. Must be always | never.
    HaFencingTarget string
    Cluster-wide notification settings for the HA fencing target.
    PackageUpdates string
    Cluster-wide notification settings for package updates. Must be auto | always | never.
    PackageUpdatesTarget string
    Cluster-wide notification settings for the package updates target.
    Replication string
    Cluster-wide notification settings for replication. Must be always | never.
    ReplicationTarget string
    Cluster-wide notification settings for the replication target.
    haFencingMode String
    Cluster-wide notification settings for the HA fencing mode. Must be always | never.
    haFencingTarget String
    Cluster-wide notification settings for the HA fencing target.
    packageUpdates String
    Cluster-wide notification settings for package updates. Must be auto | always | never.
    packageUpdatesTarget String
    Cluster-wide notification settings for the package updates target.
    replication String
    Cluster-wide notification settings for replication. Must be always | never.
    replicationTarget String
    Cluster-wide notification settings for the replication target.
    haFencingMode string
    Cluster-wide notification settings for the HA fencing mode. Must be always | never.
    haFencingTarget string
    Cluster-wide notification settings for the HA fencing target.
    packageUpdates string
    Cluster-wide notification settings for package updates. Must be auto | always | never.
    packageUpdatesTarget string
    Cluster-wide notification settings for the package updates target.
    replication string
    Cluster-wide notification settings for replication. Must be always | never.
    replicationTarget string
    Cluster-wide notification settings for the replication target.
    ha_fencing_mode str
    Cluster-wide notification settings for the HA fencing mode. Must be always | never.
    ha_fencing_target str
    Cluster-wide notification settings for the HA fencing target.
    package_updates str
    Cluster-wide notification settings for package updates. Must be auto | always | never.
    package_updates_target str
    Cluster-wide notification settings for the package updates target.
    replication str
    Cluster-wide notification settings for replication. Must be always | never.
    replication_target str
    Cluster-wide notification settings for the replication target.
    haFencingMode String
    Cluster-wide notification settings for the HA fencing mode. Must be always | never.
    haFencingTarget String
    Cluster-wide notification settings for the HA fencing target.
    packageUpdates String
    Cluster-wide notification settings for package updates. Must be auto | always | never.
    packageUpdatesTarget String
    Cluster-wide notification settings for the package updates target.
    replication String
    Cluster-wide notification settings for replication. Must be always | never.
    replicationTarget String
    Cluster-wide notification settings for the replication target.

    Import

    !/usr/bin/env sh Cluster options are global and can be imported using e.g.:

    $ pulumi import proxmoxve:cluster/optionsLegacy:OptionsLegacy options cluster

    To learn more about importing existing cloud resources, see Importing resources.

    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) v8.1.0
    published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
    Schema (JSON)
    muhlba91/pulumi-proxmoxve
      Try Pulumi Cloud free. Your team will thank you.