published on Sunday, Apr 5, 2026 by Daniel Muehlbachler-Pietrzykowski
published on Sunday, Apr 5, 2026 by Daniel Muehlbachler-Pietrzykowski
Manages a virtual machine.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as proxmoxve from "@muhlba91/pulumi-proxmoxve";
import * as random from "@pulumi/random";
import * as std from "@pulumi/std";
import * as tls from "@pulumi/tls";
export = async () => {
const latestUbuntu22JammyQcow2Img = new proxmoxve.download.FileLegacy("latest_ubuntu_22_jammy_qcow2_img", {
contentType: "import",
datastoreId: "local",
nodeName: "pve",
url: "https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img",
fileName: "jammy-server-cloudimg-amd64.qcow2",
});
const ubuntuVmPassword = new random.RandomPassword("ubuntu_vm_password", {
length: 16,
overrideSpecial: "_%@",
special: true,
});
const ubuntuVmKey = new tls.PrivateKey("ubuntu_vm_key", {
algorithm: "RSA",
rsaBits: 2048,
});
const ubuntuVm = new proxmoxve.VmLegacy("ubuntu_vm", {
serialDevices: [{}],
name: "terraform-provider-proxmox-ubuntu-vm",
description: "Managed by Pulumi",
tags: [
"terraform",
"ubuntu",
],
nodeName: "first-node",
vmId: 4321,
agent: {
enabled: false,
},
stopOnDestroy: true,
startup: {
order: 3,
upDelay: 60,
downDelay: 60,
},
cpu: {
cores: 2,
type: "x86-64-v2-AES",
},
memory: {
dedicated: 2048,
floating: 2048,
},
disks: [{
datastoreId: "local-lvm",
importFrom: latestUbuntu22JammyQcow2Img.id,
"interface": "scsi0",
}],
initialization: {
ipConfigs: [{
ipv4: {
address: "dhcp",
},
}],
userAccount: {
keys: [std.trimspaceOutput({
input: ubuntuVmKey.publicKeyOpenssh,
}).apply(invoke => invoke.result)],
password: ubuntuVmPassword.result,
username: "ubuntu",
},
userDataFileId: cloudConfig.id,
},
networkDevices: [{
bridge: "vmbr0",
}],
operatingSystem: {
type: "l26",
},
tpmState: {
version: "v2.0",
},
virtiofs: [{
mapping: "data_share",
cache: "always",
directIo: true,
}],
});
return {
ubuntuVmPassword: ubuntuVmPassword.result,
ubuntuVmPrivateKey: ubuntuVmKey.privateKeyPem,
ubuntuVmPublicKey: ubuntuVmKey.publicKeyOpenssh,
};
}
import pulumi
import pulumi_proxmoxve as proxmoxve
import pulumi_random as random
import pulumi_std as std
import pulumi_tls as tls
latest_ubuntu22_jammy_qcow2_img = proxmoxve.download.FileLegacy("latest_ubuntu_22_jammy_qcow2_img",
content_type="import",
datastore_id="local",
node_name="pve",
url="https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img",
file_name="jammy-server-cloudimg-amd64.qcow2")
ubuntu_vm_password = random.RandomPassword("ubuntu_vm_password",
length=16,
override_special="_%@",
special=True)
ubuntu_vm_key = tls.PrivateKey("ubuntu_vm_key",
algorithm="RSA",
rsa_bits=2048)
ubuntu_vm = proxmoxve.VmLegacy("ubuntu_vm",
serial_devices=[{}],
name="terraform-provider-proxmox-ubuntu-vm",
description="Managed by Pulumi",
tags=[
"terraform",
"ubuntu",
],
node_name="first-node",
vm_id=4321,
agent={
"enabled": False,
},
stop_on_destroy=True,
startup={
"order": 3,
"up_delay": 60,
"down_delay": 60,
},
cpu={
"cores": 2,
"type": "x86-64-v2-AES",
},
memory={
"dedicated": 2048,
"floating": 2048,
},
disks=[{
"datastore_id": "local-lvm",
"import_from": latest_ubuntu22_jammy_qcow2_img.id,
"interface": "scsi0",
}],
initialization={
"ip_configs": [{
"ipv4": {
"address": "dhcp",
},
}],
"user_account": {
"keys": [std.trimspace_output(input=ubuntu_vm_key.public_key_openssh).apply(lambda invoke: invoke.result)],
"password": ubuntu_vm_password.result,
"username": "ubuntu",
},
"user_data_file_id": cloud_config["id"],
},
network_devices=[{
"bridge": "vmbr0",
}],
operating_system={
"type": "l26",
},
tpm_state={
"version": "v2.0",
},
virtiofs=[{
"mapping": "data_share",
"cache": "always",
"direct_io": True,
}])
pulumi.export("ubuntuVmPassword", ubuntu_vm_password.result)
pulumi.export("ubuntuVmPrivateKey", ubuntu_vm_key.private_key_pem)
pulumi.export("ubuntuVmPublicKey", ubuntu_vm_key.public_key_openssh)
package main
import (
"github.com/muhlba91/pulumi-proxmoxve/sdk/v8/go/proxmoxve"
"github.com/muhlba91/pulumi-proxmoxve/sdk/v8/go/proxmoxve/download"
"github.com/pulumi/pulumi-random/sdk/v4/go/random"
"github.com/pulumi/pulumi-std/sdk/v2/go/std"
"github.com/pulumi/pulumi-tls/sdk/v5/go/tls"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
latestUbuntu22JammyQcow2Img, err := download.NewFileLegacy(ctx, "latest_ubuntu_22_jammy_qcow2_img", &download.FileLegacyArgs{
ContentType: pulumi.String("import"),
DatastoreId: pulumi.String("local"),
NodeName: pulumi.String("pve"),
Url: pulumi.String("https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img"),
FileName: pulumi.String("jammy-server-cloudimg-amd64.qcow2"),
})
if err != nil {
return err
}
ubuntuVmPassword, err := random.NewRandomPassword(ctx, "ubuntu_vm_password", &random.RandomPasswordArgs{
Length: pulumi.Int(16),
OverrideSpecial: pulumi.String("_%@"),
Special: pulumi.Bool(true),
})
if err != nil {
return err
}
ubuntuVmKey, err := tls.NewPrivateKey(ctx, "ubuntu_vm_key", &tls.PrivateKeyArgs{
Algorithm: pulumi.String("RSA"),
RsaBits: pulumi.Int(2048),
})
if err != nil {
return err
}
_, err = proxmoxve.NewVmLegacy(ctx, "ubuntu_vm", &proxmoxve.VmLegacyArgs{
SerialDevices: proxmoxve.VmLegacySerialDeviceArray{
&proxmoxve.VmLegacySerialDeviceArgs{},
},
Name: pulumi.String("terraform-provider-proxmox-ubuntu-vm"),
Description: pulumi.String("Managed by Pulumi"),
Tags: pulumi.StringArray{
pulumi.String("terraform"),
pulumi.String("ubuntu"),
},
NodeName: pulumi.String("first-node"),
VmId: pulumi.Int(4321),
Agent: &proxmoxve.VmLegacyAgentArgs{
Enabled: pulumi.Bool(false),
},
StopOnDestroy: pulumi.Bool(true),
Startup: &proxmoxve.VmLegacyStartupArgs{
Order: pulumi.Int(3),
UpDelay: pulumi.Int(60),
DownDelay: pulumi.Int(60),
},
Cpu: &proxmoxve.VmLegacyCpuArgs{
Cores: pulumi.Int(2),
Type: pulumi.String("x86-64-v2-AES"),
},
Memory: &proxmoxve.VmLegacyMemoryArgs{
Dedicated: pulumi.Int(2048),
Floating: pulumi.Int(2048),
},
Disks: proxmoxve.VmLegacyDiskArray{
&proxmoxve.VmLegacyDiskArgs{
DatastoreId: pulumi.String("local-lvm"),
ImportFrom: latestUbuntu22JammyQcow2Img.ID(),
Interface: pulumi.String("scsi0"),
},
},
Initialization: &proxmoxve.VmLegacyInitializationArgs{
IpConfigs: proxmoxve.VmLegacyInitializationIpConfigArray{
&proxmoxve.VmLegacyInitializationIpConfigArgs{
Ipv4: &proxmoxve.VmLegacyInitializationIpConfigIpv4Args{
Address: pulumi.String("dhcp"),
},
},
},
UserAccount: &proxmoxve.VmLegacyInitializationUserAccountArgs{
Keys: pulumi.StringArray{
std.TrimspaceOutput(ctx, std.TrimspaceOutputArgs{
Input: ubuntuVmKey.PublicKeyOpenssh,
}, nil).ApplyT(func(invoke std.TrimspaceResult) (*string, error) {
val := invoke.Result
return &val, nil
}).(pulumi.StringPtrOutput),
},
Password: ubuntuVmPassword.Result,
Username: pulumi.String("ubuntu"),
},
UserDataFileId: pulumi.Any(cloudConfig.Id),
},
NetworkDevices: proxmoxve.VmLegacyNetworkDeviceArray{
&proxmoxve.VmLegacyNetworkDeviceArgs{
Bridge: pulumi.String("vmbr0"),
},
},
OperatingSystem: &proxmoxve.VmLegacyOperatingSystemArgs{
Type: pulumi.String("l26"),
},
TpmState: &proxmoxve.VmLegacyTpmStateArgs{
Version: pulumi.String("v2.0"),
},
Virtiofs: proxmoxve.VmLegacyVirtiofArray{
&proxmoxve.VmLegacyVirtiofArgs{
Mapping: pulumi.String("data_share"),
Cache: pulumi.String("always"),
DirectIo: pulumi.Bool(true),
},
},
})
if err != nil {
return err
}
ctx.Export("ubuntuVmPassword", ubuntuVmPassword.Result)
ctx.Export("ubuntuVmPrivateKey", ubuntuVmKey.PrivateKeyPem)
ctx.Export("ubuntuVmPublicKey", ubuntuVmKey.PublicKeyOpenssh)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using ProxmoxVE = Pulumi.ProxmoxVE;
using Random = Pulumi.Random;
using Std = Pulumi.Std;
using Tls = Pulumi.Tls;
return await Deployment.RunAsync(() =>
{
var latestUbuntu22JammyQcow2Img = new ProxmoxVE.Download.FileLegacy("latest_ubuntu_22_jammy_qcow2_img", new()
{
ContentType = "import",
DatastoreId = "local",
NodeName = "pve",
Url = "https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img",
FileName = "jammy-server-cloudimg-amd64.qcow2",
});
var ubuntuVmPassword = new Random.Index.RandomPassword("ubuntu_vm_password", new()
{
Length = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(16) (example.pp:77,21-23)),
OverrideSpecial = "_%@",
Special = true,
});
var ubuntuVmKey = new Tls.Index.PrivateKey("ubuntu_vm_key", new()
{
Algorithm = "RSA",
RsaBits = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2048) (example.pp:85,19-23)),
});
var ubuntuVm = new ProxmoxVE.Index.VmLegacy("ubuntu_vm", new()
{
SerialDevices = new[]
{
null,
},
Name = "terraform-provider-proxmox-ubuntu-vm",
Description = "Managed by Pulumi",
Tags = new[]
{
"terraform",
"ubuntu",
},
NodeName = "first-node",
VmId = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(4321) (example.pp:7,19-23)),
Agent = new ProxmoxVE.Inputs.VmLegacyAgentArgs
{
Enabled = false,
},
StopOnDestroy = true,
Startup = new ProxmoxVE.Inputs.VmLegacyStartupArgs
{
Order = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(3) (:0,0-0)),
UpDelay = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(60) (:0,0-0)),
DownDelay = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(60) (:0,0-0)),
},
Cpu = new ProxmoxVE.Inputs.VmLegacyCpuArgs
{
Cores = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2) (example.pp:22,13-14)),
Type = "x86-64-v2-AES",
},
Memory = new ProxmoxVE.Inputs.VmLegacyMemoryArgs
{
Dedicated = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2048) (example.pp:26,17-21)),
Floating = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2048) (example.pp:27,17-21)),
},
Disks = new[]
{
new ProxmoxVE.Inputs.VmLegacyDiskArgs
{
DatastoreId = "local-lvm",
ImportFrom = latestUbuntu22JammyQcow2Img.Id,
Interface = "scsi0",
},
},
Initialization = new ProxmoxVE.Inputs.VmLegacyInitializationArgs
{
IpConfigs = new[]
{
new ProxmoxVE.Inputs.VmLegacyInitializationIpConfigArgs
{
Ipv4 = new ProxmoxVE.Inputs.VmLegacyInitializationIpConfigIpv4Args
{
Address = "dhcp",
},
},
},
UserAccount = new ProxmoxVE.Inputs.VmLegacyInitializationUserAccountArgs
{
Keys = new[]
{
Std.Index.Trimspace.Invoke(new()
{
Input = ubuntuVmKey.PublicKeyOpenssh,
}).Apply(invoke => invoke.Result),
},
Password = ubuntuVmPassword.Result,
Username = "ubuntu",
},
UserDataFileId = cloudConfig.Id,
},
NetworkDevices = new[]
{
new ProxmoxVE.Inputs.VmLegacyNetworkDeviceArgs
{
Bridge = "vmbr0",
},
},
OperatingSystem = new ProxmoxVE.Inputs.VmLegacyOperatingSystemArgs
{
Type = "l26",
},
TpmState = new ProxmoxVE.Inputs.VmLegacyTpmStateArgs
{
Version = "v2.0",
},
Virtiofs = new[]
{
new ProxmoxVE.Inputs.VmLegacyVirtiofArgs
{
Mapping = "data_share",
Cache = "always",
DirectIo = true,
},
},
});
return new Dictionary<string, object?>
{
["ubuntuVmPassword"] = ubuntuVmPassword.Result,
["ubuntuVmPrivateKey"] = ubuntuVmKey.PrivateKeyPem,
["ubuntuVmPublicKey"] = ubuntuVmKey.PublicKeyOpenssh,
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import io.muehlbachler.pulumi.proxmoxve.download.FileLegacy;
import io.muehlbachler.pulumi.proxmoxve.download.FileLegacyArgs;
import com.pulumi.random.RandomPassword;
import com.pulumi.random.RandomPasswordArgs;
import com.pulumi.tls.PrivateKey;
import com.pulumi.tls.PrivateKeyArgs;
import io.muehlbachler.pulumi.proxmoxve.VmLegacy;
import io.muehlbachler.pulumi.proxmoxve.VmLegacyArgs;
import com.pulumi.proxmoxve.inputs.VmLegacySerialDeviceArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyAgentArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyStartupArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyCpuArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyMemoryArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyDiskArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyInitializationArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyInitializationUserAccountArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyNetworkDeviceArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyOperatingSystemArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyTpmStateArgs;
import com.pulumi.proxmoxve.inputs.VmLegacyVirtiofArgs;
import com.pulumi.std.StdFunctions;
import com.pulumi.std.inputs.TrimspaceArgs;
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 latestUbuntu22JammyQcow2Img = new FileLegacy("latestUbuntu22JammyQcow2Img", FileLegacyArgs.builder()
.contentType("import")
.datastoreId("local")
.nodeName("pve")
.url("https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img")
.fileName("jammy-server-cloudimg-amd64.qcow2")
.build());
var ubuntuVmPassword = new RandomPassword("ubuntuVmPassword", RandomPasswordArgs.builder()
.length(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(16) (example.pp:77,21-23)))
.overrideSpecial("_%@")
.special(true)
.build());
var ubuntuVmKey = new PrivateKey("ubuntuVmKey", PrivateKeyArgs.builder()
.algorithm("RSA")
.rsaBits(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2048) (example.pp:85,19-23)))
.build());
var ubuntuVm = new VmLegacy("ubuntuVm", VmLegacyArgs.builder()
.serialDevices(VmLegacySerialDeviceArgs.builder()
.build())
.name("terraform-provider-proxmox-ubuntu-vm")
.description("Managed by Pulumi")
.tags(
"terraform",
"ubuntu")
.nodeName("first-node")
.vmId(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(4321) (example.pp:7,19-23)))
.agent(VmLegacyAgentArgs.builder()
.enabled(false)
.build())
.stopOnDestroy(true)
.startup(VmLegacyStartupArgs.builder()
.order(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(3) (:0,0-0)))
.upDelay(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(60) (:0,0-0)))
.downDelay(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(60) (:0,0-0)))
.build())
.cpu(VmLegacyCpuArgs.builder()
.cores(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2) (example.pp:22,13-14)))
.type("x86-64-v2-AES")
.build())
.memory(VmLegacyMemoryArgs.builder()
.dedicated(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2048) (example.pp:26,17-21)))
.floating(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(2048) (example.pp:27,17-21)))
.build())
.disks(VmLegacyDiskArgs.builder()
.datastoreId("local-lvm")
.importFrom(latestUbuntu22JammyQcow2Img.id())
.interface_("scsi0")
.build())
.initialization(VmLegacyInitializationArgs.builder()
.ipConfigs(VmLegacyInitializationIpConfigArgs.builder()
.ipv4(VmLegacyInitializationIpConfigIpv4Args.builder()
.address("dhcp")
.build())
.build())
.userAccount(VmLegacyInitializationUserAccountArgs.builder()
.keys(StdFunctions.trimspace(TrimspaceArgs.builder()
.input(ubuntuVmKey.publicKeyOpenssh())
.build()).applyValue(_invoke -> _invoke.result()))
.password(ubuntuVmPassword.result())
.username("ubuntu")
.build())
.userDataFileId(cloudConfig.id())
.build())
.networkDevices(VmLegacyNetworkDeviceArgs.builder()
.bridge("vmbr0")
.build())
.operatingSystem(VmLegacyOperatingSystemArgs.builder()
.type("l26")
.build())
.tpmState(VmLegacyTpmStateArgs.builder()
.version("v2.0")
.build())
.virtiofs(VmLegacyVirtiofArgs.builder()
.mapping("data_share")
.cache("always")
.directIo(true)
.build())
.build());
ctx.export("ubuntuVmPassword", ubuntuVmPassword.result());
ctx.export("ubuntuVmPrivateKey", ubuntuVmKey.privateKeyPem());
ctx.export("ubuntuVmPublicKey", ubuntuVmKey.publicKeyOpenssh());
}
}
resources:
ubuntuVm:
type: proxmoxve:VmLegacy
name: ubuntu_vm
properties:
serialDevices:
- {}
name: terraform-provider-proxmox-ubuntu-vm
description: Managed by Pulumi
tags:
- terraform
- ubuntu
nodeName: first-node
vmId: 4321
agent:
enabled: false
stopOnDestroy: true
startup:
order: '3'
upDelay: '60'
downDelay: '60'
cpu:
cores: 2
type: x86-64-v2-AES
memory:
dedicated: 2048
floating: 2048
disks:
- datastoreId: local-lvm
importFrom: ${latestUbuntu22JammyQcow2Img.id}
interface: scsi0
initialization:
ipConfigs:
- ipv4:
address: dhcp
userAccount:
keys:
- fn::invoke:
function: std:trimspace
arguments:
input: ${ubuntuVmKey.publicKeyOpenssh}
return: result
password: ${ubuntuVmPassword.result}
username: ubuntu
userDataFileId: ${cloudConfig.id}
networkDevices:
- bridge: vmbr0
operatingSystem:
type: l26
tpmState:
version: v2.0
virtiofs:
- mapping: data_share
cache: always
directIo: true
latestUbuntu22JammyQcow2Img:
type: proxmoxve:download:FileLegacy
name: latest_ubuntu_22_jammy_qcow2_img
properties:
contentType: import
datastoreId: local
nodeName: pve
url: https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img
fileName: jammy-server-cloudimg-amd64.qcow2
ubuntuVmPassword:
type: random:RandomPassword
name: ubuntu_vm_password
properties:
length: 16
overrideSpecial: _%@
special: true
ubuntuVmKey:
type: tls:PrivateKey
name: ubuntu_vm_key
properties:
algorithm: RSA
rsaBits: 2048
outputs:
ubuntuVmPassword: ${ubuntuVmPassword.result}
ubuntuVmPrivateKey: ${ubuntuVmKey.privateKeyPem}
ubuntuVmPublicKey: ${ubuntuVmKey.publicKeyOpenssh}
Qemu guest agent
Qemu-guest-agent is an application which can be installed inside guest VM, see Proxmox Wiki and Proxmox Documentation
For VM with agent.enabled = false, Proxmox uses ACPI for Shutdown and
Reboot, and qemu-guest-agent is not needed inside the VM. For some VMs,
the shutdown process may not work, causing the VM to be stuck on destroying.
Add stopOnDestroy = true to the VM configuration to stop the VM instead of
shutting it down.
Setting agent.enabled = true informs Proxmox that the guest agent is expected
to be running inside the VM. Proxmox then uses qemu-guest-agent instead of
ACPI to control the VM. If the agent is not running, Proxmox operations
Shutdown and Reboot time out and fail. The failing operation gets a lock on
the VM, and until the operation times out, other operations like Stop and
Reboot cannot be used.
Do not run VM with agent.enabled = true, unless the VM is configured to
automatically start qemu-guest-agent at some point.
“Monitor” tab in Proxmox GUI can be used to send low-level commands to qemu.
See the documentation.
Commands systemPowerdown and quit have proven useful in shutting down VMs
with agent.enabled = true and no agent running.
Cloud images usually do not have qemu-guest-agent installed. It is possible to
install and start it using cloud-init, e.g. using custom userDataFileId
file.
This provider requires agent.enabled = true to populate ipv4Addresses,
ipv6Addresses and networkInterfaceNames output attributes.
Setting agent.enabled = true without running qemu-guest-agent in the VM will
also result in long timeouts when using the provider, both when creating VMs,
and when refreshing resources. The provider has no way to distinguish between
“qemu-guest-agent not installed” and “very long boot due to a disk check”, it
trusts the user to set agent.enabled correctly and waits for
qemu-guest-agent to start.
AMD SEV
AMD SEV (-ES, -SNP) are security features for AMD processors. SEV-SNP support is included in Proxmox version 8.4, see Proxmox Wiki and Proxmox Documentation for more information.
amd-sev requires root and therefore root@pam auth.
SEV-SNP requires bios = OVMF and a supported AMD CPU (EPYC-v4 for instance), machine = q35 is also advised. No EFI disk is required since SEV-SNP uses consolidated read-only firmware. A configured EFI will be ignored.
All changes made to amdSev will trigger reboots. Removing or adding the amdSev block will force a replacement of the resource. Modifying the amdSev block will not trigger replacements.
allowSmt is by default set to true even if snp is not the selected type. Proxmox will ignore this value when snp is not in use. Likewise noKeySharing is false by default but ignored by Proxmox when snp is in use.
High Availability
When managing a virtual machine in a multi-node cluster, the VM’s HA settings can
be managed using the proxmoxve.HaresourceLegacy resource.
import * as pulumi from "@pulumi/pulumi";
import * as proxmoxve from "@muhlba91/pulumi-proxmoxve";
const ubuntuVm = new proxmoxve.VmLegacy("ubuntu_vm", {
name: "terraform-provider-proxmox-ubuntu-vm",
vmId: 4321,
});
const ubuntuVmHaresourceLegacy = new proxmoxve.HaresourceLegacy("ubuntu_vm", {
resourceId: pulumi.interpolate`vm:${ubuntuVm.vmId}`,
group: "node1",
state: "started",
comment: "Managed by Pulumi",
});
import pulumi
import pulumi_proxmoxve as proxmoxve
ubuntu_vm = proxmoxve.VmLegacy("ubuntu_vm",
name="terraform-provider-proxmox-ubuntu-vm",
vm_id=4321)
ubuntu_vm_haresource_legacy = proxmoxve.HaresourceLegacy("ubuntu_vm",
resource_id=ubuntu_vm.vm_id.apply(lambda vm_id: f"vm:{vm_id}"),
group="node1",
state="started",
comment="Managed by Pulumi")
package main
import (
"fmt"
"github.com/muhlba91/pulumi-proxmoxve/sdk/v8/go/proxmoxve"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
ubuntuVm, err := proxmoxve.NewVmLegacy(ctx, "ubuntu_vm", &proxmoxve.VmLegacyArgs{
Name: pulumi.String("terraform-provider-proxmox-ubuntu-vm"),
VmId: pulumi.Int(4321),
})
if err != nil {
return err
}
_, err = proxmoxve.NewHaresourceLegacy(ctx, "ubuntu_vm", &proxmoxve.HaresourceLegacyArgs{
ResourceId: ubuntuVm.VmId.ApplyT(func(vmId int) (string, error) {
return fmt.Sprintf("vm:%v", vmId), nil
}).(pulumi.StringOutput),
Group: pulumi.String("node1"),
State: pulumi.String("started"),
Comment: pulumi.String("Managed by Pulumi"),
})
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 ubuntuVm = new ProxmoxVE.Index.VmLegacy("ubuntu_vm", new()
{
Name = "terraform-provider-proxmox-ubuntu-vm",
VmId = %!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(4321) (example.pp:3,19-23)),
});
var ubuntuVmHaresourceLegacy = new ProxmoxVE.Index.HaresourceLegacy("ubuntu_vm", new()
{
ResourceId = ubuntuVm.VmId.Apply(vmId => $"vm:{vmId}"),
Group = "node1",
State = "started",
Comment = "Managed by Pulumi",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import io.muehlbachler.pulumi.proxmoxve.VmLegacy;
import io.muehlbachler.pulumi.proxmoxve.VmLegacyArgs;
import io.muehlbachler.pulumi.proxmoxve.HaresourceLegacy;
import io.muehlbachler.pulumi.proxmoxve.HaresourceLegacyArgs;
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 ubuntuVm = new VmLegacy("ubuntuVm", VmLegacyArgs.builder()
.name("terraform-provider-proxmox-ubuntu-vm")
.vmId(%!v(PANIC=Format method: fatal: A failure has occurred: unexpected literal type in GenLiteralValueExpression: cty.NumberIntVal(4321) (example.pp:3,19-23)))
.build());
var ubuntuVmHaresourceLegacy = new HaresourceLegacy("ubuntuVmHaresourceLegacy", HaresourceLegacyArgs.builder()
.resourceId(ubuntuVm.vmId().applyValue(_vmId -> String.format("vm:%s", _vmId)))
.group("node1")
.state("started")
.comment("Managed by Pulumi")
.build());
}
}
resources:
ubuntuVm:
type: proxmoxve:VmLegacy
name: ubuntu_vm
properties:
name: terraform-provider-proxmox-ubuntu-vm
vmId: 4321 # ...
ubuntuVmHaresourceLegacy:
type: proxmoxve:HaresourceLegacy
name: ubuntu_vm
properties:
resourceId: vm:${ubuntuVm.vmId}
group: node1
state: started
comment: Managed by Pulumi
HA-Aware Migration
When changing the nodeName of an HA-managed VM, the provider automatically
handles the migration in an HA-aware manner:
- Running HA VMs: Uses the HA manager’s migrate endpoint for live migration
- Stopped HA VMs: Temporarily removes from HA, performs standard migration, then re-adds to HA with the original configuration preserved
PVE 9.x Required: HA-aware migration requires Proxmox VE 9.x due to API changes. On PVE 8.x, migrating HA-managed VMs will fail. As a workaround, manually remove the VM from HA before changing
nodeName, then re-add after apply.
Create VmLegacy Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new VmLegacy(name: string, args: VmLegacyArgs, opts?: CustomResourceOptions);@overload
def VmLegacy(resource_name: str,
args: VmLegacyArgs,
opts: Optional[ResourceOptions] = None)
@overload
def VmLegacy(resource_name: str,
opts: Optional[ResourceOptions] = None,
node_name: Optional[str] = None,
acpi: Optional[bool] = None,
agent: Optional[VmLegacyAgentArgs] = None,
amd_sev: Optional[VmLegacyAmdSevArgs] = None,
audio_device: Optional[VmLegacyAudioDeviceArgs] = None,
bios: Optional[str] = None,
boot_orders: Optional[Sequence[str]] = None,
cdrom: Optional[VmLegacyCdromArgs] = None,
clone: Optional[VmLegacyCloneArgs] = None,
cpu: Optional[VmLegacyCpuArgs] = None,
delete_unreferenced_disks_on_destroy: Optional[bool] = None,
description: Optional[str] = None,
disks: Optional[Sequence[VmLegacyDiskArgs]] = None,
efi_disk: Optional[VmLegacyEfiDiskArgs] = None,
hook_script_file_id: Optional[str] = None,
hostpcis: Optional[Sequence[VmLegacyHostpciArgs]] = None,
hotplug: Optional[str] = None,
initialization: Optional[VmLegacyInitializationArgs] = None,
keyboard_layout: Optional[str] = None,
kvm_arguments: Optional[str] = None,
mac_addresses: Optional[Sequence[str]] = None,
machine: Optional[str] = None,
memory: Optional[VmLegacyMemoryArgs] = None,
migrate: Optional[bool] = None,
name: Optional[str] = None,
network_devices: Optional[Sequence[VmLegacyNetworkDeviceArgs]] = None,
numas: Optional[Sequence[VmLegacyNumaArgs]] = None,
on_boot: Optional[bool] = None,
operating_system: Optional[VmLegacyOperatingSystemArgs] = None,
pool_id: Optional[str] = None,
protection: Optional[bool] = None,
purge_on_destroy: Optional[bool] = None,
reboot: Optional[bool] = None,
reboot_after_update: Optional[bool] = None,
rngs: Optional[Sequence[VmLegacyRngArgs]] = None,
scsi_hardware: Optional[str] = None,
serial_devices: Optional[Sequence[VmLegacySerialDeviceArgs]] = None,
smbios: Optional[VmLegacySmbiosArgs] = None,
started: Optional[bool] = None,
startup: Optional[VmLegacyStartupArgs] = None,
stop_on_destroy: Optional[bool] = None,
tablet_device: Optional[bool] = None,
tags: Optional[Sequence[str]] = None,
template: Optional[bool] = None,
timeout_clone: Optional[int] = None,
timeout_create: Optional[int] = None,
timeout_migrate: Optional[int] = None,
timeout_move_disk: Optional[int] = None,
timeout_reboot: Optional[int] = None,
timeout_shutdown_vm: Optional[int] = None,
timeout_start_vm: Optional[int] = None,
timeout_stop_vm: Optional[int] = None,
tpm_state: Optional[VmLegacyTpmStateArgs] = None,
usbs: Optional[Sequence[VmLegacyUsbArgs]] = None,
vga: Optional[VmLegacyVgaArgs] = None,
virtiofs: Optional[Sequence[VmLegacyVirtiofArgs]] = None,
vm_id: Optional[int] = None,
watchdog: Optional[VmLegacyWatchdogArgs] = None)func NewVmLegacy(ctx *Context, name string, args VmLegacyArgs, opts ...ResourceOption) (*VmLegacy, error)public VmLegacy(string name, VmLegacyArgs args, CustomResourceOptions? opts = null)
public VmLegacy(String name, VmLegacyArgs args)
public VmLegacy(String name, VmLegacyArgs args, CustomResourceOptions options)
type: proxmoxve:VmLegacy
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 VmLegacyArgs
- 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 VmLegacyArgs
- 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 VmLegacyArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args VmLegacyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args VmLegacyArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
VmLegacy 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 VmLegacy resource accepts the following input properties:
- Node
Name string - The name of the node to assign the virtual machine to.
- Acpi bool
- Whether to enable ACPI (defaults to
true). - Agent
Pulumi.
Proxmox VE. Inputs. Vm Legacy Agent - The QEMU agent configuration.
- Amd
Sev Pulumi.Proxmox VE. Inputs. Vm Legacy Amd Sev - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- Audio
Device Pulumi.Proxmox VE. Inputs. Vm Legacy Audio Device - An audio device.
- Bios string
- The BIOS implementation (defaults to
seabios). - Boot
Orders List<string> - Specify a list of devices to boot from in the order they appear in the list.
- Cdrom
Pulumi.
Proxmox VE. Inputs. Vm Legacy Cdrom - The CD-ROM configuration.
- Clone
Pulumi.
Proxmox VE. Inputs. Vm Legacy Clone - The cloning configuration.
- Cpu
Pulumi.
Proxmox VE. Inputs. Vm Legacy Cpu - The CPU configuration.
- Delete
Unreferenced boolDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - Description string
- The description.
- Disks
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Disk> - A disk (multiple blocks supported).
- Efi
Disk Pulumi.Proxmox VE. Inputs. Vm Legacy Efi Disk - The efi disk device (required if
biosis set toovmf) - Hook
Script stringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - Hostpcis
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Hostpci> - A host PCI device mapping (multiple blocks supported).
- Hotplug string
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - Initialization
Pulumi.
Proxmox VE. Inputs. Vm Legacy Initialization - The cloud-init configuration.
- Keyboard
Layout string - The keyboard layout (defaults to
en-us). - Kvm
Arguments string - Arbitrary arguments passed to kvm.
- Mac
Addresses List<string> - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- Machine string
- The VM machine type (defaults to
pc). - Memory
Pulumi.
Proxmox VE. Inputs. Vm Legacy Memory - The memory configuration.
- Migrate bool
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - Name string
- The virtual machine name. Must be a valid DNS name.
- Network
Devices List<Pulumi.Proxmox VE. Inputs. Vm Legacy Network Device> - A network device (multiple blocks supported).
- Numas
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Numa> - The NUMA configuration.
- On
Boot bool - Specifies whether a VM will be started during system
boot. (defaults to
true) - Operating
System Pulumi.Proxmox VE. Inputs. Vm Legacy Operating System - The Operating System configuration.
- Pool
Id string - The identifier for a pool to assign the virtual machine to.
- Protection bool
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - Purge
On boolDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - Reboot bool
- Reboot the VM after initial creation (defaults to
false). - Reboot
After boolUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - Rngs
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Rng> - The random number generator configuration. Can only be set by
root@pam. - Scsi
Hardware string - The SCSI hardware type (defaults to
virtio-scsi-pci). - Serial
Devices List<Pulumi.Proxmox VE. Inputs. Vm Legacy Serial Device> - A serial device (multiple blocks supported).
- Smbios
Pulumi.
Proxmox VE. Inputs. Vm Legacy Smbios - The SMBIOS (type1) settings for the VM.
- Started bool
- Whether to start the virtual machine (defaults
to
true). - Startup
Pulumi.
Proxmox VE. Inputs. Vm Legacy Startup - Defines startup and shutdown behavior of the VM.
- Stop
On boolDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - Tablet
Device bool - Whether to enable the USB tablet device (defaults
to
true). - List<string>
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - Template bool
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - Timeout
Clone int - Timeout for cloning a VM in seconds (defaults to 1800).
- Timeout
Create int - Timeout for creating a VM in seconds (defaults to 1800).
- Timeout
Migrate int - Timeout for migrating the VM (defaults to 1800).
- Timeout
Move intDisk - Disk move timeout
- Timeout
Reboot int - Timeout for rebooting a VM in seconds (defaults to 1800).
- Timeout
Shutdown intVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- Timeout
Start intVm - Timeout for starting a VM in seconds (defaults to 1800).
- Timeout
Stop intVm - Timeout for stopping a VM in seconds (defaults to 300).
- Tpm
State Pulumi.Proxmox VE. Inputs. Vm Legacy Tpm State - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - Usbs
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Usb> - A host USB device mapping (multiple blocks supported).
- Vga
Pulumi.
Proxmox VE. Inputs. Vm Legacy Vga - The VGA configuration.
- Virtiofs
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Virtiof> - Virtiofs share
- Vm
Id int - The VM identifier.
- Watchdog
Pulumi.
Proxmox VE. Inputs. Vm Legacy Watchdog - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- Node
Name string - The name of the node to assign the virtual machine to.
- Acpi bool
- Whether to enable ACPI (defaults to
true). - Agent
Vm
Legacy Agent Args - The QEMU agent configuration.
- Amd
Sev VmLegacy Amd Sev Args - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- Audio
Device VmLegacy Audio Device Args - An audio device.
- Bios string
- The BIOS implementation (defaults to
seabios). - Boot
Orders []string - Specify a list of devices to boot from in the order they appear in the list.
- Cdrom
Vm
Legacy Cdrom Args - The CD-ROM configuration.
- Clone
Vm
Legacy Clone Args - The cloning configuration.
- Cpu
Vm
Legacy Cpu Args - The CPU configuration.
- Delete
Unreferenced boolDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - Description string
- The description.
- Disks
[]Vm
Legacy Disk Args - A disk (multiple blocks supported).
- Efi
Disk VmLegacy Efi Disk Args - The efi disk device (required if
biosis set toovmf) - Hook
Script stringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - Hostpcis
[]Vm
Legacy Hostpci Args - A host PCI device mapping (multiple blocks supported).
- Hotplug string
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - Initialization
Vm
Legacy Initialization Args - The cloud-init configuration.
- Keyboard
Layout string - The keyboard layout (defaults to
en-us). - Kvm
Arguments string - Arbitrary arguments passed to kvm.
- Mac
Addresses []string - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- Machine string
- The VM machine type (defaults to
pc). - Memory
Vm
Legacy Memory Args - The memory configuration.
- Migrate bool
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - Name string
- The virtual machine name. Must be a valid DNS name.
- Network
Devices []VmLegacy Network Device Args - A network device (multiple blocks supported).
- Numas
[]Vm
Legacy Numa Args - The NUMA configuration.
- On
Boot bool - Specifies whether a VM will be started during system
boot. (defaults to
true) - Operating
System VmLegacy Operating System Args - The Operating System configuration.
- Pool
Id string - The identifier for a pool to assign the virtual machine to.
- Protection bool
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - Purge
On boolDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - Reboot bool
- Reboot the VM after initial creation (defaults to
false). - Reboot
After boolUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - Rngs
[]Vm
Legacy Rng Args - The random number generator configuration. Can only be set by
root@pam. - Scsi
Hardware string - The SCSI hardware type (defaults to
virtio-scsi-pci). - Serial
Devices []VmLegacy Serial Device Args - A serial device (multiple blocks supported).
- Smbios
Vm
Legacy Smbios Args - The SMBIOS (type1) settings for the VM.
- Started bool
- Whether to start the virtual machine (defaults
to
true). - Startup
Vm
Legacy Startup Args - Defines startup and shutdown behavior of the VM.
- Stop
On boolDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - Tablet
Device bool - Whether to enable the USB tablet device (defaults
to
true). - []string
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - Template bool
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - Timeout
Clone int - Timeout for cloning a VM in seconds (defaults to 1800).
- Timeout
Create int - Timeout for creating a VM in seconds (defaults to 1800).
- Timeout
Migrate int - Timeout for migrating the VM (defaults to 1800).
- Timeout
Move intDisk - Disk move timeout
- Timeout
Reboot int - Timeout for rebooting a VM in seconds (defaults to 1800).
- Timeout
Shutdown intVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- Timeout
Start intVm - Timeout for starting a VM in seconds (defaults to 1800).
- Timeout
Stop intVm - Timeout for stopping a VM in seconds (defaults to 300).
- Tpm
State VmLegacy Tpm State Args - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - Usbs
[]Vm
Legacy Usb Args - A host USB device mapping (multiple blocks supported).
- Vga
Vm
Legacy Vga Args - The VGA configuration.
- Virtiofs
[]Vm
Legacy Virtiof Args - Virtiofs share
- Vm
Id int - The VM identifier.
- Watchdog
Vm
Legacy Watchdog Args - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- node
Name String - The name of the node to assign the virtual machine to.
- acpi Boolean
- Whether to enable ACPI (defaults to
true). - agent
Vm
Legacy Agent - The QEMU agent configuration.
- amd
Sev VmLegacy Amd Sev - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio
Device VmLegacy Audio Device - An audio device.
- bios String
- The BIOS implementation (defaults to
seabios). - boot
Orders List<String> - Specify a list of devices to boot from in the order they appear in the list.
- cdrom
Vm
Legacy Cdrom - The CD-ROM configuration.
- clone_
Vm
Legacy Clone - The cloning configuration.
- cpu
Vm
Legacy Cpu - The CPU configuration.
- delete
Unreferenced BooleanDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description String
- The description.
- disks
List<Vm
Legacy Disk> - A disk (multiple blocks supported).
- efi
Disk VmLegacy Efi Disk - The efi disk device (required if
biosis set toovmf) - hook
Script StringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis
List<Vm
Legacy Hostpci> - A host PCI device mapping (multiple blocks supported).
- hotplug String
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization
Vm
Legacy Initialization - The cloud-init configuration.
- keyboard
Layout String - The keyboard layout (defaults to
en-us). - kvm
Arguments String - Arbitrary arguments passed to kvm.
- mac
Addresses List<String> - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine String
- The VM machine type (defaults to
pc). - memory
Vm
Legacy Memory - The memory configuration.
- migrate Boolean
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name String
- The virtual machine name. Must be a valid DNS name.
- network
Devices List<VmLegacy Network Device> - A network device (multiple blocks supported).
- numas
List<Vm
Legacy Numa> - The NUMA configuration.
- on
Boot Boolean - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating
System VmLegacy Operating System - The Operating System configuration.
- pool
Id String - The identifier for a pool to assign the virtual machine to.
- protection Boolean
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge
On BooleanDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot Boolean
- Reboot the VM after initial creation (defaults to
false). - reboot
After BooleanUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs
List<Vm
Legacy Rng> - The random number generator configuration. Can only be set by
root@pam. - scsi
Hardware String - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial
Devices List<VmLegacy Serial Device> - A serial device (multiple blocks supported).
- smbios
Vm
Legacy Smbios - The SMBIOS (type1) settings for the VM.
- started Boolean
- Whether to start the virtual machine (defaults
to
true). - startup
Vm
Legacy Startup - Defines startup and shutdown behavior of the VM.
- stop
On BooleanDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet
Device Boolean - Whether to enable the USB tablet device (defaults
to
true). - List<String>
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template Boolean
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout
Clone Integer - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout
Create Integer - Timeout for creating a VM in seconds (defaults to 1800).
- timeout
Migrate Integer - Timeout for migrating the VM (defaults to 1800).
- timeout
Move IntegerDisk - Disk move timeout
- timeout
Reboot Integer - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout
Shutdown IntegerVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout
Start IntegerVm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout
Stop IntegerVm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm
State VmLegacy Tpm State - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs
List<Vm
Legacy Usb> - A host USB device mapping (multiple blocks supported).
- vga
Vm
Legacy Vga - The VGA configuration.
- virtiofs
List<Vm
Legacy Virtiof> - Virtiofs share
- vm
Id Integer - The VM identifier.
- watchdog
Vm
Legacy Watchdog - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- node
Name string - The name of the node to assign the virtual machine to.
- acpi boolean
- Whether to enable ACPI (defaults to
true). - agent
Vm
Legacy Agent - The QEMU agent configuration.
- amd
Sev VmLegacy Amd Sev - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio
Device VmLegacy Audio Device - An audio device.
- bios string
- The BIOS implementation (defaults to
seabios). - boot
Orders string[] - Specify a list of devices to boot from in the order they appear in the list.
- cdrom
Vm
Legacy Cdrom - The CD-ROM configuration.
- clone
Vm
Legacy Clone - The cloning configuration.
- cpu
Vm
Legacy Cpu - The CPU configuration.
- delete
Unreferenced booleanDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description string
- The description.
- disks
Vm
Legacy Disk[] - A disk (multiple blocks supported).
- efi
Disk VmLegacy Efi Disk - The efi disk device (required if
biosis set toovmf) - hook
Script stringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis
Vm
Legacy Hostpci[] - A host PCI device mapping (multiple blocks supported).
- hotplug string
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization
Vm
Legacy Initialization - The cloud-init configuration.
- keyboard
Layout string - The keyboard layout (defaults to
en-us). - kvm
Arguments string - Arbitrary arguments passed to kvm.
- mac
Addresses string[] - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine string
- The VM machine type (defaults to
pc). - memory
Vm
Legacy Memory - The memory configuration.
- migrate boolean
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name string
- The virtual machine name. Must be a valid DNS name.
- network
Devices VmLegacy Network Device[] - A network device (multiple blocks supported).
- numas
Vm
Legacy Numa[] - The NUMA configuration.
- on
Boot boolean - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating
System VmLegacy Operating System - The Operating System configuration.
- pool
Id string - The identifier for a pool to assign the virtual machine to.
- protection boolean
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge
On booleanDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot boolean
- Reboot the VM after initial creation (defaults to
false). - reboot
After booleanUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs
Vm
Legacy Rng[] - The random number generator configuration. Can only be set by
root@pam. - scsi
Hardware string - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial
Devices VmLegacy Serial Device[] - A serial device (multiple blocks supported).
- smbios
Vm
Legacy Smbios - The SMBIOS (type1) settings for the VM.
- started boolean
- Whether to start the virtual machine (defaults
to
true). - startup
Vm
Legacy Startup - Defines startup and shutdown behavior of the VM.
- stop
On booleanDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet
Device boolean - Whether to enable the USB tablet device (defaults
to
true). - string[]
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template boolean
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout
Clone number - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout
Create number - Timeout for creating a VM in seconds (defaults to 1800).
- timeout
Migrate number - Timeout for migrating the VM (defaults to 1800).
- timeout
Move numberDisk - Disk move timeout
- timeout
Reboot number - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout
Shutdown numberVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout
Start numberVm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout
Stop numberVm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm
State VmLegacy Tpm State - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs
Vm
Legacy Usb[] - A host USB device mapping (multiple blocks supported).
- vga
Vm
Legacy Vga - The VGA configuration.
- virtiofs
Vm
Legacy Virtiof[] - Virtiofs share
- vm
Id number - The VM identifier.
- watchdog
Vm
Legacy Watchdog - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- node_
name str - The name of the node to assign the virtual machine to.
- acpi bool
- Whether to enable ACPI (defaults to
true). - agent
Vm
Legacy Agent Args - The QEMU agent configuration.
- amd_
sev VmLegacy Amd Sev Args - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio_
device VmLegacy Audio Device Args - An audio device.
- bios str
- The BIOS implementation (defaults to
seabios). - boot_
orders Sequence[str] - Specify a list of devices to boot from in the order they appear in the list.
- cdrom
Vm
Legacy Cdrom Args - The CD-ROM configuration.
- clone
Vm
Legacy Clone Args - The cloning configuration.
- cpu
Vm
Legacy Cpu Args - The CPU configuration.
- delete_
unreferenced_ booldisks_ on_ destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description str
- The description.
- disks
Sequence[Vm
Legacy Disk Args] - A disk (multiple blocks supported).
- efi_
disk VmLegacy Efi Disk Args - The efi disk device (required if
biosis set toovmf) - hook_
script_ strfile_ id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis
Sequence[Vm
Legacy Hostpci Args] - A host PCI device mapping (multiple blocks supported).
- hotplug str
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization
Vm
Legacy Initialization Args - The cloud-init configuration.
- keyboard_
layout str - The keyboard layout (defaults to
en-us). - kvm_
arguments str - Arbitrary arguments passed to kvm.
- mac_
addresses Sequence[str] - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine str
- The VM machine type (defaults to
pc). - memory
Vm
Legacy Memory Args - The memory configuration.
- migrate bool
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name str
- The virtual machine name. Must be a valid DNS name.
- network_
devices Sequence[VmLegacy Network Device Args] - A network device (multiple blocks supported).
- numas
Sequence[Vm
Legacy Numa Args] - The NUMA configuration.
- on_
boot bool - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating_
system VmLegacy Operating System Args - The Operating System configuration.
- pool_
id str - The identifier for a pool to assign the virtual machine to.
- protection bool
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge_
on_ booldestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot bool
- Reboot the VM after initial creation (defaults to
false). - reboot_
after_ boolupdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs
Sequence[Vm
Legacy Rng Args] - The random number generator configuration. Can only be set by
root@pam. - scsi_
hardware str - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial_
devices Sequence[VmLegacy Serial Device Args] - A serial device (multiple blocks supported).
- smbios
Vm
Legacy Smbios Args - The SMBIOS (type1) settings for the VM.
- started bool
- Whether to start the virtual machine (defaults
to
true). - startup
Vm
Legacy Startup Args - Defines startup and shutdown behavior of the VM.
- stop_
on_ booldestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet_
device bool - Whether to enable the USB tablet device (defaults
to
true). - Sequence[str]
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template bool
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout_
clone int - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout_
create int - Timeout for creating a VM in seconds (defaults to 1800).
- timeout_
migrate int - Timeout for migrating the VM (defaults to 1800).
- timeout_
move_ intdisk - Disk move timeout
- timeout_
reboot int - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout_
shutdown_ intvm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout_
start_ intvm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout_
stop_ intvm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm_
state VmLegacy Tpm State Args - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs
Sequence[Vm
Legacy Usb Args] - A host USB device mapping (multiple blocks supported).
- vga
Vm
Legacy Vga Args - The VGA configuration.
- virtiofs
Sequence[Vm
Legacy Virtiof Args] - Virtiofs share
- vm_
id int - The VM identifier.
- watchdog
Vm
Legacy Watchdog Args - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- node
Name String - The name of the node to assign the virtual machine to.
- acpi Boolean
- Whether to enable ACPI (defaults to
true). - agent Property Map
- The QEMU agent configuration.
- amd
Sev Property Map - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio
Device Property Map - An audio device.
- bios String
- The BIOS implementation (defaults to
seabios). - boot
Orders List<String> - Specify a list of devices to boot from in the order they appear in the list.
- cdrom Property Map
- The CD-ROM configuration.
- clone Property Map
- The cloning configuration.
- cpu Property Map
- The CPU configuration.
- delete
Unreferenced BooleanDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description String
- The description.
- disks List<Property Map>
- A disk (multiple blocks supported).
- efi
Disk Property Map - The efi disk device (required if
biosis set toovmf) - hook
Script StringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis List<Property Map>
- A host PCI device mapping (multiple blocks supported).
- hotplug String
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization Property Map
- The cloud-init configuration.
- keyboard
Layout String - The keyboard layout (defaults to
en-us). - kvm
Arguments String - Arbitrary arguments passed to kvm.
- mac
Addresses List<String> - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine String
- The VM machine type (defaults to
pc). - memory Property Map
- The memory configuration.
- migrate Boolean
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name String
- The virtual machine name. Must be a valid DNS name.
- network
Devices List<Property Map> - A network device (multiple blocks supported).
- numas List<Property Map>
- The NUMA configuration.
- on
Boot Boolean - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating
System Property Map - The Operating System configuration.
- pool
Id String - The identifier for a pool to assign the virtual machine to.
- protection Boolean
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge
On BooleanDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot Boolean
- Reboot the VM after initial creation (defaults to
false). - reboot
After BooleanUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs List<Property Map>
- The random number generator configuration. Can only be set by
root@pam. - scsi
Hardware String - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial
Devices List<Property Map> - A serial device (multiple blocks supported).
- smbios Property Map
- The SMBIOS (type1) settings for the VM.
- started Boolean
- Whether to start the virtual machine (defaults
to
true). - startup Property Map
- Defines startup and shutdown behavior of the VM.
- stop
On BooleanDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet
Device Boolean - Whether to enable the USB tablet device (defaults
to
true). - List<String>
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template Boolean
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout
Clone Number - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout
Create Number - Timeout for creating a VM in seconds (defaults to 1800).
- timeout
Migrate Number - Timeout for migrating the VM (defaults to 1800).
- timeout
Move NumberDisk - Disk move timeout
- timeout
Reboot Number - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout
Shutdown NumberVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout
Start NumberVm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout
Stop NumberVm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm
State Property Map - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs List<Property Map>
- A host USB device mapping (multiple blocks supported).
- vga Property Map
- The VGA configuration.
- virtiofs List<Property Map>
- Virtiofs share
- vm
Id Number - The VM identifier.
- watchdog Property Map
- The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
Outputs
All input properties are implicitly available as output properties. Additionally, the VmLegacy resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Ipv4Addresses
List<Immutable
Array<string>> - The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Ipv6Addresses
List<Immutable
Array<string>> - The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Network
Interface List<string>Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse)
- Id string
- The provider-assigned unique ID for this managed resource.
- Ipv4Addresses [][]string
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Ipv6Addresses [][]string
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Network
Interface []stringNames - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse)
- id String
- The provider-assigned unique ID for this managed resource.
- ipv4Addresses List<List<String>>
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6Addresses List<List<String>>
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - network
Interface List<String>Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse)
- id string
- The provider-assigned unique ID for this managed resource.
- ipv4Addresses string[][]
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6Addresses string[][]
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - network
Interface string[]Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse)
- id str
- The provider-assigned unique ID for this managed resource.
- ipv4_
addresses Sequence[Sequence[str]] - The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6_
addresses Sequence[Sequence[str]] - The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - network_
interface_ Sequence[str]names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse)
- id String
- The provider-assigned unique ID for this managed resource.
- ipv4Addresses List<List<String>>
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6Addresses List<List<String>>
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - network
Interface List<String>Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse)
Look up Existing VmLegacy Resource
Get an existing VmLegacy 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?: VmLegacyState, opts?: CustomResourceOptions): VmLegacy@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
acpi: Optional[bool] = None,
agent: Optional[VmLegacyAgentArgs] = None,
amd_sev: Optional[VmLegacyAmdSevArgs] = None,
audio_device: Optional[VmLegacyAudioDeviceArgs] = None,
bios: Optional[str] = None,
boot_orders: Optional[Sequence[str]] = None,
cdrom: Optional[VmLegacyCdromArgs] = None,
clone: Optional[VmLegacyCloneArgs] = None,
cpu: Optional[VmLegacyCpuArgs] = None,
delete_unreferenced_disks_on_destroy: Optional[bool] = None,
description: Optional[str] = None,
disks: Optional[Sequence[VmLegacyDiskArgs]] = None,
efi_disk: Optional[VmLegacyEfiDiskArgs] = None,
hook_script_file_id: Optional[str] = None,
hostpcis: Optional[Sequence[VmLegacyHostpciArgs]] = None,
hotplug: Optional[str] = None,
initialization: Optional[VmLegacyInitializationArgs] = None,
ipv4_addresses: Optional[Sequence[Sequence[str]]] = None,
ipv6_addresses: Optional[Sequence[Sequence[str]]] = None,
keyboard_layout: Optional[str] = None,
kvm_arguments: Optional[str] = None,
mac_addresses: Optional[Sequence[str]] = None,
machine: Optional[str] = None,
memory: Optional[VmLegacyMemoryArgs] = None,
migrate: Optional[bool] = None,
name: Optional[str] = None,
network_devices: Optional[Sequence[VmLegacyNetworkDeviceArgs]] = None,
network_interface_names: Optional[Sequence[str]] = None,
node_name: Optional[str] = None,
numas: Optional[Sequence[VmLegacyNumaArgs]] = None,
on_boot: Optional[bool] = None,
operating_system: Optional[VmLegacyOperatingSystemArgs] = None,
pool_id: Optional[str] = None,
protection: Optional[bool] = None,
purge_on_destroy: Optional[bool] = None,
reboot: Optional[bool] = None,
reboot_after_update: Optional[bool] = None,
rngs: Optional[Sequence[VmLegacyRngArgs]] = None,
scsi_hardware: Optional[str] = None,
serial_devices: Optional[Sequence[VmLegacySerialDeviceArgs]] = None,
smbios: Optional[VmLegacySmbiosArgs] = None,
started: Optional[bool] = None,
startup: Optional[VmLegacyStartupArgs] = None,
stop_on_destroy: Optional[bool] = None,
tablet_device: Optional[bool] = None,
tags: Optional[Sequence[str]] = None,
template: Optional[bool] = None,
timeout_clone: Optional[int] = None,
timeout_create: Optional[int] = None,
timeout_migrate: Optional[int] = None,
timeout_move_disk: Optional[int] = None,
timeout_reboot: Optional[int] = None,
timeout_shutdown_vm: Optional[int] = None,
timeout_start_vm: Optional[int] = None,
timeout_stop_vm: Optional[int] = None,
tpm_state: Optional[VmLegacyTpmStateArgs] = None,
usbs: Optional[Sequence[VmLegacyUsbArgs]] = None,
vga: Optional[VmLegacyVgaArgs] = None,
virtiofs: Optional[Sequence[VmLegacyVirtiofArgs]] = None,
vm_id: Optional[int] = None,
watchdog: Optional[VmLegacyWatchdogArgs] = None) -> VmLegacyfunc GetVmLegacy(ctx *Context, name string, id IDInput, state *VmLegacyState, opts ...ResourceOption) (*VmLegacy, error)public static VmLegacy Get(string name, Input<string> id, VmLegacyState? state, CustomResourceOptions? opts = null)public static VmLegacy get(String name, Output<String> id, VmLegacyState state, CustomResourceOptions options)resources: _: type: proxmoxve:VmLegacy 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.
- Acpi bool
- Whether to enable ACPI (defaults to
true). - Agent
Pulumi.
Proxmox VE. Inputs. Vm Legacy Agent - The QEMU agent configuration.
- Amd
Sev Pulumi.Proxmox VE. Inputs. Vm Legacy Amd Sev - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- Audio
Device Pulumi.Proxmox VE. Inputs. Vm Legacy Audio Device - An audio device.
- Bios string
- The BIOS implementation (defaults to
seabios). - Boot
Orders List<string> - Specify a list of devices to boot from in the order they appear in the list.
- Cdrom
Pulumi.
Proxmox VE. Inputs. Vm Legacy Cdrom - The CD-ROM configuration.
- Clone
Pulumi.
Proxmox VE. Inputs. Vm Legacy Clone - The cloning configuration.
- Cpu
Pulumi.
Proxmox VE. Inputs. Vm Legacy Cpu - The CPU configuration.
- Delete
Unreferenced boolDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - Description string
- The description.
- Disks
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Disk> - A disk (multiple blocks supported).
- Efi
Disk Pulumi.Proxmox VE. Inputs. Vm Legacy Efi Disk - The efi disk device (required if
biosis set toovmf) - Hook
Script stringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - Hostpcis
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Hostpci> - A host PCI device mapping (multiple blocks supported).
- Hotplug string
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - Initialization
Pulumi.
Proxmox VE. Inputs. Vm Legacy Initialization - The cloud-init configuration.
- Ipv4Addresses
List<Immutable
Array<string>> - The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Ipv6Addresses
List<Immutable
Array<string>> - The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Keyboard
Layout string - The keyboard layout (defaults to
en-us). - Kvm
Arguments string - Arbitrary arguments passed to kvm.
- Mac
Addresses List<string> - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- Machine string
- The VM machine type (defaults to
pc). - Memory
Pulumi.
Proxmox VE. Inputs. Vm Legacy Memory - The memory configuration.
- Migrate bool
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - Name string
- The virtual machine name. Must be a valid DNS name.
- Network
Devices List<Pulumi.Proxmox VE. Inputs. Vm Legacy Network Device> - A network device (multiple blocks supported).
- Network
Interface List<string>Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse) - Node
Name string - The name of the node to assign the virtual machine to.
- Numas
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Numa> - The NUMA configuration.
- On
Boot bool - Specifies whether a VM will be started during system
boot. (defaults to
true) - Operating
System Pulumi.Proxmox VE. Inputs. Vm Legacy Operating System - The Operating System configuration.
- Pool
Id string - The identifier for a pool to assign the virtual machine to.
- Protection bool
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - Purge
On boolDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - Reboot bool
- Reboot the VM after initial creation (defaults to
false). - Reboot
After boolUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - Rngs
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Rng> - The random number generator configuration. Can only be set by
root@pam. - Scsi
Hardware string - The SCSI hardware type (defaults to
virtio-scsi-pci). - Serial
Devices List<Pulumi.Proxmox VE. Inputs. Vm Legacy Serial Device> - A serial device (multiple blocks supported).
- Smbios
Pulumi.
Proxmox VE. Inputs. Vm Legacy Smbios - The SMBIOS (type1) settings for the VM.
- Started bool
- Whether to start the virtual machine (defaults
to
true). - Startup
Pulumi.
Proxmox VE. Inputs. Vm Legacy Startup - Defines startup and shutdown behavior of the VM.
- Stop
On boolDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - Tablet
Device bool - Whether to enable the USB tablet device (defaults
to
true). - List<string>
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - Template bool
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - Timeout
Clone int - Timeout for cloning a VM in seconds (defaults to 1800).
- Timeout
Create int - Timeout for creating a VM in seconds (defaults to 1800).
- Timeout
Migrate int - Timeout for migrating the VM (defaults to 1800).
- Timeout
Move intDisk - Disk move timeout
- Timeout
Reboot int - Timeout for rebooting a VM in seconds (defaults to 1800).
- Timeout
Shutdown intVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- Timeout
Start intVm - Timeout for starting a VM in seconds (defaults to 1800).
- Timeout
Stop intVm - Timeout for stopping a VM in seconds (defaults to 300).
- Tpm
State Pulumi.Proxmox VE. Inputs. Vm Legacy Tpm State - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - Usbs
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Usb> - A host USB device mapping (multiple blocks supported).
- Vga
Pulumi.
Proxmox VE. Inputs. Vm Legacy Vga - The VGA configuration.
- Virtiofs
List<Pulumi.
Proxmox VE. Inputs. Vm Legacy Virtiof> - Virtiofs share
- Vm
Id int - The VM identifier.
- Watchdog
Pulumi.
Proxmox VE. Inputs. Vm Legacy Watchdog - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- Acpi bool
- Whether to enable ACPI (defaults to
true). - Agent
Vm
Legacy Agent Args - The QEMU agent configuration.
- Amd
Sev VmLegacy Amd Sev Args - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- Audio
Device VmLegacy Audio Device Args - An audio device.
- Bios string
- The BIOS implementation (defaults to
seabios). - Boot
Orders []string - Specify a list of devices to boot from in the order they appear in the list.
- Cdrom
Vm
Legacy Cdrom Args - The CD-ROM configuration.
- Clone
Vm
Legacy Clone Args - The cloning configuration.
- Cpu
Vm
Legacy Cpu Args - The CPU configuration.
- Delete
Unreferenced boolDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - Description string
- The description.
- Disks
[]Vm
Legacy Disk Args - A disk (multiple blocks supported).
- Efi
Disk VmLegacy Efi Disk Args - The efi disk device (required if
biosis set toovmf) - Hook
Script stringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - Hostpcis
[]Vm
Legacy Hostpci Args - A host PCI device mapping (multiple blocks supported).
- Hotplug string
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - Initialization
Vm
Legacy Initialization Args - The cloud-init configuration.
- Ipv4Addresses [][]string
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Ipv6Addresses [][]string
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - Keyboard
Layout string - The keyboard layout (defaults to
en-us). - Kvm
Arguments string - Arbitrary arguments passed to kvm.
- Mac
Addresses []string - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- Machine string
- The VM machine type (defaults to
pc). - Memory
Vm
Legacy Memory Args - The memory configuration.
- Migrate bool
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - Name string
- The virtual machine name. Must be a valid DNS name.
- Network
Devices []VmLegacy Network Device Args - A network device (multiple blocks supported).
- Network
Interface []stringNames - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse) - Node
Name string - The name of the node to assign the virtual machine to.
- Numas
[]Vm
Legacy Numa Args - The NUMA configuration.
- On
Boot bool - Specifies whether a VM will be started during system
boot. (defaults to
true) - Operating
System VmLegacy Operating System Args - The Operating System configuration.
- Pool
Id string - The identifier for a pool to assign the virtual machine to.
- Protection bool
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - Purge
On boolDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - Reboot bool
- Reboot the VM after initial creation (defaults to
false). - Reboot
After boolUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - Rngs
[]Vm
Legacy Rng Args - The random number generator configuration. Can only be set by
root@pam. - Scsi
Hardware string - The SCSI hardware type (defaults to
virtio-scsi-pci). - Serial
Devices []VmLegacy Serial Device Args - A serial device (multiple blocks supported).
- Smbios
Vm
Legacy Smbios Args - The SMBIOS (type1) settings for the VM.
- Started bool
- Whether to start the virtual machine (defaults
to
true). - Startup
Vm
Legacy Startup Args - Defines startup and shutdown behavior of the VM.
- Stop
On boolDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - Tablet
Device bool - Whether to enable the USB tablet device (defaults
to
true). - []string
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - Template bool
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - Timeout
Clone int - Timeout for cloning a VM in seconds (defaults to 1800).
- Timeout
Create int - Timeout for creating a VM in seconds (defaults to 1800).
- Timeout
Migrate int - Timeout for migrating the VM (defaults to 1800).
- Timeout
Move intDisk - Disk move timeout
- Timeout
Reboot int - Timeout for rebooting a VM in seconds (defaults to 1800).
- Timeout
Shutdown intVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- Timeout
Start intVm - Timeout for starting a VM in seconds (defaults to 1800).
- Timeout
Stop intVm - Timeout for stopping a VM in seconds (defaults to 300).
- Tpm
State VmLegacy Tpm State Args - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - Usbs
[]Vm
Legacy Usb Args - A host USB device mapping (multiple blocks supported).
- Vga
Vm
Legacy Vga Args - The VGA configuration.
- Virtiofs
[]Vm
Legacy Virtiof Args - Virtiofs share
- Vm
Id int - The VM identifier.
- Watchdog
Vm
Legacy Watchdog Args - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- acpi Boolean
- Whether to enable ACPI (defaults to
true). - agent
Vm
Legacy Agent - The QEMU agent configuration.
- amd
Sev VmLegacy Amd Sev - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio
Device VmLegacy Audio Device - An audio device.
- bios String
- The BIOS implementation (defaults to
seabios). - boot
Orders List<String> - Specify a list of devices to boot from in the order they appear in the list.
- cdrom
Vm
Legacy Cdrom - The CD-ROM configuration.
- clone_
Vm
Legacy Clone - The cloning configuration.
- cpu
Vm
Legacy Cpu - The CPU configuration.
- delete
Unreferenced BooleanDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description String
- The description.
- disks
List<Vm
Legacy Disk> - A disk (multiple blocks supported).
- efi
Disk VmLegacy Efi Disk - The efi disk device (required if
biosis set toovmf) - hook
Script StringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis
List<Vm
Legacy Hostpci> - A host PCI device mapping (multiple blocks supported).
- hotplug String
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization
Vm
Legacy Initialization - The cloud-init configuration.
- ipv4Addresses List<List<String>>
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6Addresses List<List<String>>
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - keyboard
Layout String - The keyboard layout (defaults to
en-us). - kvm
Arguments String - Arbitrary arguments passed to kvm.
- mac
Addresses List<String> - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine String
- The VM machine type (defaults to
pc). - memory
Vm
Legacy Memory - The memory configuration.
- migrate Boolean
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name String
- The virtual machine name. Must be a valid DNS name.
- network
Devices List<VmLegacy Network Device> - A network device (multiple blocks supported).
- network
Interface List<String>Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse) - node
Name String - The name of the node to assign the virtual machine to.
- numas
List<Vm
Legacy Numa> - The NUMA configuration.
- on
Boot Boolean - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating
System VmLegacy Operating System - The Operating System configuration.
- pool
Id String - The identifier for a pool to assign the virtual machine to.
- protection Boolean
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge
On BooleanDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot Boolean
- Reboot the VM after initial creation (defaults to
false). - reboot
After BooleanUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs
List<Vm
Legacy Rng> - The random number generator configuration. Can only be set by
root@pam. - scsi
Hardware String - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial
Devices List<VmLegacy Serial Device> - A serial device (multiple blocks supported).
- smbios
Vm
Legacy Smbios - The SMBIOS (type1) settings for the VM.
- started Boolean
- Whether to start the virtual machine (defaults
to
true). - startup
Vm
Legacy Startup - Defines startup and shutdown behavior of the VM.
- stop
On BooleanDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet
Device Boolean - Whether to enable the USB tablet device (defaults
to
true). - List<String>
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template Boolean
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout
Clone Integer - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout
Create Integer - Timeout for creating a VM in seconds (defaults to 1800).
- timeout
Migrate Integer - Timeout for migrating the VM (defaults to 1800).
- timeout
Move IntegerDisk - Disk move timeout
- timeout
Reboot Integer - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout
Shutdown IntegerVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout
Start IntegerVm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout
Stop IntegerVm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm
State VmLegacy Tpm State - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs
List<Vm
Legacy Usb> - A host USB device mapping (multiple blocks supported).
- vga
Vm
Legacy Vga - The VGA configuration.
- virtiofs
List<Vm
Legacy Virtiof> - Virtiofs share
- vm
Id Integer - The VM identifier.
- watchdog
Vm
Legacy Watchdog - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- acpi boolean
- Whether to enable ACPI (defaults to
true). - agent
Vm
Legacy Agent - The QEMU agent configuration.
- amd
Sev VmLegacy Amd Sev - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio
Device VmLegacy Audio Device - An audio device.
- bios string
- The BIOS implementation (defaults to
seabios). - boot
Orders string[] - Specify a list of devices to boot from in the order they appear in the list.
- cdrom
Vm
Legacy Cdrom - The CD-ROM configuration.
- clone
Vm
Legacy Clone - The cloning configuration.
- cpu
Vm
Legacy Cpu - The CPU configuration.
- delete
Unreferenced booleanDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description string
- The description.
- disks
Vm
Legacy Disk[] - A disk (multiple blocks supported).
- efi
Disk VmLegacy Efi Disk - The efi disk device (required if
biosis set toovmf) - hook
Script stringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis
Vm
Legacy Hostpci[] - A host PCI device mapping (multiple blocks supported).
- hotplug string
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization
Vm
Legacy Initialization - The cloud-init configuration.
- ipv4Addresses string[][]
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6Addresses string[][]
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - keyboard
Layout string - The keyboard layout (defaults to
en-us). - kvm
Arguments string - Arbitrary arguments passed to kvm.
- mac
Addresses string[] - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine string
- The VM machine type (defaults to
pc). - memory
Vm
Legacy Memory - The memory configuration.
- migrate boolean
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name string
- The virtual machine name. Must be a valid DNS name.
- network
Devices VmLegacy Network Device[] - A network device (multiple blocks supported).
- network
Interface string[]Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse) - node
Name string - The name of the node to assign the virtual machine to.
- numas
Vm
Legacy Numa[] - The NUMA configuration.
- on
Boot boolean - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating
System VmLegacy Operating System - The Operating System configuration.
- pool
Id string - The identifier for a pool to assign the virtual machine to.
- protection boolean
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge
On booleanDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot boolean
- Reboot the VM after initial creation (defaults to
false). - reboot
After booleanUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs
Vm
Legacy Rng[] - The random number generator configuration. Can only be set by
root@pam. - scsi
Hardware string - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial
Devices VmLegacy Serial Device[] - A serial device (multiple blocks supported).
- smbios
Vm
Legacy Smbios - The SMBIOS (type1) settings for the VM.
- started boolean
- Whether to start the virtual machine (defaults
to
true). - startup
Vm
Legacy Startup - Defines startup and shutdown behavior of the VM.
- stop
On booleanDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet
Device boolean - Whether to enable the USB tablet device (defaults
to
true). - string[]
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template boolean
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout
Clone number - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout
Create number - Timeout for creating a VM in seconds (defaults to 1800).
- timeout
Migrate number - Timeout for migrating the VM (defaults to 1800).
- timeout
Move numberDisk - Disk move timeout
- timeout
Reboot number - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout
Shutdown numberVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout
Start numberVm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout
Stop numberVm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm
State VmLegacy Tpm State - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs
Vm
Legacy Usb[] - A host USB device mapping (multiple blocks supported).
- vga
Vm
Legacy Vga - The VGA configuration.
- virtiofs
Vm
Legacy Virtiof[] - Virtiofs share
- vm
Id number - The VM identifier.
- watchdog
Vm
Legacy Watchdog - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- acpi bool
- Whether to enable ACPI (defaults to
true). - agent
Vm
Legacy Agent Args - The QEMU agent configuration.
- amd_
sev VmLegacy Amd Sev Args - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio_
device VmLegacy Audio Device Args - An audio device.
- bios str
- The BIOS implementation (defaults to
seabios). - boot_
orders Sequence[str] - Specify a list of devices to boot from in the order they appear in the list.
- cdrom
Vm
Legacy Cdrom Args - The CD-ROM configuration.
- clone
Vm
Legacy Clone Args - The cloning configuration.
- cpu
Vm
Legacy Cpu Args - The CPU configuration.
- delete_
unreferenced_ booldisks_ on_ destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description str
- The description.
- disks
Sequence[Vm
Legacy Disk Args] - A disk (multiple blocks supported).
- efi_
disk VmLegacy Efi Disk Args - The efi disk device (required if
biosis set toovmf) - hook_
script_ strfile_ id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis
Sequence[Vm
Legacy Hostpci Args] - A host PCI device mapping (multiple blocks supported).
- hotplug str
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization
Vm
Legacy Initialization Args - The cloud-init configuration.
- ipv4_
addresses Sequence[Sequence[str]] - The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6_
addresses Sequence[Sequence[str]] - The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - keyboard_
layout str - The keyboard layout (defaults to
en-us). - kvm_
arguments str - Arbitrary arguments passed to kvm.
- mac_
addresses Sequence[str] - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine str
- The VM machine type (defaults to
pc). - memory
Vm
Legacy Memory Args - The memory configuration.
- migrate bool
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name str
- The virtual machine name. Must be a valid DNS name.
- network_
devices Sequence[VmLegacy Network Device Args] - A network device (multiple blocks supported).
- network_
interface_ Sequence[str]names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse) - node_
name str - The name of the node to assign the virtual machine to.
- numas
Sequence[Vm
Legacy Numa Args] - The NUMA configuration.
- on_
boot bool - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating_
system VmLegacy Operating System Args - The Operating System configuration.
- pool_
id str - The identifier for a pool to assign the virtual machine to.
- protection bool
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge_
on_ booldestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot bool
- Reboot the VM after initial creation (defaults to
false). - reboot_
after_ boolupdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs
Sequence[Vm
Legacy Rng Args] - The random number generator configuration. Can only be set by
root@pam. - scsi_
hardware str - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial_
devices Sequence[VmLegacy Serial Device Args] - A serial device (multiple blocks supported).
- smbios
Vm
Legacy Smbios Args - The SMBIOS (type1) settings for the VM.
- started bool
- Whether to start the virtual machine (defaults
to
true). - startup
Vm
Legacy Startup Args - Defines startup and shutdown behavior of the VM.
- stop_
on_ booldestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet_
device bool - Whether to enable the USB tablet device (defaults
to
true). - Sequence[str]
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template bool
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout_
clone int - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout_
create int - Timeout for creating a VM in seconds (defaults to 1800).
- timeout_
migrate int - Timeout for migrating the VM (defaults to 1800).
- timeout_
move_ intdisk - Disk move timeout
- timeout_
reboot int - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout_
shutdown_ intvm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout_
start_ intvm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout_
stop_ intvm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm_
state VmLegacy Tpm State Args - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs
Sequence[Vm
Legacy Usb Args] - A host USB device mapping (multiple blocks supported).
- vga
Vm
Legacy Vga Args - The VGA configuration.
- virtiofs
Sequence[Vm
Legacy Virtiof Args] - Virtiofs share
- vm_
id int - The VM identifier.
- watchdog
Vm
Legacy Watchdog Args - The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
- acpi Boolean
- Whether to enable ACPI (defaults to
true). - agent Property Map
- The QEMU agent configuration.
- amd
Sev Property Map - Secure Encrypted Virtualization (SEV) features by AMD CPUs.
- audio
Device Property Map - An audio device.
- bios String
- The BIOS implementation (defaults to
seabios). - boot
Orders List<String> - Specify a list of devices to boot from in the order they appear in the list.
- cdrom Property Map
- The CD-ROM configuration.
- clone Property Map
- The cloning configuration.
- cpu Property Map
- The CPU configuration.
- delete
Unreferenced BooleanDisks On Destroy - Whether to delete unreferenced disks on destroy (defaults to
true) - description String
- The description.
- disks List<Property Map>
- A disk (multiple blocks supported).
- efi
Disk Property Map - The efi disk device (required if
biosis set toovmf) - hook
Script StringFile Id - The identifier for a file containing a hook script (needs to be executable, e.g. by using the
proxmox_virtual_environment_file.file_modeattribute). - hostpcis List<Property Map>
- A host PCI device mapping (multiple blocks supported).
- hotplug String
- Selectively enable hotplug features. Use
0to disable,1to enable all. Valid features:disk,network,usb,memory,cpu. Memory hotplug requires NUMA to be enabled. If not set, PVE defaults tonetwork,disk,usb. Whendiskis included in the hotplug list, disk resizes on a running VM are applied live without a reboot. Whendiskis excluded, the provider will reboot the VM after resize (controlled byrebootAfterUpdate). - initialization Property Map
- The cloud-init configuration.
- ipv4Addresses List<List<String>>
- The IPv4 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - ipv6Addresses List<List<String>>
- The IPv6 addresses per network interface published by the
QEMU agent (empty list when
agent.enabledisfalse) - keyboard
Layout String - The keyboard layout (defaults to
en-us). - kvm
Arguments String - Arbitrary arguments passed to kvm.
- mac
Addresses List<String> - The MAC addresses published by the QEMU agent with fallback to the network device configuration, if the agent is disabled
- machine String
- The VM machine type (defaults to
pc). - memory Property Map
- The memory configuration.
- migrate Boolean
- Migrate the VM on node change instead of re-creating
it (defaults to
false). - name String
- The virtual machine name. Must be a valid DNS name.
- network
Devices List<Property Map> - A network device (multiple blocks supported).
- network
Interface List<String>Names - The network interface names published by the QEMU
agent (empty list when
agent.enabledisfalse) - node
Name String - The name of the node to assign the virtual machine to.
- numas List<Property Map>
- The NUMA configuration.
- on
Boot Boolean - Specifies whether a VM will be started during system
boot. (defaults to
true) - operating
System Property Map - The Operating System configuration.
- pool
Id String - The identifier for a pool to assign the virtual machine to.
- protection Boolean
- Sets the protection flag of the VM. This will disable the remove VM and remove disk operations (defaults to
false). - purge
On BooleanDestroy - Whether to purge the VM from backup configurations on destroy (defaults to
true) - reboot Boolean
- Reboot the VM after initial creation (defaults to
false). - reboot
After BooleanUpdate - Whether the provider may automatically
reboot or power off the VM during update operations when required to apply
changes. If
false, updates that require taking the VM offline fail instead of being applied automatically. Changes that are applied successfully but still need a later manual reboot emit a warning instead (defaults totrue). - rngs List<Property Map>
- The random number generator configuration. Can only be set by
root@pam. - scsi
Hardware String - The SCSI hardware type (defaults to
virtio-scsi-pci). - serial
Devices List<Property Map> - A serial device (multiple blocks supported).
- smbios Property Map
- The SMBIOS (type1) settings for the VM.
- started Boolean
- Whether to start the virtual machine (defaults
to
true). - startup Property Map
- Defines startup and shutdown behavior of the VM.
- stop
On BooleanDestroy - Whether to stop rather than shutdown on VM destroy (defaults to
false) - tablet
Device Boolean - Whether to enable the USB tablet device (defaults
to
true). - List<String>
- A list of tags of the VM. This is only meta information (
defaults to
[]). Note: Proxmox always sorts the VM tags. If the list in template is not sorted, then Proxmox will always report a difference on the resource. You may use theignoreChangeslifecycle meta-argument to ignore changes to this attribute. - template Boolean
- Whether the VM should be a template. Setting this
from
falsetotrueconverts an existing VM to a template in place. Converting a template back to a regular VM is not supported (defaults tofalse). - timeout
Clone Number - Timeout for cloning a VM in seconds (defaults to 1800).
- timeout
Create Number - Timeout for creating a VM in seconds (defaults to 1800).
- timeout
Migrate Number - Timeout for migrating the VM (defaults to 1800).
- timeout
Move NumberDisk - Disk move timeout
- timeout
Reboot Number - Timeout for rebooting a VM in seconds (defaults to 1800).
- timeout
Shutdown NumberVm - Timeout for shutting down a VM in seconds ( defaults to 1800).
- timeout
Start NumberVm - Timeout for starting a VM in seconds (defaults to 1800).
- timeout
Stop NumberVm - Timeout for stopping a VM in seconds (defaults to 300).
- tpm
State Property Map - The TPM state device. The VM must be stopped before
adding, removing, or moving a TPM state device; the provider automatically
handles the shutdown/start cycle. Changing
versionrequires recreating the VM because Proxmox only supports setting the TPM version at creation time. - usbs List<Property Map>
- A host USB device mapping (multiple blocks supported).
- vga Property Map
- The VGA configuration.
- virtiofs List<Property Map>
- Virtiofs share
- vm
Id Number - The VM identifier.
- watchdog Property Map
- The watchdog configuration. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified).
Supporting Types
VmLegacyAgent, VmLegacyAgentArgs
- Enabled bool
- Whether to enable the QEMU agent (defaults
to
false). - Timeout string
- The maximum amount of time to wait for data from
the QEMU agent to become available ( defaults to
15m). - Trim bool
- Whether to enable the FSTRIM feature in the QEMU agent
(defaults to
false). - Type string
- The QEMU agent interface type (defaults to
virtio). - Wait
For Pulumi.Ip Proxmox VE. Inputs. Vm Legacy Agent Wait For Ip - Configuration for waiting for specific IP address types when the VM starts.
- Enabled bool
- Whether to enable the QEMU agent (defaults
to
false). - Timeout string
- The maximum amount of time to wait for data from
the QEMU agent to become available ( defaults to
15m). - Trim bool
- Whether to enable the FSTRIM feature in the QEMU agent
(defaults to
false). - Type string
- The QEMU agent interface type (defaults to
virtio). - Wait
For VmIp Legacy Agent Wait For Ip - Configuration for waiting for specific IP address types when the VM starts.
- enabled Boolean
- Whether to enable the QEMU agent (defaults
to
false). - timeout String
- The maximum amount of time to wait for data from
the QEMU agent to become available ( defaults to
15m). - trim Boolean
- Whether to enable the FSTRIM feature in the QEMU agent
(defaults to
false). - type String
- The QEMU agent interface type (defaults to
virtio). - wait
For VmIp Legacy Agent Wait For Ip - Configuration for waiting for specific IP address types when the VM starts.
- enabled boolean
- Whether to enable the QEMU agent (defaults
to
false). - timeout string
- The maximum amount of time to wait for data from
the QEMU agent to become available ( defaults to
15m). - trim boolean
- Whether to enable the FSTRIM feature in the QEMU agent
(defaults to
false). - type string
- The QEMU agent interface type (defaults to
virtio). - wait
For VmIp Legacy Agent Wait For Ip - Configuration for waiting for specific IP address types when the VM starts.
- enabled bool
- Whether to enable the QEMU agent (defaults
to
false). - timeout str
- The maximum amount of time to wait for data from
the QEMU agent to become available ( defaults to
15m). - trim bool
- Whether to enable the FSTRIM feature in the QEMU agent
(defaults to
false). - type str
- The QEMU agent interface type (defaults to
virtio). - wait_
for_ Vmip Legacy Agent Wait For Ip - Configuration for waiting for specific IP address types when the VM starts.
- enabled Boolean
- Whether to enable the QEMU agent (defaults
to
false). - timeout String
- The maximum amount of time to wait for data from
the QEMU agent to become available ( defaults to
15m). - trim Boolean
- Whether to enable the FSTRIM feature in the QEMU agent
(defaults to
false). - type String
- The QEMU agent interface type (defaults to
virtio). - wait
For Property MapIp - Configuration for waiting for specific IP address types when the VM starts.
VmLegacyAgentWaitForIp, VmLegacyAgentWaitForIpArgs
- Ipv4 bool
- Wait for at least one IPv4 address (non-loopback, non-link-local) (defaults to
false). - Ipv6 bool
Wait for at least one IPv6 address (non-loopback, non-link-local) (defaults to
false).When
waitForIpis not specified or bothipv4andipv6arefalse, the provider waits for any valid global unicast address (IPv4 or IPv6). In dual-stack networks where DHCPv6 responds faster, this may result in only IPv6 addresses being available. Setipv4 = trueto ensure IPv4 address availability.
- Ipv4 bool
- Wait for at least one IPv4 address (non-loopback, non-link-local) (defaults to
false). - Ipv6 bool
Wait for at least one IPv6 address (non-loopback, non-link-local) (defaults to
false).When
waitForIpis not specified or bothipv4andipv6arefalse, the provider waits for any valid global unicast address (IPv4 or IPv6). In dual-stack networks where DHCPv6 responds faster, this may result in only IPv6 addresses being available. Setipv4 = trueto ensure IPv4 address availability.
- ipv4 Boolean
- Wait for at least one IPv4 address (non-loopback, non-link-local) (defaults to
false). - ipv6 Boolean
Wait for at least one IPv6 address (non-loopback, non-link-local) (defaults to
false).When
waitForIpis not specified or bothipv4andipv6arefalse, the provider waits for any valid global unicast address (IPv4 or IPv6). In dual-stack networks where DHCPv6 responds faster, this may result in only IPv6 addresses being available. Setipv4 = trueto ensure IPv4 address availability.
- ipv4 boolean
- Wait for at least one IPv4 address (non-loopback, non-link-local) (defaults to
false). - ipv6 boolean
Wait for at least one IPv6 address (non-loopback, non-link-local) (defaults to
false).When
waitForIpis not specified or bothipv4andipv6arefalse, the provider waits for any valid global unicast address (IPv4 or IPv6). In dual-stack networks where DHCPv6 responds faster, this may result in only IPv6 addresses being available. Setipv4 = trueto ensure IPv4 address availability.
- ipv4 bool
- Wait for at least one IPv4 address (non-loopback, non-link-local) (defaults to
false). - ipv6 bool
Wait for at least one IPv6 address (non-loopback, non-link-local) (defaults to
false).When
waitForIpis not specified or bothipv4andipv6arefalse, the provider waits for any valid global unicast address (IPv4 or IPv6). In dual-stack networks where DHCPv6 responds faster, this may result in only IPv6 addresses being available. Setipv4 = trueto ensure IPv4 address availability.
- ipv4 Boolean
- Wait for at least one IPv4 address (non-loopback, non-link-local) (defaults to
false). - ipv6 Boolean
Wait for at least one IPv6 address (non-loopback, non-link-local) (defaults to
false).When
waitForIpis not specified or bothipv4andipv6arefalse, the provider waits for any valid global unicast address (IPv4 or IPv6). In dual-stack networks where DHCPv6 responds faster, this may result in only IPv6 addresses being available. Setipv4 = trueto ensure IPv4 address availability.
VmLegacyAmdSev, VmLegacyAmdSevArgs
- Allow
Smt bool - Sets policy bit to allow Simultaneous Multi Threading (SMT)
(Ignored unless for SEV-SNP) (defaults to
true). - Kernel
Hashes bool - Add kernel hashes to guest firmware for measured linux kernel launch (defaults to
false). - No
Debug bool - Sets policy bit to disallow debugging of guest (defaults
to
false). - No
Key boolSharing Sets policy bit to disallow key sharing with other guests (Ignored for SEV-SNP) (defaults to
false).The
amdSevsetting is only allowed for aroot@pamauthenticated user.- Type string
- Enable standard SEV with
stdor enable experimental SEV-ES with theesoption or enable experimental SEV-SNP with thesnpoption (defaults tostd).
- Allow
Smt bool - Sets policy bit to allow Simultaneous Multi Threading (SMT)
(Ignored unless for SEV-SNP) (defaults to
true). - Kernel
Hashes bool - Add kernel hashes to guest firmware for measured linux kernel launch (defaults to
false). - No
Debug bool - Sets policy bit to disallow debugging of guest (defaults
to
false). - No
Key boolSharing Sets policy bit to disallow key sharing with other guests (Ignored for SEV-SNP) (defaults to
false).The
amdSevsetting is only allowed for aroot@pamauthenticated user.- Type string
- Enable standard SEV with
stdor enable experimental SEV-ES with theesoption or enable experimental SEV-SNP with thesnpoption (defaults tostd).
- allow
Smt Boolean - Sets policy bit to allow Simultaneous Multi Threading (SMT)
(Ignored unless for SEV-SNP) (defaults to
true). - kernel
Hashes Boolean - Add kernel hashes to guest firmware for measured linux kernel launch (defaults to
false). - no
Debug Boolean - Sets policy bit to disallow debugging of guest (defaults
to
false). - no
Key BooleanSharing Sets policy bit to disallow key sharing with other guests (Ignored for SEV-SNP) (defaults to
false).The
amdSevsetting is only allowed for aroot@pamauthenticated user.- type String
- Enable standard SEV with
stdor enable experimental SEV-ES with theesoption or enable experimental SEV-SNP with thesnpoption (defaults tostd).
- allow
Smt boolean - Sets policy bit to allow Simultaneous Multi Threading (SMT)
(Ignored unless for SEV-SNP) (defaults to
true). - kernel
Hashes boolean - Add kernel hashes to guest firmware for measured linux kernel launch (defaults to
false). - no
Debug boolean - Sets policy bit to disallow debugging of guest (defaults
to
false). - no
Key booleanSharing Sets policy bit to disallow key sharing with other guests (Ignored for SEV-SNP) (defaults to
false).The
amdSevsetting is only allowed for aroot@pamauthenticated user.- type string
- Enable standard SEV with
stdor enable experimental SEV-ES with theesoption or enable experimental SEV-SNP with thesnpoption (defaults tostd).
- allow_
smt bool - Sets policy bit to allow Simultaneous Multi Threading (SMT)
(Ignored unless for SEV-SNP) (defaults to
true). - kernel_
hashes bool - Add kernel hashes to guest firmware for measured linux kernel launch (defaults to
false). - no_
debug bool - Sets policy bit to disallow debugging of guest (defaults
to
false). - no_
key_ boolsharing Sets policy bit to disallow key sharing with other guests (Ignored for SEV-SNP) (defaults to
false).The
amdSevsetting is only allowed for aroot@pamauthenticated user.- type str
- Enable standard SEV with
stdor enable experimental SEV-ES with theesoption or enable experimental SEV-SNP with thesnpoption (defaults tostd).
- allow
Smt Boolean - Sets policy bit to allow Simultaneous Multi Threading (SMT)
(Ignored unless for SEV-SNP) (defaults to
true). - kernel
Hashes Boolean - Add kernel hashes to guest firmware for measured linux kernel launch (defaults to
false). - no
Debug Boolean - Sets policy bit to disallow debugging of guest (defaults
to
false). - no
Key BooleanSharing Sets policy bit to disallow key sharing with other guests (Ignored for SEV-SNP) (defaults to
false).The
amdSevsetting is only allowed for aroot@pamauthenticated user.- type String
- Enable standard SEV with
stdor enable experimental SEV-ES with theesoption or enable experimental SEV-SNP with thesnpoption (defaults tostd).
VmLegacyAudioDevice, VmLegacyAudioDeviceArgs
VmLegacyCdrom, VmLegacyCdromArgs
- Enabled bool
- Whether to enable the CD-ROM drive (defaults
to
false). Deprecated. The attribute will be removed in the next version of the provider. SetfileIdtononeto leave the CD-ROM drive empty. - File
Id string - A file ID for an ISO file (defaults to
cdromas in the physical drive). Usenoneto leave the CD-ROM drive empty. - Interface string
- A hardware interface to connect CD-ROM drive to (defaults to
ide3). "Must be one ofideN,sataN,scsiN, where N is the index of the interface. " + "Note thatq35machine type only supportside0andide2of IDE interfaces.
- Enabled bool
- Whether to enable the CD-ROM drive (defaults
to
false). Deprecated. The attribute will be removed in the next version of the provider. SetfileIdtononeto leave the CD-ROM drive empty. - File
Id string - A file ID for an ISO file (defaults to
cdromas in the physical drive). Usenoneto leave the CD-ROM drive empty. - Interface string
- A hardware interface to connect CD-ROM drive to (defaults to
ide3). "Must be one ofideN,sataN,scsiN, where N is the index of the interface. " + "Note thatq35machine type only supportside0andide2of IDE interfaces.
- enabled Boolean
- Whether to enable the CD-ROM drive (defaults
to
false). Deprecated. The attribute will be removed in the next version of the provider. SetfileIdtononeto leave the CD-ROM drive empty. - file
Id String - A file ID for an ISO file (defaults to
cdromas in the physical drive). Usenoneto leave the CD-ROM drive empty. - interface_ String
- A hardware interface to connect CD-ROM drive to (defaults to
ide3). "Must be one ofideN,sataN,scsiN, where N is the index of the interface. " + "Note thatq35machine type only supportside0andide2of IDE interfaces.
- enabled boolean
- Whether to enable the CD-ROM drive (defaults
to
false). Deprecated. The attribute will be removed in the next version of the provider. SetfileIdtononeto leave the CD-ROM drive empty. - file
Id string - A file ID for an ISO file (defaults to
cdromas in the physical drive). Usenoneto leave the CD-ROM drive empty. - interface string
- A hardware interface to connect CD-ROM drive to (defaults to
ide3). "Must be one ofideN,sataN,scsiN, where N is the index of the interface. " + "Note thatq35machine type only supportside0andide2of IDE interfaces.
- enabled bool
- Whether to enable the CD-ROM drive (defaults
to
false). Deprecated. The attribute will be removed in the next version of the provider. SetfileIdtononeto leave the CD-ROM drive empty. - file_
id str - A file ID for an ISO file (defaults to
cdromas in the physical drive). Usenoneto leave the CD-ROM drive empty. - interface str
- A hardware interface to connect CD-ROM drive to (defaults to
ide3). "Must be one ofideN,sataN,scsiN, where N is the index of the interface. " + "Note thatq35machine type only supportside0andide2of IDE interfaces.
- enabled Boolean
- Whether to enable the CD-ROM drive (defaults
to
false). Deprecated. The attribute will be removed in the next version of the provider. SetfileIdtononeto leave the CD-ROM drive empty. - file
Id String - A file ID for an ISO file (defaults to
cdromas in the physical drive). Usenoneto leave the CD-ROM drive empty. - interface String
- A hardware interface to connect CD-ROM drive to (defaults to
ide3). "Must be one ofideN,sataN,scsiN, where N is the index of the interface. " + "Note thatq35machine type only supportside0andide2of IDE interfaces.
VmLegacyClone, VmLegacyCloneArgs
- Vm
Id int - The identifier for the source VM.
- Datastore
Id string - The identifier for the target datastore.
- Full bool
- Full or linked clone (defaults to
true). - Node
Name string - The name of the source node (leave blank, if
equal to the
nodeNameargument). - Retries int
- Number of retries in Proxmox for clone vm. Sometimes Proxmox errors with timeout when creating multiple clones at once.
- Vm
Id int - The identifier for the source VM.
- Datastore
Id string - The identifier for the target datastore.
- Full bool
- Full or linked clone (defaults to
true). - Node
Name string - The name of the source node (leave blank, if
equal to the
nodeNameargument). - Retries int
- Number of retries in Proxmox for clone vm. Sometimes Proxmox errors with timeout when creating multiple clones at once.
- vm
Id Integer - The identifier for the source VM.
- datastore
Id String - The identifier for the target datastore.
- full Boolean
- Full or linked clone (defaults to
true). - node
Name String - The name of the source node (leave blank, if
equal to the
nodeNameargument). - retries Integer
- Number of retries in Proxmox for clone vm. Sometimes Proxmox errors with timeout when creating multiple clones at once.
- vm
Id number - The identifier for the source VM.
- datastore
Id string - The identifier for the target datastore.
- full boolean
- Full or linked clone (defaults to
true). - node
Name string - The name of the source node (leave blank, if
equal to the
nodeNameargument). - retries number
- Number of retries in Proxmox for clone vm. Sometimes Proxmox errors with timeout when creating multiple clones at once.
- vm_
id int - The identifier for the source VM.
- datastore_
id str - The identifier for the target datastore.
- full bool
- Full or linked clone (defaults to
true). - node_
name str - The name of the source node (leave blank, if
equal to the
nodeNameargument). - retries int
- Number of retries in Proxmox for clone vm. Sometimes Proxmox errors with timeout when creating multiple clones at once.
- vm
Id Number - The identifier for the source VM.
- datastore
Id String - The identifier for the target datastore.
- full Boolean
- Full or linked clone (defaults to
true). - node
Name String - The name of the source node (leave blank, if
equal to the
nodeNameargument). - retries Number
- Number of retries in Proxmox for clone vm. Sometimes Proxmox errors with timeout when creating multiple clones at once.
VmLegacyCpu, VmLegacyCpuArgs
- Affinity string
- The CPU cores that are used to run the VM’s vCPU. The
value is a list of CPU IDs, separated by commas. The CPU IDs are zero-based.
For example,
0,1,2,3(which also can be shortened to0-3) means that the VM’s vCPUs are run on the first four CPU cores. Settingaffinityis only allowed forroot@pamauthenticated user. - Architecture string
- The CPU architecture (defaults to
x8664). - Cores int
- The number of CPU cores (defaults to
1). - Flags List<string>
- The CPU flags.
+aes/-aes- Activate AES instruction set for HW acceleration.+amd-no-ssb/-amd-no-ssb- Notifies guest OS that host is not vulnerable for Spectre on AMD CPUs.+amd-ssbd/-amd-ssbd- Improves Spectre mitigation performance with AMD CPUs, best used with "virt-ssbd".+hv-evmcs/-hv-evmcs- Improve performance for nested virtualization (only supported on Intel CPUs).+hv-tlbflush/-hv-tlbflush- Improve performance in overcommitted Windows guests (may lead to guest BSOD on old CPUs).+ibpb/-ibpb- Allows improved Spectre mitigation on AMD CPUs.+md-clear/-md-clear- Required to let the guest OS know if MDS is mitigated correctly.+pcid/-pcid- Meltdown fix cost reduction on Westmere, Sandy- and Ivy Bridge Intel CPUs.+pdpe1gb/-pdpe1gb- Allows guest OS to use 1 GB size pages, if host HW supports it.+spec-ctrl/-spec-ctrl- Allows improved Spectre mitigation with Intel CPUs.+ssbd/-ssbd- Protection for "Speculative Store Bypass" for Intel models.+virt-ssbd/-virt-ssbd- Basis for "Speculative Store Bypass" protection for AMD models.
- Hotplugged int
- The number of hotplugged vCPUs (defaults
to
0). - Limit double
- Limit of CPU usage,
0...128(supports fractional values, e.g.63.5). (defaults to0-- no limit). - Numa bool
- Enable/disable NUMA. (default to
false) - Sockets int
- The number of CPU sockets (defaults to
1). - Type string
- The emulated CPU type, it's recommended to
use
x86-64-v2-AES(defaults toqemu64). - Units int
- The CPU units. PVE default is
1024for cgroups v1 and100for cgroups v2.
- Affinity string
- The CPU cores that are used to run the VM’s vCPU. The
value is a list of CPU IDs, separated by commas. The CPU IDs are zero-based.
For example,
0,1,2,3(which also can be shortened to0-3) means that the VM’s vCPUs are run on the first four CPU cores. Settingaffinityis only allowed forroot@pamauthenticated user. - Architecture string
- The CPU architecture (defaults to
x8664). - Cores int
- The number of CPU cores (defaults to
1). - Flags []string
- The CPU flags.
+aes/-aes- Activate AES instruction set for HW acceleration.+amd-no-ssb/-amd-no-ssb- Notifies guest OS that host is not vulnerable for Spectre on AMD CPUs.+amd-ssbd/-amd-ssbd- Improves Spectre mitigation performance with AMD CPUs, best used with "virt-ssbd".+hv-evmcs/-hv-evmcs- Improve performance for nested virtualization (only supported on Intel CPUs).+hv-tlbflush/-hv-tlbflush- Improve performance in overcommitted Windows guests (may lead to guest BSOD on old CPUs).+ibpb/-ibpb- Allows improved Spectre mitigation on AMD CPUs.+md-clear/-md-clear- Required to let the guest OS know if MDS is mitigated correctly.+pcid/-pcid- Meltdown fix cost reduction on Westmere, Sandy- and Ivy Bridge Intel CPUs.+pdpe1gb/-pdpe1gb- Allows guest OS to use 1 GB size pages, if host HW supports it.+spec-ctrl/-spec-ctrl- Allows improved Spectre mitigation with Intel CPUs.+ssbd/-ssbd- Protection for "Speculative Store Bypass" for Intel models.+virt-ssbd/-virt-ssbd- Basis for "Speculative Store Bypass" protection for AMD models.
- Hotplugged int
- The number of hotplugged vCPUs (defaults
to
0). - Limit float64
- Limit of CPU usage,
0...128(supports fractional values, e.g.63.5). (defaults to0-- no limit). - Numa bool
- Enable/disable NUMA. (default to
false) - Sockets int
- The number of CPU sockets (defaults to
1). - Type string
- The emulated CPU type, it's recommended to
use
x86-64-v2-AES(defaults toqemu64). - Units int
- The CPU units. PVE default is
1024for cgroups v1 and100for cgroups v2.
- affinity String
- The CPU cores that are used to run the VM’s vCPU. The
value is a list of CPU IDs, separated by commas. The CPU IDs are zero-based.
For example,
0,1,2,3(which also can be shortened to0-3) means that the VM’s vCPUs are run on the first four CPU cores. Settingaffinityis only allowed forroot@pamauthenticated user. - architecture String
- The CPU architecture (defaults to
x8664). - cores Integer
- The number of CPU cores (defaults to
1). - flags List<String>
- The CPU flags.
+aes/-aes- Activate AES instruction set for HW acceleration.+amd-no-ssb/-amd-no-ssb- Notifies guest OS that host is not vulnerable for Spectre on AMD CPUs.+amd-ssbd/-amd-ssbd- Improves Spectre mitigation performance with AMD CPUs, best used with "virt-ssbd".+hv-evmcs/-hv-evmcs- Improve performance for nested virtualization (only supported on Intel CPUs).+hv-tlbflush/-hv-tlbflush- Improve performance in overcommitted Windows guests (may lead to guest BSOD on old CPUs).+ibpb/-ibpb- Allows improved Spectre mitigation on AMD CPUs.+md-clear/-md-clear- Required to let the guest OS know if MDS is mitigated correctly.+pcid/-pcid- Meltdown fix cost reduction on Westmere, Sandy- and Ivy Bridge Intel CPUs.+pdpe1gb/-pdpe1gb- Allows guest OS to use 1 GB size pages, if host HW supports it.+spec-ctrl/-spec-ctrl- Allows improved Spectre mitigation with Intel CPUs.+ssbd/-ssbd- Protection for "Speculative Store Bypass" for Intel models.+virt-ssbd/-virt-ssbd- Basis for "Speculative Store Bypass" protection for AMD models.
- hotplugged Integer
- The number of hotplugged vCPUs (defaults
to
0). - limit Double
- Limit of CPU usage,
0...128(supports fractional values, e.g.63.5). (defaults to0-- no limit). - numa Boolean
- Enable/disable NUMA. (default to
false) - sockets Integer
- The number of CPU sockets (defaults to
1). - type String
- The emulated CPU type, it's recommended to
use
x86-64-v2-AES(defaults toqemu64). - units Integer
- The CPU units. PVE default is
1024for cgroups v1 and100for cgroups v2.
- affinity string
- The CPU cores that are used to run the VM’s vCPU. The
value is a list of CPU IDs, separated by commas. The CPU IDs are zero-based.
For example,
0,1,2,3(which also can be shortened to0-3) means that the VM’s vCPUs are run on the first four CPU cores. Settingaffinityis only allowed forroot@pamauthenticated user. - architecture string
- The CPU architecture (defaults to
x8664). - cores number
- The number of CPU cores (defaults to
1). - flags string[]
- The CPU flags.
+aes/-aes- Activate AES instruction set for HW acceleration.+amd-no-ssb/-amd-no-ssb- Notifies guest OS that host is not vulnerable for Spectre on AMD CPUs.+amd-ssbd/-amd-ssbd- Improves Spectre mitigation performance with AMD CPUs, best used with "virt-ssbd".+hv-evmcs/-hv-evmcs- Improve performance for nested virtualization (only supported on Intel CPUs).+hv-tlbflush/-hv-tlbflush- Improve performance in overcommitted Windows guests (may lead to guest BSOD on old CPUs).+ibpb/-ibpb- Allows improved Spectre mitigation on AMD CPUs.+md-clear/-md-clear- Required to let the guest OS know if MDS is mitigated correctly.+pcid/-pcid- Meltdown fix cost reduction on Westmere, Sandy- and Ivy Bridge Intel CPUs.+pdpe1gb/-pdpe1gb- Allows guest OS to use 1 GB size pages, if host HW supports it.+spec-ctrl/-spec-ctrl- Allows improved Spectre mitigation with Intel CPUs.+ssbd/-ssbd- Protection for "Speculative Store Bypass" for Intel models.+virt-ssbd/-virt-ssbd- Basis for "Speculative Store Bypass" protection for AMD models.
- hotplugged number
- The number of hotplugged vCPUs (defaults
to
0). - limit number
- Limit of CPU usage,
0...128(supports fractional values, e.g.63.5). (defaults to0-- no limit). - numa boolean
- Enable/disable NUMA. (default to
false) - sockets number
- The number of CPU sockets (defaults to
1). - type string
- The emulated CPU type, it's recommended to
use
x86-64-v2-AES(defaults toqemu64). - units number
- The CPU units. PVE default is
1024for cgroups v1 and100for cgroups v2.
- affinity str
- The CPU cores that are used to run the VM’s vCPU. The
value is a list of CPU IDs, separated by commas. The CPU IDs are zero-based.
For example,
0,1,2,3(which also can be shortened to0-3) means that the VM’s vCPUs are run on the first four CPU cores. Settingaffinityis only allowed forroot@pamauthenticated user. - architecture str
- The CPU architecture (defaults to
x8664). - cores int
- The number of CPU cores (defaults to
1). - flags Sequence[str]
- The CPU flags.
+aes/-aes- Activate AES instruction set for HW acceleration.+amd-no-ssb/-amd-no-ssb- Notifies guest OS that host is not vulnerable for Spectre on AMD CPUs.+amd-ssbd/-amd-ssbd- Improves Spectre mitigation performance with AMD CPUs, best used with "virt-ssbd".+hv-evmcs/-hv-evmcs- Improve performance for nested virtualization (only supported on Intel CPUs).+hv-tlbflush/-hv-tlbflush- Improve performance in overcommitted Windows guests (may lead to guest BSOD on old CPUs).+ibpb/-ibpb- Allows improved Spectre mitigation on AMD CPUs.+md-clear/-md-clear- Required to let the guest OS know if MDS is mitigated correctly.+pcid/-pcid- Meltdown fix cost reduction on Westmere, Sandy- and Ivy Bridge Intel CPUs.+pdpe1gb/-pdpe1gb- Allows guest OS to use 1 GB size pages, if host HW supports it.+spec-ctrl/-spec-ctrl- Allows improved Spectre mitigation with Intel CPUs.+ssbd/-ssbd- Protection for "Speculative Store Bypass" for Intel models.+virt-ssbd/-virt-ssbd- Basis for "Speculative Store Bypass" protection for AMD models.
- hotplugged int
- The number of hotplugged vCPUs (defaults
to
0). - limit float
- Limit of CPU usage,
0...128(supports fractional values, e.g.63.5). (defaults to0-- no limit). - numa bool
- Enable/disable NUMA. (default to
false) - sockets int
- The number of CPU sockets (defaults to
1). - type str
- The emulated CPU type, it's recommended to
use
x86-64-v2-AES(defaults toqemu64). - units int
- The CPU units. PVE default is
1024for cgroups v1 and100for cgroups v2.
- affinity String
- The CPU cores that are used to run the VM’s vCPU. The
value is a list of CPU IDs, separated by commas. The CPU IDs are zero-based.
For example,
0,1,2,3(which also can be shortened to0-3) means that the VM’s vCPUs are run on the first four CPU cores. Settingaffinityis only allowed forroot@pamauthenticated user. - architecture String
- The CPU architecture (defaults to
x8664). - cores Number
- The number of CPU cores (defaults to
1). - flags List<String>
- The CPU flags.
+aes/-aes- Activate AES instruction set for HW acceleration.+amd-no-ssb/-amd-no-ssb- Notifies guest OS that host is not vulnerable for Spectre on AMD CPUs.+amd-ssbd/-amd-ssbd- Improves Spectre mitigation performance with AMD CPUs, best used with "virt-ssbd".+hv-evmcs/-hv-evmcs- Improve performance for nested virtualization (only supported on Intel CPUs).+hv-tlbflush/-hv-tlbflush- Improve performance in overcommitted Windows guests (may lead to guest BSOD on old CPUs).+ibpb/-ibpb- Allows improved Spectre mitigation on AMD CPUs.+md-clear/-md-clear- Required to let the guest OS know if MDS is mitigated correctly.+pcid/-pcid- Meltdown fix cost reduction on Westmere, Sandy- and Ivy Bridge Intel CPUs.+pdpe1gb/-pdpe1gb- Allows guest OS to use 1 GB size pages, if host HW supports it.+spec-ctrl/-spec-ctrl- Allows improved Spectre mitigation with Intel CPUs.+ssbd/-ssbd- Protection for "Speculative Store Bypass" for Intel models.+virt-ssbd/-virt-ssbd- Basis for "Speculative Store Bypass" protection for AMD models.
- hotplugged Number
- The number of hotplugged vCPUs (defaults
to
0). - limit Number
- Limit of CPU usage,
0...128(supports fractional values, e.g.63.5). (defaults to0-- no limit). - numa Boolean
- Enable/disable NUMA. (default to
false) - sockets Number
- The number of CPU sockets (defaults to
1). - type String
- The emulated CPU type, it's recommended to
use
x86-64-v2-AES(defaults toqemu64). - units Number
- The CPU units. PVE default is
1024for cgroups v1 and100for cgroups v2.
VmLegacyDisk, VmLegacyDiskArgs
- Interface string
- The disk interface for Proxmox, currently
scsi,sataandvirtiointerfaces are supported. Append the disk index at the end, for example,virtio0for the first virtio disk,virtio1for the second, etc. - Aio string
- The disk AIO mode (defaults to
ioUring). - Backup bool
- Whether the drive should be included when making backups (defaults to
true). - Cache string
- The cache type (defaults to
none). - Datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - Discard string
- Whether to pass discard/trim requests to the
underlying storage. Supported values are
on/ignore(defaults toignore). - File
Format string - The file format.
- File
Id string - The file ID for a disk image when importing a disk into VM. The ID format is
<datastore_id>:<content_type>/<file_name>, for examplelocal:iso/centos8.img. Can be also taken fromproxmoxve.download.FileLegacyresource. PreferimportFromfor uncompressed images. UsefileIdwhen working with compressed cloud images (e.g.,.qcow2.xz) that were downloaded withcontentType = "iso"anddecompressionAlgorithmset. See the Create a VM from a Cloud Image guide for examples. - Import
From string - The file ID for a disk image to import into VM. The image must be of
importcontent type (uncompressed images only). The ID format is<datastore_id>:import/<file_name>, for examplelocal:import/centos8.qcow2. Can be also taken fromproxmoxve.download.FileLegacyresource. Note: compressed images downloaded withdecompressionAlgorithmcannot useimportFrom; usefileIdinstead. - Iothread bool
- Whether to use iothreads for this disk (defaults
to
false). - Path
In stringDatastore - The in-datastore path to the disk image.
***Experimental.***Use to attach another VM's disks,
or (as root only) host's filesystem paths (
datastoreIdempty string). See "Example: Attached disks". - Replicate bool
- Whether the drive should be considered for replication jobs (defaults to
true). - Serial string
- The serial number of the disk, up to 20 bytes long.
- Size int
- The disk size in gigabytes (defaults to
8). - Speed
Pulumi.
Proxmox VE. Inputs. Vm Legacy Disk Speed - The speed limits.
- Ssd bool
- Whether to use an SSD emulation option for this disk (
defaults to
false). Note that SSD emulation is not supported on VirtIO Block drives.
- Interface string
- The disk interface for Proxmox, currently
scsi,sataandvirtiointerfaces are supported. Append the disk index at the end, for example,virtio0for the first virtio disk,virtio1for the second, etc. - Aio string
- The disk AIO mode (defaults to
ioUring). - Backup bool
- Whether the drive should be included when making backups (defaults to
true). - Cache string
- The cache type (defaults to
none). - Datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - Discard string
- Whether to pass discard/trim requests to the
underlying storage. Supported values are
on/ignore(defaults toignore). - File
Format string - The file format.
- File
Id string - The file ID for a disk image when importing a disk into VM. The ID format is
<datastore_id>:<content_type>/<file_name>, for examplelocal:iso/centos8.img. Can be also taken fromproxmoxve.download.FileLegacyresource. PreferimportFromfor uncompressed images. UsefileIdwhen working with compressed cloud images (e.g.,.qcow2.xz) that were downloaded withcontentType = "iso"anddecompressionAlgorithmset. See the Create a VM from a Cloud Image guide for examples. - Import
From string - The file ID for a disk image to import into VM. The image must be of
importcontent type (uncompressed images only). The ID format is<datastore_id>:import/<file_name>, for examplelocal:import/centos8.qcow2. Can be also taken fromproxmoxve.download.FileLegacyresource. Note: compressed images downloaded withdecompressionAlgorithmcannot useimportFrom; usefileIdinstead. - Iothread bool
- Whether to use iothreads for this disk (defaults
to
false). - Path
In stringDatastore - The in-datastore path to the disk image.
***Experimental.***Use to attach another VM's disks,
or (as root only) host's filesystem paths (
datastoreIdempty string). See "Example: Attached disks". - Replicate bool
- Whether the drive should be considered for replication jobs (defaults to
true). - Serial string
- The serial number of the disk, up to 20 bytes long.
- Size int
- The disk size in gigabytes (defaults to
8). - Speed
Vm
Legacy Disk Speed - The speed limits.
- Ssd bool
- Whether to use an SSD emulation option for this disk (
defaults to
false). Note that SSD emulation is not supported on VirtIO Block drives.
- interface_ String
- The disk interface for Proxmox, currently
scsi,sataandvirtiointerfaces are supported. Append the disk index at the end, for example,virtio0for the first virtio disk,virtio1for the second, etc. - aio String
- The disk AIO mode (defaults to
ioUring). - backup Boolean
- Whether the drive should be included when making backups (defaults to
true). - cache String
- The cache type (defaults to
none). - datastore
Id String - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - discard String
- Whether to pass discard/trim requests to the
underlying storage. Supported values are
on/ignore(defaults toignore). - file
Format String - The file format.
- file
Id String - The file ID for a disk image when importing a disk into VM. The ID format is
<datastore_id>:<content_type>/<file_name>, for examplelocal:iso/centos8.img. Can be also taken fromproxmoxve.download.FileLegacyresource. PreferimportFromfor uncompressed images. UsefileIdwhen working with compressed cloud images (e.g.,.qcow2.xz) that were downloaded withcontentType = "iso"anddecompressionAlgorithmset. See the Create a VM from a Cloud Image guide for examples. - import
From String - The file ID for a disk image to import into VM. The image must be of
importcontent type (uncompressed images only). The ID format is<datastore_id>:import/<file_name>, for examplelocal:import/centos8.qcow2. Can be also taken fromproxmoxve.download.FileLegacyresource. Note: compressed images downloaded withdecompressionAlgorithmcannot useimportFrom; usefileIdinstead. - iothread Boolean
- Whether to use iothreads for this disk (defaults
to
false). - path
In StringDatastore - The in-datastore path to the disk image.
***Experimental.***Use to attach another VM's disks,
or (as root only) host's filesystem paths (
datastoreIdempty string). See "Example: Attached disks". - replicate Boolean
- Whether the drive should be considered for replication jobs (defaults to
true). - serial String
- The serial number of the disk, up to 20 bytes long.
- size Integer
- The disk size in gigabytes (defaults to
8). - speed
Vm
Legacy Disk Speed - The speed limits.
- ssd Boolean
- Whether to use an SSD emulation option for this disk (
defaults to
false). Note that SSD emulation is not supported on VirtIO Block drives.
- interface string
- The disk interface for Proxmox, currently
scsi,sataandvirtiointerfaces are supported. Append the disk index at the end, for example,virtio0for the first virtio disk,virtio1for the second, etc. - aio string
- The disk AIO mode (defaults to
ioUring). - backup boolean
- Whether the drive should be included when making backups (defaults to
true). - cache string
- The cache type (defaults to
none). - datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - discard string
- Whether to pass discard/trim requests to the
underlying storage. Supported values are
on/ignore(defaults toignore). - file
Format string - The file format.
- file
Id string - The file ID for a disk image when importing a disk into VM. The ID format is
<datastore_id>:<content_type>/<file_name>, for examplelocal:iso/centos8.img. Can be also taken fromproxmoxve.download.FileLegacyresource. PreferimportFromfor uncompressed images. UsefileIdwhen working with compressed cloud images (e.g.,.qcow2.xz) that were downloaded withcontentType = "iso"anddecompressionAlgorithmset. See the Create a VM from a Cloud Image guide for examples. - import
From string - The file ID for a disk image to import into VM. The image must be of
importcontent type (uncompressed images only). The ID format is<datastore_id>:import/<file_name>, for examplelocal:import/centos8.qcow2. Can be also taken fromproxmoxve.download.FileLegacyresource. Note: compressed images downloaded withdecompressionAlgorithmcannot useimportFrom; usefileIdinstead. - iothread boolean
- Whether to use iothreads for this disk (defaults
to
false). - path
In stringDatastore - The in-datastore path to the disk image.
***Experimental.***Use to attach another VM's disks,
or (as root only) host's filesystem paths (
datastoreIdempty string). See "Example: Attached disks". - replicate boolean
- Whether the drive should be considered for replication jobs (defaults to
true). - serial string
- The serial number of the disk, up to 20 bytes long.
- size number
- The disk size in gigabytes (defaults to
8). - speed
Vm
Legacy Disk Speed - The speed limits.
- ssd boolean
- Whether to use an SSD emulation option for this disk (
defaults to
false). Note that SSD emulation is not supported on VirtIO Block drives.
- interface str
- The disk interface for Proxmox, currently
scsi,sataandvirtiointerfaces are supported. Append the disk index at the end, for example,virtio0for the first virtio disk,virtio1for the second, etc. - aio str
- The disk AIO mode (defaults to
ioUring). - backup bool
- Whether the drive should be included when making backups (defaults to
true). - cache str
- The cache type (defaults to
none). - datastore_
id str - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - discard str
- Whether to pass discard/trim requests to the
underlying storage. Supported values are
on/ignore(defaults toignore). - file_
format str - The file format.
- file_
id str - The file ID for a disk image when importing a disk into VM. The ID format is
<datastore_id>:<content_type>/<file_name>, for examplelocal:iso/centos8.img. Can be also taken fromproxmoxve.download.FileLegacyresource. PreferimportFromfor uncompressed images. UsefileIdwhen working with compressed cloud images (e.g.,.qcow2.xz) that were downloaded withcontentType = "iso"anddecompressionAlgorithmset. See the Create a VM from a Cloud Image guide for examples. - import_
from str - The file ID for a disk image to import into VM. The image must be of
importcontent type (uncompressed images only). The ID format is<datastore_id>:import/<file_name>, for examplelocal:import/centos8.qcow2. Can be also taken fromproxmoxve.download.FileLegacyresource. Note: compressed images downloaded withdecompressionAlgorithmcannot useimportFrom; usefileIdinstead. - iothread bool
- Whether to use iothreads for this disk (defaults
to
false). - path_
in_ strdatastore - The in-datastore path to the disk image.
***Experimental.***Use to attach another VM's disks,
or (as root only) host's filesystem paths (
datastoreIdempty string). See "Example: Attached disks". - replicate bool
- Whether the drive should be considered for replication jobs (defaults to
true). - serial str
- The serial number of the disk, up to 20 bytes long.
- size int
- The disk size in gigabytes (defaults to
8). - speed
Vm
Legacy Disk Speed - The speed limits.
- ssd bool
- Whether to use an SSD emulation option for this disk (
defaults to
false). Note that SSD emulation is not supported on VirtIO Block drives.
- interface String
- The disk interface for Proxmox, currently
scsi,sataandvirtiointerfaces are supported. Append the disk index at the end, for example,virtio0for the first virtio disk,virtio1for the second, etc. - aio String
- The disk AIO mode (defaults to
ioUring). - backup Boolean
- Whether the drive should be included when making backups (defaults to
true). - cache String
- The cache type (defaults to
none). - datastore
Id String - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - discard String
- Whether to pass discard/trim requests to the
underlying storage. Supported values are
on/ignore(defaults toignore). - file
Format String - The file format.
- file
Id String - The file ID for a disk image when importing a disk into VM. The ID format is
<datastore_id>:<content_type>/<file_name>, for examplelocal:iso/centos8.img. Can be also taken fromproxmoxve.download.FileLegacyresource. PreferimportFromfor uncompressed images. UsefileIdwhen working with compressed cloud images (e.g.,.qcow2.xz) that were downloaded withcontentType = "iso"anddecompressionAlgorithmset. See the Create a VM from a Cloud Image guide for examples. - import
From String - The file ID for a disk image to import into VM. The image must be of
importcontent type (uncompressed images only). The ID format is<datastore_id>:import/<file_name>, for examplelocal:import/centos8.qcow2. Can be also taken fromproxmoxve.download.FileLegacyresource. Note: compressed images downloaded withdecompressionAlgorithmcannot useimportFrom; usefileIdinstead. - iothread Boolean
- Whether to use iothreads for this disk (defaults
to
false). - path
In StringDatastore - The in-datastore path to the disk image.
***Experimental.***Use to attach another VM's disks,
or (as root only) host's filesystem paths (
datastoreIdempty string). See "Example: Attached disks". - replicate Boolean
- Whether the drive should be considered for replication jobs (defaults to
true). - serial String
- The serial number of the disk, up to 20 bytes long.
- size Number
- The disk size in gigabytes (defaults to
8). - speed Property Map
- The speed limits.
- ssd Boolean
- Whether to use an SSD emulation option for this disk (
defaults to
false). Note that SSD emulation is not supported on VirtIO Block drives.
VmLegacyDiskSpeed, VmLegacyDiskSpeedArgs
- Iops
Read int - The maximum read I/O in operations per second.
- Iops
Read intBurstable - The maximum unthrottled read I/O pool in operations per second.
- Iops
Write int - The maximum write I/O in operations per second.
- Iops
Write intBurstable - The maximum unthrottled write I/O pool in operations per second.
- Read int
- The maximum read speed in megabytes per second.
- Read
Burstable int - The maximum burstable read speed in megabytes per second.
- Write int
- The maximum write speed in megabytes per second.
- Write
Burstable int - The maximum burstable write speed in megabytes per second.
- Iops
Read int - The maximum read I/O in operations per second.
- Iops
Read intBurstable - The maximum unthrottled read I/O pool in operations per second.
- Iops
Write int - The maximum write I/O in operations per second.
- Iops
Write intBurstable - The maximum unthrottled write I/O pool in operations per second.
- Read int
- The maximum read speed in megabytes per second.
- Read
Burstable int - The maximum burstable read speed in megabytes per second.
- Write int
- The maximum write speed in megabytes per second.
- Write
Burstable int - The maximum burstable write speed in megabytes per second.
- iops
Read Integer - The maximum read I/O in operations per second.
- iops
Read IntegerBurstable - The maximum unthrottled read I/O pool in operations per second.
- iops
Write Integer - The maximum write I/O in operations per second.
- iops
Write IntegerBurstable - The maximum unthrottled write I/O pool in operations per second.
- read Integer
- The maximum read speed in megabytes per second.
- read
Burstable Integer - The maximum burstable read speed in megabytes per second.
- write Integer
- The maximum write speed in megabytes per second.
- write
Burstable Integer - The maximum burstable write speed in megabytes per second.
- iops
Read number - The maximum read I/O in operations per second.
- iops
Read numberBurstable - The maximum unthrottled read I/O pool in operations per second.
- iops
Write number - The maximum write I/O in operations per second.
- iops
Write numberBurstable - The maximum unthrottled write I/O pool in operations per second.
- read number
- The maximum read speed in megabytes per second.
- read
Burstable number - The maximum burstable read speed in megabytes per second.
- write number
- The maximum write speed in megabytes per second.
- write
Burstable number - The maximum burstable write speed in megabytes per second.
- iops_
read int - The maximum read I/O in operations per second.
- iops_
read_ intburstable - The maximum unthrottled read I/O pool in operations per second.
- iops_
write int - The maximum write I/O in operations per second.
- iops_
write_ intburstable - The maximum unthrottled write I/O pool in operations per second.
- read int
- The maximum read speed in megabytes per second.
- read_
burstable int - The maximum burstable read speed in megabytes per second.
- write int
- The maximum write speed in megabytes per second.
- write_
burstable int - The maximum burstable write speed in megabytes per second.
- iops
Read Number - The maximum read I/O in operations per second.
- iops
Read NumberBurstable - The maximum unthrottled read I/O pool in operations per second.
- iops
Write Number - The maximum write I/O in operations per second.
- iops
Write NumberBurstable - The maximum unthrottled write I/O pool in operations per second.
- read Number
- The maximum read speed in megabytes per second.
- read
Burstable Number - The maximum burstable read speed in megabytes per second.
- write Number
- The maximum write speed in megabytes per second.
- write
Burstable Number - The maximum burstable write speed in megabytes per second.
VmLegacyEfiDisk, VmLegacyEfiDiskArgs
- Datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - File
Format string - The file format (defaults to
raw). - Pre
Enrolled boolKeys - Use am EFI vars template with
distribution-specific and Microsoft Standard keys enrolled, if used with
EFI type=
4m. Ignored for VMs with cpu.architecture=aarch64(defaults tofalse). - Type string
- Size and type of the OVMF EFI disk.
4mis newer and recommended, and required for Secure Boot. For backwards compatibility use2m. Ignored for VMs with cpu.architecture=aarch64(defaults to2m).
- Datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - File
Format string - The file format (defaults to
raw). - Pre
Enrolled boolKeys - Use am EFI vars template with
distribution-specific and Microsoft Standard keys enrolled, if used with
EFI type=
4m. Ignored for VMs with cpu.architecture=aarch64(defaults tofalse). - Type string
- Size and type of the OVMF EFI disk.
4mis newer and recommended, and required for Secure Boot. For backwards compatibility use2m. Ignored for VMs with cpu.architecture=aarch64(defaults to2m).
- datastore
Id String - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - file
Format String - The file format (defaults to
raw). - pre
Enrolled BooleanKeys - Use am EFI vars template with
distribution-specific and Microsoft Standard keys enrolled, if used with
EFI type=
4m. Ignored for VMs with cpu.architecture=aarch64(defaults tofalse). - type String
- Size and type of the OVMF EFI disk.
4mis newer and recommended, and required for Secure Boot. For backwards compatibility use2m. Ignored for VMs with cpu.architecture=aarch64(defaults to2m).
- datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - file
Format string - The file format (defaults to
raw). - pre
Enrolled booleanKeys - Use am EFI vars template with
distribution-specific and Microsoft Standard keys enrolled, if used with
EFI type=
4m. Ignored for VMs with cpu.architecture=aarch64(defaults tofalse). - type string
- Size and type of the OVMF EFI disk.
4mis newer and recommended, and required for Secure Boot. For backwards compatibility use2m. Ignored for VMs with cpu.architecture=aarch64(defaults to2m).
- datastore_
id str - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - file_
format str - The file format (defaults to
raw). - pre_
enrolled_ boolkeys - Use am EFI vars template with
distribution-specific and Microsoft Standard keys enrolled, if used with
EFI type=
4m. Ignored for VMs with cpu.architecture=aarch64(defaults tofalse). - type str
- Size and type of the OVMF EFI disk.
4mis newer and recommended, and required for Secure Boot. For backwards compatibility use2m. Ignored for VMs with cpu.architecture=aarch64(defaults to2m).
- datastore
Id String - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - file
Format String - The file format (defaults to
raw). - pre
Enrolled BooleanKeys - Use am EFI vars template with
distribution-specific and Microsoft Standard keys enrolled, if used with
EFI type=
4m. Ignored for VMs with cpu.architecture=aarch64(defaults tofalse). - type String
- Size and type of the OVMF EFI disk.
4mis newer and recommended, and required for Secure Boot. For backwards compatibility use2m. Ignored for VMs with cpu.architecture=aarch64(defaults to2m).
VmLegacyHostpci, VmLegacyHostpciArgs
- Device string
- The PCI device name for Proxmox, in form
of
hostpciXwhereXis a sequential number from 0 to 15. - Id string
- The PCI device ID. This parameter is not compatible
with
apiTokenand requires the rootusernameandpasswordconfigured in the proxmox provider. Use either this ormapping. - Mapping string
- The resource mapping name of the device, for
example gpu. Use either this or
id. - Mdev string
- The mediated device ID to use.
- Pcie bool
- Tells Proxmox to use a PCIe or PCI port. Some guests/device combination require PCIe rather than PCI. PCIe is only available for q35 machine types.
- Rom
File string - A path to a ROM file for the device to use. This
is a relative path under
/usr/share/kvm/. - Rombar bool
- Makes the firmware ROM visible for the VM (defaults
to
true). - Xvga bool
- Marks the PCI(e) device as the primary GPU of the VM.
With this enabled the
vgaconfiguration argument will be ignored.
- Device string
- The PCI device name for Proxmox, in form
of
hostpciXwhereXis a sequential number from 0 to 15. - Id string
- The PCI device ID. This parameter is not compatible
with
apiTokenand requires the rootusernameandpasswordconfigured in the proxmox provider. Use either this ormapping. - Mapping string
- The resource mapping name of the device, for
example gpu. Use either this or
id. - Mdev string
- The mediated device ID to use.
- Pcie bool
- Tells Proxmox to use a PCIe or PCI port. Some guests/device combination require PCIe rather than PCI. PCIe is only available for q35 machine types.
- Rom
File string - A path to a ROM file for the device to use. This
is a relative path under
/usr/share/kvm/. - Rombar bool
- Makes the firmware ROM visible for the VM (defaults
to
true). - Xvga bool
- Marks the PCI(e) device as the primary GPU of the VM.
With this enabled the
vgaconfiguration argument will be ignored.
- device String
- The PCI device name for Proxmox, in form
of
hostpciXwhereXis a sequential number from 0 to 15. - id String
- The PCI device ID. This parameter is not compatible
with
apiTokenand requires the rootusernameandpasswordconfigured in the proxmox provider. Use either this ormapping. - mapping String
- The resource mapping name of the device, for
example gpu. Use either this or
id. - mdev String
- The mediated device ID to use.
- pcie Boolean
- Tells Proxmox to use a PCIe or PCI port. Some guests/device combination require PCIe rather than PCI. PCIe is only available for q35 machine types.
- rom
File String - A path to a ROM file for the device to use. This
is a relative path under
/usr/share/kvm/. - rombar Boolean
- Makes the firmware ROM visible for the VM (defaults
to
true). - xvga Boolean
- Marks the PCI(e) device as the primary GPU of the VM.
With this enabled the
vgaconfiguration argument will be ignored.
- device string
- The PCI device name for Proxmox, in form
of
hostpciXwhereXis a sequential number from 0 to 15. - id string
- The PCI device ID. This parameter is not compatible
with
apiTokenand requires the rootusernameandpasswordconfigured in the proxmox provider. Use either this ormapping. - mapping string
- The resource mapping name of the device, for
example gpu. Use either this or
id. - mdev string
- The mediated device ID to use.
- pcie boolean
- Tells Proxmox to use a PCIe or PCI port. Some guests/device combination require PCIe rather than PCI. PCIe is only available for q35 machine types.
- rom
File string - A path to a ROM file for the device to use. This
is a relative path under
/usr/share/kvm/. - rombar boolean
- Makes the firmware ROM visible for the VM (defaults
to
true). - xvga boolean
- Marks the PCI(e) device as the primary GPU of the VM.
With this enabled the
vgaconfiguration argument will be ignored.
- device str
- The PCI device name for Proxmox, in form
of
hostpciXwhereXis a sequential number from 0 to 15. - id str
- The PCI device ID. This parameter is not compatible
with
apiTokenand requires the rootusernameandpasswordconfigured in the proxmox provider. Use either this ormapping. - mapping str
- The resource mapping name of the device, for
example gpu. Use either this or
id. - mdev str
- The mediated device ID to use.
- pcie bool
- Tells Proxmox to use a PCIe or PCI port. Some guests/device combination require PCIe rather than PCI. PCIe is only available for q35 machine types.
- rom_
file str - A path to a ROM file for the device to use. This
is a relative path under
/usr/share/kvm/. - rombar bool
- Makes the firmware ROM visible for the VM (defaults
to
true). - xvga bool
- Marks the PCI(e) device as the primary GPU of the VM.
With this enabled the
vgaconfiguration argument will be ignored.
- device String
- The PCI device name for Proxmox, in form
of
hostpciXwhereXis a sequential number from 0 to 15. - id String
- The PCI device ID. This parameter is not compatible
with
apiTokenand requires the rootusernameandpasswordconfigured in the proxmox provider. Use either this ormapping. - mapping String
- The resource mapping name of the device, for
example gpu. Use either this or
id. - mdev String
- The mediated device ID to use.
- pcie Boolean
- Tells Proxmox to use a PCIe or PCI port. Some guests/device combination require PCIe rather than PCI. PCIe is only available for q35 machine types.
- rom
File String - A path to a ROM file for the device to use. This
is a relative path under
/usr/share/kvm/. - rombar Boolean
- Makes the firmware ROM visible for the VM (defaults
to
true). - xvga Boolean
- Marks the PCI(e) device as the primary GPU of the VM.
With this enabled the
vgaconfiguration argument will be ignored.
VmLegacyInitialization, VmLegacyInitializationArgs
- Datastore
Id string - The identifier for the datastore to create the
cloud-init disk in (defaults to
local-lvm). - Dns
Pulumi.
Proxmox VE. Inputs. Vm Legacy Initialization Dns - The DNS configuration.
- File
Format string - The file format.
- Interface string
- The hardware interface to connect the cloud-init
image to. Must be one of
ide0..3,sata0..5,scsi0..30. Will be detected if the setting is missing but a cloud-init image is present, otherwise defaults toide2. - Ip
Configs List<Pulumi.Proxmox VE. Inputs. Vm Legacy Initialization Ip Config> - The IP configuration (one block per network device).
- Meta
Data stringFile Id - The identifier for a file containing all meta data passed to the VM via cloud-init.
- Network
Data stringFile Id - The identifier for a file containing
network configuration data passed to the VM via cloud-init (conflicts
with
ipConfig). - Type string
- The cloud-init configuration format
- User
Account Pulumi.Proxmox VE. Inputs. Vm Legacy Initialization User Account - The user account configuration (conflicts
with
userDataFileId). - User
Data stringFile Id - The identifier for a file containing
custom user data (conflicts with
userAccount). - Vendor
Data stringFile Id - The identifier for a file containing all vendor data passed to the VM via cloud-init.
- Datastore
Id string - The identifier for the datastore to create the
cloud-init disk in (defaults to
local-lvm). - Dns
Vm
Legacy Initialization Dns - The DNS configuration.
- File
Format string - The file format.
- Interface string
- The hardware interface to connect the cloud-init
image to. Must be one of
ide0..3,sata0..5,scsi0..30. Will be detected if the setting is missing but a cloud-init image is present, otherwise defaults toide2. - Ip
Configs []VmLegacy Initialization Ip Config - The IP configuration (one block per network device).
- Meta
Data stringFile Id - The identifier for a file containing all meta data passed to the VM via cloud-init.
- Network
Data stringFile Id - The identifier for a file containing
network configuration data passed to the VM via cloud-init (conflicts
with
ipConfig). - Type string
- The cloud-init configuration format
- User
Account VmLegacy Initialization User Account - The user account configuration (conflicts
with
userDataFileId). - User
Data stringFile Id - The identifier for a file containing
custom user data (conflicts with
userAccount). - Vendor
Data stringFile Id - The identifier for a file containing all vendor data passed to the VM via cloud-init.
- datastore
Id String - The identifier for the datastore to create the
cloud-init disk in (defaults to
local-lvm). - dns
Vm
Legacy Initialization Dns - The DNS configuration.
- file
Format String - The file format.
- interface_ String
- The hardware interface to connect the cloud-init
image to. Must be one of
ide0..3,sata0..5,scsi0..30. Will be detected if the setting is missing but a cloud-init image is present, otherwise defaults toide2. - ip
Configs List<VmLegacy Initialization Ip Config> - The IP configuration (one block per network device).
- meta
Data StringFile Id - The identifier for a file containing all meta data passed to the VM via cloud-init.
- network
Data StringFile Id - The identifier for a file containing
network configuration data passed to the VM via cloud-init (conflicts
with
ipConfig). - type String
- The cloud-init configuration format
- user
Account VmLegacy Initialization User Account - The user account configuration (conflicts
with
userDataFileId). - user
Data StringFile Id - The identifier for a file containing
custom user data (conflicts with
userAccount). - vendor
Data StringFile Id - The identifier for a file containing all vendor data passed to the VM via cloud-init.
- datastore
Id string - The identifier for the datastore to create the
cloud-init disk in (defaults to
local-lvm). - dns
Vm
Legacy Initialization Dns - The DNS configuration.
- file
Format string - The file format.
- interface string
- The hardware interface to connect the cloud-init
image to. Must be one of
ide0..3,sata0..5,scsi0..30. Will be detected if the setting is missing but a cloud-init image is present, otherwise defaults toide2. - ip
Configs VmLegacy Initialization Ip Config[] - The IP configuration (one block per network device).
- meta
Data stringFile Id - The identifier for a file containing all meta data passed to the VM via cloud-init.
- network
Data stringFile Id - The identifier for a file containing
network configuration data passed to the VM via cloud-init (conflicts
with
ipConfig). - type string
- The cloud-init configuration format
- user
Account VmLegacy Initialization User Account - The user account configuration (conflicts
with
userDataFileId). - user
Data stringFile Id - The identifier for a file containing
custom user data (conflicts with
userAccount). - vendor
Data stringFile Id - The identifier for a file containing all vendor data passed to the VM via cloud-init.
- datastore_
id str - The identifier for the datastore to create the
cloud-init disk in (defaults to
local-lvm). - dns
Vm
Legacy Initialization Dns - The DNS configuration.
- file_
format str - The file format.
- interface str
- The hardware interface to connect the cloud-init
image to. Must be one of
ide0..3,sata0..5,scsi0..30. Will be detected if the setting is missing but a cloud-init image is present, otherwise defaults toide2. - ip_
configs Sequence[VmLegacy Initialization Ip Config] - The IP configuration (one block per network device).
- meta_
data_ strfile_ id - The identifier for a file containing all meta data passed to the VM via cloud-init.
- network_
data_ strfile_ id - The identifier for a file containing
network configuration data passed to the VM via cloud-init (conflicts
with
ipConfig). - type str
- The cloud-init configuration format
- user_
account VmLegacy Initialization User Account - The user account configuration (conflicts
with
userDataFileId). - user_
data_ strfile_ id - The identifier for a file containing
custom user data (conflicts with
userAccount). - vendor_
data_ strfile_ id - The identifier for a file containing all vendor data passed to the VM via cloud-init.
- datastore
Id String - The identifier for the datastore to create the
cloud-init disk in (defaults to
local-lvm). - dns Property Map
- The DNS configuration.
- file
Format String - The file format.
- interface String
- The hardware interface to connect the cloud-init
image to. Must be one of
ide0..3,sata0..5,scsi0..30. Will be detected if the setting is missing but a cloud-init image is present, otherwise defaults toide2. - ip
Configs List<Property Map> - The IP configuration (one block per network device).
- meta
Data StringFile Id - The identifier for a file containing all meta data passed to the VM via cloud-init.
- network
Data StringFile Id - The identifier for a file containing
network configuration data passed to the VM via cloud-init (conflicts
with
ipConfig). - type String
- The cloud-init configuration format
- user
Account Property Map - The user account configuration (conflicts
with
userDataFileId). - user
Data StringFile Id - The identifier for a file containing
custom user data (conflicts with
userAccount). - vendor
Data StringFile Id - The identifier for a file containing all vendor data passed to the VM via cloud-init.
VmLegacyInitializationDns, VmLegacyInitializationDnsArgs
VmLegacyInitializationIpConfig, VmLegacyInitializationIpConfigArgs
- Ipv4
Pulumi.
Proxmox VE. Inputs. Vm Legacy Initialization Ip Config Ipv4 - The IPv4 configuration.
- Ipv6
Pulumi.
Proxmox VE. Inputs. Vm Legacy Initialization Ip Config Ipv6 - The IPv6 configuration.
- Ipv4
Vm
Legacy Initialization Ip Config Ipv4 - The IPv4 configuration.
- Ipv6
Vm
Legacy Initialization Ip Config Ipv6 - The IPv6 configuration.
- ipv4
Vm
Legacy Initialization Ip Config Ipv4 - The IPv4 configuration.
- ipv6
Vm
Legacy Initialization Ip Config Ipv6 - The IPv6 configuration.
- ipv4
Vm
Legacy Initialization Ip Config Ipv4 - The IPv4 configuration.
- ipv6
Vm
Legacy Initialization Ip Config Ipv6 - The IPv6 configuration.
- ipv4
Vm
Legacy Initialization Ip Config Ipv4 - The IPv4 configuration.
- ipv6
Vm
Legacy Initialization Ip Config Ipv6 - The IPv6 configuration.
- ipv4 Property Map
- The IPv4 configuration.
- ipv6 Property Map
- The IPv6 configuration.
VmLegacyInitializationIpConfigIpv4, VmLegacyInitializationIpConfigIpv4Args
VmLegacyInitializationIpConfigIpv6, VmLegacyInitializationIpConfigIpv6Args
VmLegacyInitializationUserAccount, VmLegacyInitializationUserAccountArgs
VmLegacyMemory, VmLegacyMemoryArgs
- Dedicated int
- The dedicated memory in megabytes (defaults to
512). - Floating int
- The floating memory in megabytes. The default is
0, which disables "ballooning device" for the VM. Please note that Proxmox has ballooning enabled by default. To enable it, setfloatingto the same value asdedicated. See Proxmox documentation section 10.2.6 for more information. - Hugepages string
- Enable/disable hugepages memory (defaults to disable).
- Keep
Hugepages bool Keep hugepages memory after the VM is stopped (defaults to
false).Settings
hugepagesandkeepHugepagesare only allowed forroot@pamauthenticated user. And requiredcpu.numato be enabled.- int
- The shared memory in megabytes (defaults to
0).
- Dedicated int
- The dedicated memory in megabytes (defaults to
512). - Floating int
- The floating memory in megabytes. The default is
0, which disables "ballooning device" for the VM. Please note that Proxmox has ballooning enabled by default. To enable it, setfloatingto the same value asdedicated. See Proxmox documentation section 10.2.6 for more information. - Hugepages string
- Enable/disable hugepages memory (defaults to disable).
- Keep
Hugepages bool Keep hugepages memory after the VM is stopped (defaults to
false).Settings
hugepagesandkeepHugepagesare only allowed forroot@pamauthenticated user. And requiredcpu.numato be enabled.- int
- The shared memory in megabytes (defaults to
0).
- dedicated Integer
- The dedicated memory in megabytes (defaults to
512). - floating Integer
- The floating memory in megabytes. The default is
0, which disables "ballooning device" for the VM. Please note that Proxmox has ballooning enabled by default. To enable it, setfloatingto the same value asdedicated. See Proxmox documentation section 10.2.6 for more information. - hugepages String
- Enable/disable hugepages memory (defaults to disable).
- keep
Hugepages Boolean Keep hugepages memory after the VM is stopped (defaults to
false).Settings
hugepagesandkeepHugepagesare only allowed forroot@pamauthenticated user. And requiredcpu.numato be enabled.- Integer
- The shared memory in megabytes (defaults to
0).
- dedicated number
- The dedicated memory in megabytes (defaults to
512). - floating number
- The floating memory in megabytes. The default is
0, which disables "ballooning device" for the VM. Please note that Proxmox has ballooning enabled by default. To enable it, setfloatingto the same value asdedicated. See Proxmox documentation section 10.2.6 for more information. - hugepages string
- Enable/disable hugepages memory (defaults to disable).
- keep
Hugepages boolean Keep hugepages memory after the VM is stopped (defaults to
false).Settings
hugepagesandkeepHugepagesare only allowed forroot@pamauthenticated user. And requiredcpu.numato be enabled.- number
- The shared memory in megabytes (defaults to
0).
- dedicated int
- The dedicated memory in megabytes (defaults to
512). - floating int
- The floating memory in megabytes. The default is
0, which disables "ballooning device" for the VM. Please note that Proxmox has ballooning enabled by default. To enable it, setfloatingto the same value asdedicated. See Proxmox documentation section 10.2.6 for more information. - hugepages str
- Enable/disable hugepages memory (defaults to disable).
- keep_
hugepages bool Keep hugepages memory after the VM is stopped (defaults to
false).Settings
hugepagesandkeepHugepagesare only allowed forroot@pamauthenticated user. And requiredcpu.numato be enabled.- int
- The shared memory in megabytes (defaults to
0).
- dedicated Number
- The dedicated memory in megabytes (defaults to
512). - floating Number
- The floating memory in megabytes. The default is
0, which disables "ballooning device" for the VM. Please note that Proxmox has ballooning enabled by default. To enable it, setfloatingto the same value asdedicated. See Proxmox documentation section 10.2.6 for more information. - hugepages String
- Enable/disable hugepages memory (defaults to disable).
- keep
Hugepages Boolean Keep hugepages memory after the VM is stopped (defaults to
false).Settings
hugepagesandkeepHugepagesare only allowed forroot@pamauthenticated user. And requiredcpu.numato be enabled.- Number
- The shared memory in megabytes (defaults to
0).
VmLegacyNetworkDevice, VmLegacyNetworkDeviceArgs
- Bridge string
- The name of the network bridge (defaults to
vmbr0). - Disconnected bool
- Whether to disconnect the network device from the network (defaults to
false). - Enabled bool
- Whether to enable the network device (defaults to
true). Remove thenetworkDeviceblock from your configuration instead of settingenabled = false. - Firewall bool
- Whether this interface's firewall rules should be used (defaults to
false). - Mac
Address string - The MAC address.
- Model string
- The network device model (defaults to
virtio). - Mtu int
- Force MTU, for VirtIO only. Set to 1 to use the bridge MTU. Cannot be larger than the bridge MTU.
- Queues int
- The number of queues for VirtIO (1..64).
- Rate
Limit double - The rate limit in megabytes per second.
- Trunks string
- String containing a
;separated list of VLAN trunks ("10;20;30"). Note that the VLAN-aware feature need to be enabled on the PVE Linux Bridge to use trunks. - Vlan
Id int - The VLAN identifier.
- Bridge string
- The name of the network bridge (defaults to
vmbr0). - Disconnected bool
- Whether to disconnect the network device from the network (defaults to
false). - Enabled bool
- Whether to enable the network device (defaults to
true). Remove thenetworkDeviceblock from your configuration instead of settingenabled = false. - Firewall bool
- Whether this interface's firewall rules should be used (defaults to
false). - Mac
Address string - The MAC address.
- Model string
- The network device model (defaults to
virtio). - Mtu int
- Force MTU, for VirtIO only. Set to 1 to use the bridge MTU. Cannot be larger than the bridge MTU.
- Queues int
- The number of queues for VirtIO (1..64).
- Rate
Limit float64 - The rate limit in megabytes per second.
- Trunks string
- String containing a
;separated list of VLAN trunks ("10;20;30"). Note that the VLAN-aware feature need to be enabled on the PVE Linux Bridge to use trunks. - Vlan
Id int - The VLAN identifier.
- bridge String
- The name of the network bridge (defaults to
vmbr0). - disconnected Boolean
- Whether to disconnect the network device from the network (defaults to
false). - enabled Boolean
- Whether to enable the network device (defaults to
true). Remove thenetworkDeviceblock from your configuration instead of settingenabled = false. - firewall Boolean
- Whether this interface's firewall rules should be used (defaults to
false). - mac
Address String - The MAC address.
- model String
- The network device model (defaults to
virtio). - mtu Integer
- Force MTU, for VirtIO only. Set to 1 to use the bridge MTU. Cannot be larger than the bridge MTU.
- queues Integer
- The number of queues for VirtIO (1..64).
- rate
Limit Double - The rate limit in megabytes per second.
- trunks String
- String containing a
;separated list of VLAN trunks ("10;20;30"). Note that the VLAN-aware feature need to be enabled on the PVE Linux Bridge to use trunks. - vlan
Id Integer - The VLAN identifier.
- bridge string
- The name of the network bridge (defaults to
vmbr0). - disconnected boolean
- Whether to disconnect the network device from the network (defaults to
false). - enabled boolean
- Whether to enable the network device (defaults to
true). Remove thenetworkDeviceblock from your configuration instead of settingenabled = false. - firewall boolean
- Whether this interface's firewall rules should be used (defaults to
false). - mac
Address string - The MAC address.
- model string
- The network device model (defaults to
virtio). - mtu number
- Force MTU, for VirtIO only. Set to 1 to use the bridge MTU. Cannot be larger than the bridge MTU.
- queues number
- The number of queues for VirtIO (1..64).
- rate
Limit number - The rate limit in megabytes per second.
- trunks string
- String containing a
;separated list of VLAN trunks ("10;20;30"). Note that the VLAN-aware feature need to be enabled on the PVE Linux Bridge to use trunks. - vlan
Id number - The VLAN identifier.
- bridge str
- The name of the network bridge (defaults to
vmbr0). - disconnected bool
- Whether to disconnect the network device from the network (defaults to
false). - enabled bool
- Whether to enable the network device (defaults to
true). Remove thenetworkDeviceblock from your configuration instead of settingenabled = false. - firewall bool
- Whether this interface's firewall rules should be used (defaults to
false). - mac_
address str - The MAC address.
- model str
- The network device model (defaults to
virtio). - mtu int
- Force MTU, for VirtIO only. Set to 1 to use the bridge MTU. Cannot be larger than the bridge MTU.
- queues int
- The number of queues for VirtIO (1..64).
- rate_
limit float - The rate limit in megabytes per second.
- trunks str
- String containing a
;separated list of VLAN trunks ("10;20;30"). Note that the VLAN-aware feature need to be enabled on the PVE Linux Bridge to use trunks. - vlan_
id int - The VLAN identifier.
- bridge String
- The name of the network bridge (defaults to
vmbr0). - disconnected Boolean
- Whether to disconnect the network device from the network (defaults to
false). - enabled Boolean
- Whether to enable the network device (defaults to
true). Remove thenetworkDeviceblock from your configuration instead of settingenabled = false. - firewall Boolean
- Whether this interface's firewall rules should be used (defaults to
false). - mac
Address String - The MAC address.
- model String
- The network device model (defaults to
virtio). - mtu Number
- Force MTU, for VirtIO only. Set to 1 to use the bridge MTU. Cannot be larger than the bridge MTU.
- queues Number
- The number of queues for VirtIO (1..64).
- rate
Limit Number - The rate limit in megabytes per second.
- trunks String
- String containing a
;separated list of VLAN trunks ("10;20;30"). Note that the VLAN-aware feature need to be enabled on the PVE Linux Bridge to use trunks. - vlan
Id Number - The VLAN identifier.
VmLegacyNuma, VmLegacyNumaArgs
- Cpus string
- The CPU cores to assign to the NUMA node (format is
0-7;16-31). - Device string
- The NUMA device name for Proxmox, in form
of
numaXwhereXis a sequential number from 0 to 7. - Memory int
- The memory in megabytes to assign to the NUMA node.
- Hostnodes string
- The NUMA host nodes.
- Policy string
- The NUMA policy (defaults to
preferred).
- Cpus string
- The CPU cores to assign to the NUMA node (format is
0-7;16-31). - Device string
- The NUMA device name for Proxmox, in form
of
numaXwhereXis a sequential number from 0 to 7. - Memory int
- The memory in megabytes to assign to the NUMA node.
- Hostnodes string
- The NUMA host nodes.
- Policy string
- The NUMA policy (defaults to
preferred).
- cpus String
- The CPU cores to assign to the NUMA node (format is
0-7;16-31). - device String
- The NUMA device name for Proxmox, in form
of
numaXwhereXis a sequential number from 0 to 7. - memory Integer
- The memory in megabytes to assign to the NUMA node.
- hostnodes String
- The NUMA host nodes.
- policy String
- The NUMA policy (defaults to
preferred).
- cpus string
- The CPU cores to assign to the NUMA node (format is
0-7;16-31). - device string
- The NUMA device name for Proxmox, in form
of
numaXwhereXis a sequential number from 0 to 7. - memory number
- The memory in megabytes to assign to the NUMA node.
- hostnodes string
- The NUMA host nodes.
- policy string
- The NUMA policy (defaults to
preferred).
- cpus str
- The CPU cores to assign to the NUMA node (format is
0-7;16-31). - device str
- The NUMA device name for Proxmox, in form
of
numaXwhereXis a sequential number from 0 to 7. - memory int
- The memory in megabytes to assign to the NUMA node.
- hostnodes str
- The NUMA host nodes.
- policy str
- The NUMA policy (defaults to
preferred).
- cpus String
- The CPU cores to assign to the NUMA node (format is
0-7;16-31). - device String
- The NUMA device name for Proxmox, in form
of
numaXwhereXis a sequential number from 0 to 7. - memory Number
- The memory in megabytes to assign to the NUMA node.
- hostnodes String
- The NUMA host nodes.
- policy String
- The NUMA policy (defaults to
preferred).
VmLegacyOperatingSystem, VmLegacyOperatingSystemArgs
- Type string
- The type (defaults to
other).
- Type string
- The type (defaults to
other).
- type String
- The type (defaults to
other).
- type string
- The type (defaults to
other).
- type str
- The type (defaults to
other).
- type String
- The type (defaults to
other).
VmLegacyRng, VmLegacyRngArgs
- Source string
- The file on the host to gather entropy from. In most cases,
/dev/urandomshould be preferred over/dev/randomto avoid entropy-starvation issues on the host. - Max
Bytes int - Maximum bytes of entropy allowed to get injected into the guest every
periodmilliseconds (defaults to1024). Prefer a lower value when using/dev/randomas source. - Period int
- Every
periodmilliseconds the entropy-injection quota is reset, allowing the guest to retrieve anothermaxBytesof entropy (defaults to1000).
- Source string
- The file on the host to gather entropy from. In most cases,
/dev/urandomshould be preferred over/dev/randomto avoid entropy-starvation issues on the host. - Max
Bytes int - Maximum bytes of entropy allowed to get injected into the guest every
periodmilliseconds (defaults to1024). Prefer a lower value when using/dev/randomas source. - Period int
- Every
periodmilliseconds the entropy-injection quota is reset, allowing the guest to retrieve anothermaxBytesof entropy (defaults to1000).
- source String
- The file on the host to gather entropy from. In most cases,
/dev/urandomshould be preferred over/dev/randomto avoid entropy-starvation issues on the host. - max
Bytes Integer - Maximum bytes of entropy allowed to get injected into the guest every
periodmilliseconds (defaults to1024). Prefer a lower value when using/dev/randomas source. - period Integer
- Every
periodmilliseconds the entropy-injection quota is reset, allowing the guest to retrieve anothermaxBytesof entropy (defaults to1000).
- source string
- The file on the host to gather entropy from. In most cases,
/dev/urandomshould be preferred over/dev/randomto avoid entropy-starvation issues on the host. - max
Bytes number - Maximum bytes of entropy allowed to get injected into the guest every
periodmilliseconds (defaults to1024). Prefer a lower value when using/dev/randomas source. - period number
- Every
periodmilliseconds the entropy-injection quota is reset, allowing the guest to retrieve anothermaxBytesof entropy (defaults to1000).
- source str
- The file on the host to gather entropy from. In most cases,
/dev/urandomshould be preferred over/dev/randomto avoid entropy-starvation issues on the host. - max_
bytes int - Maximum bytes of entropy allowed to get injected into the guest every
periodmilliseconds (defaults to1024). Prefer a lower value when using/dev/randomas source. - period int
- Every
periodmilliseconds the entropy-injection quota is reset, allowing the guest to retrieve anothermaxBytesof entropy (defaults to1000).
- source String
- The file on the host to gather entropy from. In most cases,
/dev/urandomshould be preferred over/dev/randomto avoid entropy-starvation issues on the host. - max
Bytes Number - Maximum bytes of entropy allowed to get injected into the guest every
periodmilliseconds (defaults to1024). Prefer a lower value when using/dev/randomas source. - period Number
- Every
periodmilliseconds the entropy-injection quota is reset, allowing the guest to retrieve anothermaxBytesof entropy (defaults to1000).
VmLegacySerialDevice, VmLegacySerialDeviceArgs
- Device string
- The device (defaults to
socket)./dev/*- A host serial device.
- Device string
- The device (defaults to
socket)./dev/*- A host serial device.
- device String
- The device (defaults to
socket)./dev/*- A host serial device.
- device string
- The device (defaults to
socket)./dev/*- A host serial device.
- device str
- The device (defaults to
socket)./dev/*- A host serial device.
- device String
- The device (defaults to
socket)./dev/*- A host serial device.
VmLegacySmbios, VmLegacySmbiosArgs
VmLegacyStartup, VmLegacyStartupArgs
- down_
delay int - A non-negative number defining the delay in seconds before the next VM is shut down.
- order int
- A non-negative number defining the general startup order.
- up_
delay int - A non-negative number defining the delay in seconds before the next VM is started.
VmLegacyTpmState, VmLegacyTpmStateArgs
- Datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - Version string
- TPM state device version. Can be
v1.2orv2.0. (defaults tov2.0).
- Datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - Version string
- TPM state device version. Can be
v1.2orv2.0. (defaults tov2.0).
- datastore
Id String - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - version String
- TPM state device version. Can be
v1.2orv2.0. (defaults tov2.0).
- datastore
Id string - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - version string
- TPM state device version. Can be
v1.2orv2.0. (defaults tov2.0).
- datastore_
id str - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - version str
- TPM state device version. Can be
v1.2orv2.0. (defaults tov2.0).
- datastore
Id String - The identifier for the datastore to create
the disk in (defaults to
local-lvm). - version String
- TPM state device version. Can be
v1.2orv2.0. (defaults tov2.0).
VmLegacyUsb, VmLegacyUsbArgs
VmLegacyVga, VmLegacyVgaArgs
- Clipboard string
- Enable VNC clipboard by setting to
vnc. See the Proxmox documentation section 10.2.8 for more information. - Memory int
- The VGA memory in megabytes (defaults to
16). - Type string
- The VGA type (defaults to
std).
- Clipboard string
- Enable VNC clipboard by setting to
vnc. See the Proxmox documentation section 10.2.8 for more information. - Memory int
- The VGA memory in megabytes (defaults to
16). - Type string
- The VGA type (defaults to
std).
- clipboard String
- Enable VNC clipboard by setting to
vnc. See the Proxmox documentation section 10.2.8 for more information. - memory Integer
- The VGA memory in megabytes (defaults to
16). - type String
- The VGA type (defaults to
std).
- clipboard string
- Enable VNC clipboard by setting to
vnc. See the Proxmox documentation section 10.2.8 for more information. - memory number
- The VGA memory in megabytes (defaults to
16). - type string
- The VGA type (defaults to
std).
- clipboard str
- Enable VNC clipboard by setting to
vnc. See the Proxmox documentation section 10.2.8 for more information. - memory int
- The VGA memory in megabytes (defaults to
16). - type str
- The VGA type (defaults to
std).
- clipboard String
- Enable VNC clipboard by setting to
vnc. See the Proxmox documentation section 10.2.8 for more information. - memory Number
- The VGA memory in megabytes (defaults to
16). - type String
- The VGA type (defaults to
std).
VmLegacyVirtiof, VmLegacyVirtiofArgs
- Mapping string
- Identifier of the directory mapping
- Cache string
- The caching mode
- Direct
Io bool - Whether to allow direct io
- Expose
Acl bool - Enable POSIX ACLs, implies xattr support
- Expose
Xattr bool - Enable support for extended attributes
- Mapping string
- Identifier of the directory mapping
- Cache string
- The caching mode
- Direct
Io bool - Whether to allow direct io
- Expose
Acl bool - Enable POSIX ACLs, implies xattr support
- Expose
Xattr bool - Enable support for extended attributes
- mapping String
- Identifier of the directory mapping
- cache String
- The caching mode
- direct
Io Boolean - Whether to allow direct io
- expose
Acl Boolean - Enable POSIX ACLs, implies xattr support
- expose
Xattr Boolean - Enable support for extended attributes
- mapping string
- Identifier of the directory mapping
- cache string
- The caching mode
- direct
Io boolean - Whether to allow direct io
- expose
Acl boolean - Enable POSIX ACLs, implies xattr support
- expose
Xattr boolean - Enable support for extended attributes
- mapping str
- Identifier of the directory mapping
- cache str
- The caching mode
- direct_
io bool - Whether to allow direct io
- expose_
acl bool - Enable POSIX ACLs, implies xattr support
- expose_
xattr bool - Enable support for extended attributes
- mapping String
- Identifier of the directory mapping
- cache String
- The caching mode
- direct
Io Boolean - Whether to allow direct io
- expose
Acl Boolean - Enable POSIX ACLs, implies xattr support
- expose
Xattr Boolean - Enable support for extended attributes
VmLegacyWatchdog, VmLegacyWatchdogArgs
Import
ant Notes
local-lvm Datastore
The local-lvm is the default datastore for many configuration blocks, including initialization and tpmState, which may not seem to be related to “storage”.
If you do not have local-lvm configured in your environment, you may need to explicitly set the datastoreId in such blocks to a different value.
Cloning
When cloning an existing virtual machine, whether it’s a template or not, the resource will inherit the disks and other configuration from the source VM.
If you modify any attributes of an existing disk in the clone, you also need to
explicitly provide values for any other attributes that differ from the schema defaults
in the source (e.g., size, discard, cache, aio).
Otherwise, the schema defaults will take effect and override the source values.
Furthermore, when cloning from one node to a different one, the behavior changes depening on the datastores of the source VM. If at least one non-shared datastore is used, the VM is first cloned to the source node before being migrated to the target node. This circumvents a limitation in the Proxmox clone API.
Because the migration step after the clone tries to preserve the used
datastores by their name, it may fail if a datastore used in the source VM is
not available on the target node (e.g. local-lvm is used on the source node in
the VM but no local-lvm datastore is available on the target node). In this
case, it is recommended to set the datastoreId argument in the clone block
to force the migration step to migrate all disks to a specific datastore on the
target node. If you need certain disks to be on specific datastores, set
the datastoreId argument of the disks in the disks block to move the disks
to the correct datastore after the cloning and migrating succeeded.
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
proxmoxTerraform Provider.
published on Sunday, Apr 5, 2026 by Daniel Muehlbachler-Pietrzykowski
