proxmoxve.Vm2
Explore with Pulumi AI
!> DO NOT USE
This is an experimental implementation of a Proxmox VM resource using Plugin Framework.
It is a Proof of Concept, highly experimental and will change in future. It does not support all features of the Proxmox API for VMs and MUST NOT be used in production.
Many attributes are marked as optional and computed in the schema, hence you may seem added to the plan with “(known after apply)” status, even if they are not set in the configuration. This is done to support the
clone
operation, when a VM is created from an existing VM or template, and the source attributes are copied to the clone.
Computed attributes allow the provider to set those attributes without user input. The attributes are also marked as optional to allow the practitioner to set (or overwrite) them if needed.
Create Vm2 Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Vm2(name: string, args: Vm2Args, opts?: CustomResourceOptions);
@overload
def Vm2(resource_name: str,
args: Vm2Args,
opts: Optional[ResourceOptions] = None)
@overload
def Vm2(resource_name: str,
opts: Optional[ResourceOptions] = None,
cdrom: Optional[Mapping[str, Vm2CdromArgs]] = None,
clone: Optional[Vm2CloneArgs] = None,
cpu: Optional[Vm2CpuArgs] = None,
description: Optional[str] = None,
name: Optional[str] = None,
node_name: Optional[str] = None,
stop_on_destroy: Optional[bool] = None,
tags: Optional[Sequence[str]] = None,
template: Optional[bool] = None,
timeouts: Optional[Vm2TimeoutsArgs] = None,
vga: Optional[Vm2VgaArgs] = None)
func NewVm2(ctx *Context, name string, args Vm2Args, opts ...ResourceOption) (*Vm2, error)
public Vm2(string name, Vm2Args args, CustomResourceOptions? opts = null)
type: proxmoxve:Vm2
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 Vm2Args
- 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 Vm2Args
- 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 Vm2Args
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args Vm2Args
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args Vm2Args
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Vm2 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 Vm2 resource accepts the following input properties:
- Node
Name string - The name of the node where the VM is provisioned.
- Cdrom
Dictionary<string, Pulumi.
Proxmox VE. Inputs. Vm2Cdrom Args> - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - Clone
Pulumi.
Proxmox VE. Inputs. Vm2Clone - The cloning configuration.
- Cpu
Pulumi.
Proxmox VE. Inputs. Vm2Cpu - The CPU configuration.
- Description string
- The description of the VM.
- Name string
- The name of the VM. Doesn't have to be unique.
- Stop
On boolDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - List<string>
- The tags assigned to the VM.
- Template bool
- Set to true to create a VM template.
- Timeouts
Pulumi.
Proxmox VE. Inputs. Vm2Timeouts - Vga
Pulumi.
Proxmox VE. Inputs. Vm2Vga - Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- Node
Name string - The name of the node where the VM is provisioned.
- Cdrom
map[string]Vm2Cdrom
Args - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - Clone
Vm2Clone
Args - The cloning configuration.
- Cpu
Vm2Cpu
Args - The CPU configuration.
- Description string
- The description of the VM.
- Name string
- The name of the VM. Doesn't have to be unique.
- Stop
On boolDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - []string
- The tags assigned to the VM.
- Template bool
- Set to true to create a VM template.
- Timeouts
Vm2Timeouts
Args - Vga
Vm2Vga
Args - Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- node
Name String - The name of the node where the VM is provisioned.
- cdrom
Map<String,Vm2Cdrom
Args> - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone_ Vm2Clone
- The cloning configuration.
- cpu Vm2Cpu
- The CPU configuration.
- description String
- The description of the VM.
- name String
- The name of the VM. Doesn't have to be unique.
- stop
On BooleanDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - List<String>
- The tags assigned to the VM.
- template Boolean
- Set to true to create a VM template.
- timeouts Vm2Timeouts
- vga Vm2Vga
- Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- node
Name string - The name of the node where the VM is provisioned.
- cdrom
{[key: string]: Vm2Cdrom
Args} - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone Vm2Clone
- The cloning configuration.
- cpu Vm2Cpu
- The CPU configuration.
- description string
- The description of the VM.
- name string
- The name of the VM. Doesn't have to be unique.
- stop
On booleanDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - string[]
- The tags assigned to the VM.
- template boolean
- Set to true to create a VM template.
- timeouts Vm2Timeouts
- vga Vm2Vga
- Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- node_
name str - The name of the node where the VM is provisioned.
- cdrom
Mapping[str, Vm2Cdrom
Args] - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone
Vm2Clone
Args - The cloning configuration.
- cpu
Vm2Cpu
Args - The CPU configuration.
- description str
- The description of the VM.
- name str
- The name of the VM. Doesn't have to be unique.
- stop_
on_ booldestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - Sequence[str]
- The tags assigned to the VM.
- template bool
- Set to true to create a VM template.
- timeouts
Vm2Timeouts
Args - vga
Vm2Vga
Args - Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- node
Name String - The name of the node where the VM is provisioned.
- cdrom Map<Property Map>
- The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone Property Map
- The cloning configuration.
- cpu Property Map
- The CPU configuration.
- description String
- The description of the VM.
- name String
- The name of the VM. Doesn't have to be unique.
- stop
On BooleanDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - List<String>
- The tags assigned to the VM.
- template Boolean
- Set to true to create a VM template.
- timeouts Property Map
- vga Property Map
- Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
Outputs
All input properties are implicitly available as output properties. Additionally, the Vm2 resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing Vm2 Resource
Get an existing Vm2 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?: Vm2State, opts?: CustomResourceOptions): Vm2
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
cdrom: Optional[Mapping[str, Vm2CdromArgs]] = None,
clone: Optional[Vm2CloneArgs] = None,
cpu: Optional[Vm2CpuArgs] = None,
description: Optional[str] = None,
name: Optional[str] = None,
node_name: Optional[str] = None,
stop_on_destroy: Optional[bool] = None,
tags: Optional[Sequence[str]] = None,
template: Optional[bool] = None,
timeouts: Optional[Vm2TimeoutsArgs] = None,
vga: Optional[Vm2VgaArgs] = None) -> Vm2
func GetVm2(ctx *Context, name string, id IDInput, state *Vm2State, opts ...ResourceOption) (*Vm2, error)
public static Vm2 Get(string name, Input<string> id, Vm2State? state, CustomResourceOptions? opts = null)
public static Vm2 get(String name, Output<String> id, Vm2State state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- Cdrom
Dictionary<string, Pulumi.
Proxmox VE. Inputs. Vm2Cdrom Args> - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - Clone
Pulumi.
Proxmox VE. Inputs. Vm2Clone - The cloning configuration.
- Cpu
Pulumi.
Proxmox VE. Inputs. Vm2Cpu - The CPU configuration.
- Description string
- The description of the VM.
- Name string
- The name of the VM. Doesn't have to be unique.
- Node
Name string - The name of the node where the VM is provisioned.
- Stop
On boolDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - List<string>
- The tags assigned to the VM.
- Template bool
- Set to true to create a VM template.
- Timeouts
Pulumi.
Proxmox VE. Inputs. Vm2Timeouts - Vga
Pulumi.
Proxmox VE. Inputs. Vm2Vga - Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- Cdrom
map[string]Vm2Cdrom
Args - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - Clone
Vm2Clone
Args - The cloning configuration.
- Cpu
Vm2Cpu
Args - The CPU configuration.
- Description string
- The description of the VM.
- Name string
- The name of the VM. Doesn't have to be unique.
- Node
Name string - The name of the node where the VM is provisioned.
- Stop
On boolDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - []string
- The tags assigned to the VM.
- Template bool
- Set to true to create a VM template.
- Timeouts
Vm2Timeouts
Args - Vga
Vm2Vga
Args - Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- cdrom
Map<String,Vm2Cdrom
Args> - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone_ Vm2Clone
- The cloning configuration.
- cpu Vm2Cpu
- The CPU configuration.
- description String
- The description of the VM.
- name String
- The name of the VM. Doesn't have to be unique.
- node
Name String - The name of the node where the VM is provisioned.
- stop
On BooleanDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - List<String>
- The tags assigned to the VM.
- template Boolean
- Set to true to create a VM template.
- timeouts Vm2Timeouts
- vga Vm2Vga
- Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- cdrom
{[key: string]: Vm2Cdrom
Args} - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone Vm2Clone
- The cloning configuration.
- cpu Vm2Cpu
- The CPU configuration.
- description string
- The description of the VM.
- name string
- The name of the VM. Doesn't have to be unique.
- node
Name string - The name of the node where the VM is provisioned.
- stop
On booleanDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - string[]
- The tags assigned to the VM.
- template boolean
- Set to true to create a VM template.
- timeouts Vm2Timeouts
- vga Vm2Vga
- Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- cdrom
Mapping[str, Vm2Cdrom
Args] - The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone
Vm2Clone
Args - The cloning configuration.
- cpu
Vm2Cpu
Args - The CPU configuration.
- description str
- The description of the VM.
- name str
- The name of the VM. Doesn't have to be unique.
- node_
name str - The name of the node where the VM is provisioned.
- stop_
on_ booldestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - Sequence[str]
- The tags assigned to the VM.
- template bool
- Set to true to create a VM template.
- timeouts
Vm2Timeouts
Args - vga
Vm2Vga
Args - Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
- cdrom Map<Property Map>
- The CD-ROM configuration. The key is the interface of the CD-ROM, could be one of
ideN
,sataN
,scsiN
, where N is the index of the interface. Note thatq35
machine type only supportside0
andide2
of IDE interfaces. - clone Property Map
- The cloning configuration.
- cpu Property Map
- The CPU configuration.
- description String
- The description of the VM.
- name String
- The name of the VM. Doesn't have to be unique.
- node
Name String - The name of the node where the VM is provisioned.
- stop
On BooleanDestroy - Set to true to stop (rather than shutdown) the VM on destroy (defaults to
false
). - List<String>
- The tags assigned to the VM.
- template Boolean
- Set to true to create a VM template.
- timeouts Property Map
- vga Property Map
- Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is
std
for all OS types besides some Windows versions (XP and older) which usecirrus
. Theqxl
option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays themself. You can also run without any graphic card, using a serial device as terminal. See the Proxmox documentation section 10.2.8 for more information and available configuration parameters.
Supporting Types
Vm2Cdrom, Vm2CdromArgs
- File
Id string - The file ID of the CD-ROM, or
cdrom|none
. Defaults tonone
to leave the CD-ROM empty. Usecdrom
to connect to the physical drive.
- File
Id string - The file ID of the CD-ROM, or
cdrom|none
. Defaults tonone
to leave the CD-ROM empty. Usecdrom
to connect to the physical drive.
- file
Id String - The file ID of the CD-ROM, or
cdrom|none
. Defaults tonone
to leave the CD-ROM empty. Usecdrom
to connect to the physical drive.
- file
Id string - The file ID of the CD-ROM, or
cdrom|none
. Defaults tonone
to leave the CD-ROM empty. Usecdrom
to connect to the physical drive.
- file_
id str - The file ID of the CD-ROM, or
cdrom|none
. Defaults tonone
to leave the CD-ROM empty. Usecdrom
to connect to the physical drive.
- file
Id String - The file ID of the CD-ROM, or
cdrom|none
. Defaults tonone
to leave the CD-ROM empty. Usecdrom
to connect to the physical drive.
Vm2Clone, Vm2CloneArgs
Vm2Cpu, Vm2CpuArgs
- 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. Settingaffinity
is only allowed forroot@pam
authenticated user. - Architecture string
- The CPU architecture
<aarch64 | x86_64>
(defaults to the host). Settingaffinity
is only allowed forroot@pam
authenticated user. - Cores int
- The number of CPU cores per socket (defaults to
1
). - Flags List<string>
- Set of additional CPU flags. Use
+FLAG
to enable,-FLAG
to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons:pcid
,spec-ctrl
,ibpb
,ssbd
,virt-ssbd
,amd-ssbd
,amd-no-ssb
,pdpe1gb
,md-clear
,hv-tlbflush
,hv-evmcs
,aes
. - Hotplugged int
- The number of hotplugged vCPUs (defaults to
0
). - Limit int
- Limit of CPU usage (defaults to
0
which means no limit). - Numa bool
- Enable NUMA (defaults to
false
). - Sockets int
- The number of CPU sockets (defaults to
1
). - Type string
- Emulated CPU type, it's recommended to use
x86-64-v2-AES
or higher (defaults tokvm64
). See https://pve.proxmox.com/pve-docs/pve-admin-guide.html#qmvirtualmachines_settings for more information. - Units int
- CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.
- 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. Settingaffinity
is only allowed forroot@pam
authenticated user. - Architecture string
- The CPU architecture
<aarch64 | x86_64>
(defaults to the host). Settingaffinity
is only allowed forroot@pam
authenticated user. - Cores int
- The number of CPU cores per socket (defaults to
1
). - Flags []string
- Set of additional CPU flags. Use
+FLAG
to enable,-FLAG
to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons:pcid
,spec-ctrl
,ibpb
,ssbd
,virt-ssbd
,amd-ssbd
,amd-no-ssb
,pdpe1gb
,md-clear
,hv-tlbflush
,hv-evmcs
,aes
. - Hotplugged int
- The number of hotplugged vCPUs (defaults to
0
). - Limit int
- Limit of CPU usage (defaults to
0
which means no limit). - Numa bool
- Enable NUMA (defaults to
false
). - Sockets int
- The number of CPU sockets (defaults to
1
). - Type string
- Emulated CPU type, it's recommended to use
x86-64-v2-AES
or higher (defaults tokvm64
). See https://pve.proxmox.com/pve-docs/pve-admin-guide.html#qmvirtualmachines_settings for more information. - Units int
- CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.
- 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. Settingaffinity
is only allowed forroot@pam
authenticated user. - architecture String
- The CPU architecture
<aarch64 | x86_64>
(defaults to the host). Settingaffinity
is only allowed forroot@pam
authenticated user. - cores Integer
- The number of CPU cores per socket (defaults to
1
). - flags List<String>
- Set of additional CPU flags. Use
+FLAG
to enable,-FLAG
to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons:pcid
,spec-ctrl
,ibpb
,ssbd
,virt-ssbd
,amd-ssbd
,amd-no-ssb
,pdpe1gb
,md-clear
,hv-tlbflush
,hv-evmcs
,aes
. - hotplugged Integer
- The number of hotplugged vCPUs (defaults to
0
). - limit Integer
- Limit of CPU usage (defaults to
0
which means no limit). - numa Boolean
- Enable NUMA (defaults to
false
). - sockets Integer
- The number of CPU sockets (defaults to
1
). - type String
- Emulated CPU type, it's recommended to use
x86-64-v2-AES
or higher (defaults tokvm64
). See https://pve.proxmox.com/pve-docs/pve-admin-guide.html#qmvirtualmachines_settings for more information. - units Integer
- CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.
- 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. Settingaffinity
is only allowed forroot@pam
authenticated user. - architecture string
- The CPU architecture
<aarch64 | x86_64>
(defaults to the host). Settingaffinity
is only allowed forroot@pam
authenticated user. - cores number
- The number of CPU cores per socket (defaults to
1
). - flags string[]
- Set of additional CPU flags. Use
+FLAG
to enable,-FLAG
to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons:pcid
,spec-ctrl
,ibpb
,ssbd
,virt-ssbd
,amd-ssbd
,amd-no-ssb
,pdpe1gb
,md-clear
,hv-tlbflush
,hv-evmcs
,aes
. - hotplugged number
- The number of hotplugged vCPUs (defaults to
0
). - limit number
- Limit of CPU usage (defaults to
0
which means no limit). - numa boolean
- Enable NUMA (defaults to
false
). - sockets number
- The number of CPU sockets (defaults to
1
). - type string
- Emulated CPU type, it's recommended to use
x86-64-v2-AES
or higher (defaults tokvm64
). See https://pve.proxmox.com/pve-docs/pve-admin-guide.html#qmvirtualmachines_settings for more information. - units number
- CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.
- 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. Settingaffinity
is only allowed forroot@pam
authenticated user. - architecture str
- The CPU architecture
<aarch64 | x86_64>
(defaults to the host). Settingaffinity
is only allowed forroot@pam
authenticated user. - cores int
- The number of CPU cores per socket (defaults to
1
). - flags Sequence[str]
- Set of additional CPU flags. Use
+FLAG
to enable,-FLAG
to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons:pcid
,spec-ctrl
,ibpb
,ssbd
,virt-ssbd
,amd-ssbd
,amd-no-ssb
,pdpe1gb
,md-clear
,hv-tlbflush
,hv-evmcs
,aes
. - hotplugged int
- The number of hotplugged vCPUs (defaults to
0
). - limit int
- Limit of CPU usage (defaults to
0
which means no limit). - numa bool
- Enable NUMA (defaults to
false
). - sockets int
- The number of CPU sockets (defaults to
1
). - type str
- Emulated CPU type, it's recommended to use
x86-64-v2-AES
or higher (defaults tokvm64
). See https://pve.proxmox.com/pve-docs/pve-admin-guide.html#qmvirtualmachines_settings for more information. - units int
- CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.
- 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. Settingaffinity
is only allowed forroot@pam
authenticated user. - architecture String
- The CPU architecture
<aarch64 | x86_64>
(defaults to the host). Settingaffinity
is only allowed forroot@pam
authenticated user. - cores Number
- The number of CPU cores per socket (defaults to
1
). - flags List<String>
- Set of additional CPU flags. Use
+FLAG
to enable,-FLAG
to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons:pcid
,spec-ctrl
,ibpb
,ssbd
,virt-ssbd
,amd-ssbd
,amd-no-ssb
,pdpe1gb
,md-clear
,hv-tlbflush
,hv-evmcs
,aes
. - hotplugged Number
- The number of hotplugged vCPUs (defaults to
0
). - limit Number
- Limit of CPU usage (defaults to
0
which means no limit). - numa Boolean
- Enable NUMA (defaults to
false
). - sockets Number
- The number of CPU sockets (defaults to
1
). - type String
- Emulated CPU type, it's recommended to use
x86-64-v2-AES
or higher (defaults tokvm64
). See https://pve.proxmox.com/pve-docs/pve-admin-guide.html#qmvirtualmachines_settings for more information. - units Number
- CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.
Vm2Timeouts, Vm2TimeoutsArgs
- Create string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- Delete string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- Read string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.
- Update string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- Create string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- Delete string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- Read string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.
- Update string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- read String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.
- update String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- read string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.
- update string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create str
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete str
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- read str
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.
- update str
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- read String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.
- update String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
Vm2Vga, Vm2VgaArgs
- Clipboard string
- Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Currently only
vnc
is available. Migration with VNC clipboard is not supported by Proxmox. - Memory int
- The VGA memory in megabytes (4-512 MB). Has no effect with serial display.
- Type string
- The VGA type (defaults to
std
).
- Clipboard string
- Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Currently only
vnc
is available. Migration with VNC clipboard is not supported by Proxmox. - Memory int
- The VGA memory in megabytes (4-512 MB). Has no effect with serial display.
- Type string
- The VGA type (defaults to
std
).
- clipboard String
- Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Currently only
vnc
is available. Migration with VNC clipboard is not supported by Proxmox. - memory Integer
- The VGA memory in megabytes (4-512 MB). Has no effect with serial display.
- type String
- The VGA type (defaults to
std
).
- clipboard string
- Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Currently only
vnc
is available. Migration with VNC clipboard is not supported by Proxmox. - memory number
- The VGA memory in megabytes (4-512 MB). Has no effect with serial display.
- type string
- The VGA type (defaults to
std
).
- clipboard str
- Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Currently only
vnc
is available. Migration with VNC clipboard is not supported by Proxmox. - memory int
- The VGA memory in megabytes (4-512 MB). Has no effect with serial display.
- type str
- The VGA type (defaults to
std
).
- clipboard String
- Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Currently only
vnc
is available. Migration with VNC clipboard is not supported by Proxmox. - memory Number
- The VGA memory in megabytes (4-512 MB). Has no effect with serial display.
- type String
- The VGA type (defaults to
std
).
Package Details
- Repository
- proxmoxve muhlba91/pulumi-proxmoxve
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
proxmox
Terraform Provider.