mirror of
git://git.proxmox.com/git/pve-docs.git
synced 2025-01-03 01:17:49 +03:00
update static/schema information
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This commit is contained in:
Thomas Lamprecht
parent
ff30375727
commit
c6d5bae84a
@ -180,7 +180,7 @@ const apiSchema = [
|
||||
"additionalProperties" : 0
|
||||
},
|
||||
"permissions" : {
|
||||
"description" : "Requires the VM.Audit permission on /vms/<vmid>.",
|
||||
"description" : "Will only return replication jobs for which the calling user has VM.Audit permission on /vms/<vmid>.",
|
||||
"user" : "all"
|
||||
},
|
||||
"returns" : {
|
||||
@ -5560,7 +5560,7 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"exclude-path" : {
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"items" : {
|
||||
"type" : "string"
|
||||
},
|
||||
@ -5593,7 +5593,7 @@ const apiSchema = [
|
||||
},
|
||||
"mailnotification" : {
|
||||
"default" : "always",
|
||||
"description" : "Deprecated: use 'notification-policy' instead.",
|
||||
"description" : "Deprecated: use notification targets/matchers instead. Specify when to send a notification mail",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure"
|
||||
@ -5602,7 +5602,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"mailto" : {
|
||||
"description" : "Comma-separated list of email addresses or users that should receive email notifications. Has no effect if the 'notification-target' option is set at the same time.",
|
||||
"description" : "Deprecated: Use notification targets/matchers instead. Comma-separated list of email addresses or users that should receive email notifications.",
|
||||
"format" : "email-or-username-list",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -5641,9 +5641,20 @@ const apiSchema = [
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"notification-mode" : {
|
||||
"default" : "auto",
|
||||
"description" : "Determine which notification system to use. If set to 'legacy-sendmail', vzdump will consider the mailto/mailnotification parameters and send emails to the specified address(es) via the 'sendmail' command. If set to 'notification-system', a notification will be sent via PVE's notification system, and the mailto and mailnotification will be ignored. If set to 'auto' (default setting), an email will be sent if mailto is set, and the notification system will be used if not.",
|
||||
"enum" : [
|
||||
"auto",
|
||||
"legacy-sendmail",
|
||||
"notification-system"
|
||||
],
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-policy" : {
|
||||
"default" : "always",
|
||||
"description" : "Specify when to send a notification",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure",
|
||||
@ -5653,7 +5664,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-target" : {
|
||||
"description" : "Determine the target to which notifications should be sent. Can either be a notification endpoint or a notification group. This option takes precedence over 'mailto', meaning that if both are set, the 'mailto' option will be ignored.",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"format" : "pve-configid",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -5780,7 +5791,7 @@ const apiSchema = [
|
||||
},
|
||||
"zstd" : {
|
||||
"default" : 1,
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.",
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, if N is set to a value bigger than 0, N is used as thread count.",
|
||||
"optional" : 1,
|
||||
"type" : "integer",
|
||||
"typetext" : "<integer>"
|
||||
@ -5919,7 +5930,7 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"exclude-path" : {
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"items" : {
|
||||
"type" : "string"
|
||||
},
|
||||
@ -5953,7 +5964,7 @@ const apiSchema = [
|
||||
},
|
||||
"mailnotification" : {
|
||||
"default" : "always",
|
||||
"description" : "Deprecated: use 'notification-policy' instead.",
|
||||
"description" : "Deprecated: use notification targets/matchers instead. Specify when to send a notification mail",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure"
|
||||
@ -5962,7 +5973,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"mailto" : {
|
||||
"description" : "Comma-separated list of email addresses or users that should receive email notifications. Has no effect if the 'notification-target' option is set at the same time.",
|
||||
"description" : "Deprecated: Use notification targets/matchers instead. Comma-separated list of email addresses or users that should receive email notifications.",
|
||||
"format" : "email-or-username-list",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -6001,9 +6012,20 @@ const apiSchema = [
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"notification-mode" : {
|
||||
"default" : "auto",
|
||||
"description" : "Determine which notification system to use. If set to 'legacy-sendmail', vzdump will consider the mailto/mailnotification parameters and send emails to the specified address(es) via the 'sendmail' command. If set to 'notification-system', a notification will be sent via PVE's notification system, and the mailto and mailnotification will be ignored. If set to 'auto' (default setting), an email will be sent if mailto is set, and the notification system will be used if not.",
|
||||
"enum" : [
|
||||
"auto",
|
||||
"legacy-sendmail",
|
||||
"notification-system"
|
||||
],
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-policy" : {
|
||||
"default" : "always",
|
||||
"description" : "Specify when to send a notification",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure",
|
||||
@ -6013,7 +6035,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-target" : {
|
||||
"description" : "Determine the target to which notifications should be sent. Can either be a notification endpoint or a notification group. This option takes precedence over 'mailto', meaning that if both are set, the 'mailto' option will be ignored.",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"format" : "pve-configid",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -6140,7 +6162,7 @@ const apiSchema = [
|
||||
},
|
||||
"zstd" : {
|
||||
"default" : 1,
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.",
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, if N is set to a value bigger than 0, N is used as thread count.",
|
||||
"optional" : 1,
|
||||
"type" : "integer",
|
||||
"typetext" : "<integer>"
|
||||
@ -18052,6 +18074,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"product" : {
|
||||
"description" : "The drive's product name, up to 16 bytes long.",
|
||||
"format_description" : "product",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,16}",
|
||||
"type" : "string"
|
||||
},
|
||||
"queues" : {
|
||||
"description" : "Number of queues.",
|
||||
"minimum" : 2,
|
||||
@ -18132,6 +18161,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"vendor" : {
|
||||
"description" : "The drive's vendor name, up to 8 bytes long.",
|
||||
"format_description" : "vendor",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,8}",
|
||||
"type" : "string"
|
||||
},
|
||||
"volume" : {
|
||||
"alias" : "file"
|
||||
},
|
||||
@ -18372,7 +18408,7 @@ const apiSchema = [
|
||||
"description" : "Configure the VGA hardware.",
|
||||
"format" : {
|
||||
"clipboard" : {
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added.",
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Migration with VNC clipboard is not yet supported!",
|
||||
"enum" : [
|
||||
"vnc"
|
||||
],
|
||||
@ -20435,6 +20471,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"product" : {
|
||||
"description" : "The drive's product name, up to 16 bytes long.",
|
||||
"format_description" : "product",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,16}",
|
||||
"type" : "string"
|
||||
},
|
||||
"queues" : {
|
||||
"description" : "Number of queues.",
|
||||
"minimum" : 2,
|
||||
@ -20515,6 +20558,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"vendor" : {
|
||||
"description" : "The drive's vendor name, up to 8 bytes long.",
|
||||
"format_description" : "vendor",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,8}",
|
||||
"type" : "string"
|
||||
},
|
||||
"volume" : {
|
||||
"alias" : "file"
|
||||
},
|
||||
@ -20539,7 +20589,7 @@ const apiSchema = [
|
||||
},
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]"
|
||||
"typetext" : "[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]"
|
||||
},
|
||||
"scsihw" : {
|
||||
"default" : "lsi",
|
||||
@ -20784,7 +20834,7 @@ const apiSchema = [
|
||||
"description" : "Configure the VGA hardware.",
|
||||
"format" : {
|
||||
"clipboard" : {
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added.",
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Migration with VNC clipboard is not yet supported!",
|
||||
"enum" : [
|
||||
"vnc"
|
||||
],
|
||||
@ -22881,6 +22931,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"product" : {
|
||||
"description" : "The drive's product name, up to 16 bytes long.",
|
||||
"format_description" : "product",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,16}",
|
||||
"type" : "string"
|
||||
},
|
||||
"queues" : {
|
||||
"description" : "Number of queues.",
|
||||
"minimum" : 2,
|
||||
@ -22961,6 +23018,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"vendor" : {
|
||||
"description" : "The drive's vendor name, up to 8 bytes long.",
|
||||
"format_description" : "vendor",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,8}",
|
||||
"type" : "string"
|
||||
},
|
||||
"volume" : {
|
||||
"alias" : "file"
|
||||
},
|
||||
@ -22985,7 +23049,7 @@ const apiSchema = [
|
||||
},
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]"
|
||||
"typetext" : "[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]"
|
||||
},
|
||||
"scsihw" : {
|
||||
"default" : "lsi",
|
||||
@ -23230,7 +23294,7 @@ const apiSchema = [
|
||||
"description" : "Configure the VGA hardware.",
|
||||
"format" : {
|
||||
"clipboard" : {
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added.",
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Migration with VNC clipboard is not yet supported!",
|
||||
"enum" : [
|
||||
"vnc"
|
||||
],
|
||||
@ -26164,7 +26228,7 @@ const apiSchema = [
|
||||
"description" : "Remote target endpoint",
|
||||
"format" : "proxmox-remote",
|
||||
"type" : "string",
|
||||
"typetext" : "apitoken=<A full Proxmox API token including the secret value.> ,host=<Remote Proxmox hostname or IP> [,fingerprint=<Remote host's certificate fingerprint, if not trusted by system store.>] [,port=<integer>]"
|
||||
"typetext" : "apitoken=<user@realm!token=SECRET> ,host=<ADDRESS> [,fingerprint=<FINGERPRINT>] [,port=<PORT>]"
|
||||
},
|
||||
"target-storage" : {
|
||||
"description" : "Mapping from source to target storages. Providing only a single storage ID maps all source storages to that storage. Providing the special value '1' will map each source storage to itself.",
|
||||
@ -28057,9 +28121,8 @@ const apiSchema = [
|
||||
"typetext" : "<boolean>"
|
||||
},
|
||||
"live-restore" : {
|
||||
"description" : "Start the VM immediately from the backup and restore in background. PBS only.",
|
||||
"description" : "Start the VM immediately while importing or restoring in the background.",
|
||||
"optional" : 1,
|
||||
"requires" : "archive",
|
||||
"type" : "boolean",
|
||||
"typetext" : "<boolean>"
|
||||
},
|
||||
@ -28982,6 +29045,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"product" : {
|
||||
"description" : "The drive's product name, up to 16 bytes long.",
|
||||
"format_description" : "product",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,16}",
|
||||
"type" : "string"
|
||||
},
|
||||
"queues" : {
|
||||
"description" : "Number of queues.",
|
||||
"minimum" : 2,
|
||||
@ -29062,6 +29132,13 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"vendor" : {
|
||||
"description" : "The drive's vendor name, up to 8 bytes long.",
|
||||
"format_description" : "vendor",
|
||||
"optional" : 1,
|
||||
"pattern" : "[A-Za-z0-9\\-_\\s]{,8}",
|
||||
"type" : "string"
|
||||
},
|
||||
"volume" : {
|
||||
"alias" : "file"
|
||||
},
|
||||
@ -29086,7 +29163,7 @@ const apiSchema = [
|
||||
},
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]"
|
||||
"typetext" : "[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]"
|
||||
},
|
||||
"scsihw" : {
|
||||
"default" : "lsi",
|
||||
@ -29346,7 +29423,7 @@ const apiSchema = [
|
||||
"description" : "Configure the VGA hardware.",
|
||||
"format" : {
|
||||
"clipboard" : {
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added.",
|
||||
"description" : "Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Migration with VNC clipboard is not yet supported!",
|
||||
"enum" : [
|
||||
"vnc"
|
||||
],
|
||||
@ -34208,7 +34285,7 @@ const apiSchema = [
|
||||
"description" : "Remote target endpoint",
|
||||
"format" : "proxmox-remote",
|
||||
"type" : "string",
|
||||
"typetext" : "apitoken=<A full Proxmox API token including the secret value.> ,host=<Remote Proxmox hostname or IP> [,fingerprint=<Remote host's certificate fingerprint, if not trusted by system store.>] [,port=<integer>]"
|
||||
"typetext" : "apitoken=<user@realm!token=SECRET> ,host=<ADDRESS> [,fingerprint=<FINGERPRINT>] [,port=<PORT>]"
|
||||
},
|
||||
"target-storage" : {
|
||||
"description" : "Mapping from source to target storages. Providing only a single storage ID maps all source storages to that storage. Providing the special value '1' will map each source storage to itself.",
|
||||
@ -39920,7 +39997,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"exclude-path" : {
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"items" : {
|
||||
"type" : "string"
|
||||
},
|
||||
@ -39944,7 +40021,7 @@ const apiSchema = [
|
||||
},
|
||||
"mailnotification" : {
|
||||
"default" : "always",
|
||||
"description" : "Deprecated: use 'notification-policy' instead.",
|
||||
"description" : "Deprecated: use notification targets/matchers instead. Specify when to send a notification mail",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure"
|
||||
@ -39953,7 +40030,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"mailto" : {
|
||||
"description" : "Comma-separated list of email addresses or users that should receive email notifications. Has no effect if the 'notification-target' option is set at the same time.",
|
||||
"description" : "Deprecated: Use notification targets/matchers instead. Comma-separated list of email addresses or users that should receive email notifications.",
|
||||
"format" : "email-or-username-list",
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
@ -39988,9 +40065,20 @@ const apiSchema = [
|
||||
"requires" : "storage",
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-mode" : {
|
||||
"default" : "auto",
|
||||
"description" : "Determine which notification system to use. If set to 'legacy-sendmail', vzdump will consider the mailto/mailnotification parameters and send emails to the specified address(es) via the 'sendmail' command. If set to 'notification-system', a notification will be sent via PVE's notification system, and the mailto and mailnotification will be ignored. If set to 'auto' (default setting), an email will be sent if mailto is set, and the notification system will be used if not.",
|
||||
"enum" : [
|
||||
"auto",
|
||||
"legacy-sendmail",
|
||||
"notification-system"
|
||||
],
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-policy" : {
|
||||
"default" : "always",
|
||||
"description" : "Specify when to send a notification",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure",
|
||||
@ -40000,7 +40088,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-target" : {
|
||||
"description" : "Determine the target to which notifications should be sent. Can either be a notification endpoint or a notification group. This option takes precedence over 'mailto', meaning that if both are set, the 'mailto' option will be ignored.",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"format" : "pve-configid",
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
@ -40090,7 +40178,7 @@ const apiSchema = [
|
||||
},
|
||||
"zstd" : {
|
||||
"default" : 1,
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.",
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, if N is set to a value bigger than 0, N is used as thread count.",
|
||||
"optional" : 1,
|
||||
"type" : "integer"
|
||||
}
|
||||
@ -40193,7 +40281,7 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"exclude-path" : {
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"description" : "Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.",
|
||||
"items" : {
|
||||
"type" : "string"
|
||||
},
|
||||
@ -40220,7 +40308,7 @@ const apiSchema = [
|
||||
},
|
||||
"mailnotification" : {
|
||||
"default" : "always",
|
||||
"description" : "Deprecated: use 'notification-policy' instead.",
|
||||
"description" : "Deprecated: use notification targets/matchers instead. Specify when to send a notification mail",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure"
|
||||
@ -40229,7 +40317,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"mailto" : {
|
||||
"description" : "Comma-separated list of email addresses or users that should receive email notifications. Has no effect if the 'notification-target' option is set at the same time.",
|
||||
"description" : "Deprecated: Use notification targets/matchers instead. Comma-separated list of email addresses or users that should receive email notifications.",
|
||||
"format" : "email-or-username-list",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -40268,9 +40356,20 @@ const apiSchema = [
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"notification-mode" : {
|
||||
"default" : "auto",
|
||||
"description" : "Determine which notification system to use. If set to 'legacy-sendmail', vzdump will consider the mailto/mailnotification parameters and send emails to the specified address(es) via the 'sendmail' command. If set to 'notification-system', a notification will be sent via PVE's notification system, and the mailto and mailnotification will be ignored. If set to 'auto' (default setting), an email will be sent if mailto is set, and the notification system will be used if not.",
|
||||
"enum" : [
|
||||
"auto",
|
||||
"legacy-sendmail",
|
||||
"notification-system"
|
||||
],
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-policy" : {
|
||||
"default" : "always",
|
||||
"description" : "Specify when to send a notification",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"enum" : [
|
||||
"always",
|
||||
"failure",
|
||||
@ -40280,7 +40379,7 @@ const apiSchema = [
|
||||
"type" : "string"
|
||||
},
|
||||
"notification-target" : {
|
||||
"description" : "Determine the target to which notifications should be sent. Can either be a notification endpoint or a notification group. This option takes precedence over 'mailto', meaning that if both are set, the 'mailto' option will be ignored.",
|
||||
"description" : "Deprecated: Do not use",
|
||||
"format" : "pve-configid",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -40391,7 +40490,7 @@ const apiSchema = [
|
||||
},
|
||||
"zstd" : {
|
||||
"default" : 1,
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.",
|
||||
"description" : "Zstd threads. N=0 uses half of the available cores, if N is set to a value bigger than 0, N is used as thread count.",
|
||||
"optional" : 1,
|
||||
"type" : "integer",
|
||||
"typetext" : "<integer>"
|
||||
@ -44262,14 +44361,25 @@ const apiSchema = [
|
||||
]
|
||||
],
|
||||
[
|
||||
"perm",
|
||||
"/",
|
||||
"or",
|
||||
[
|
||||
"Sys.Audit",
|
||||
"Sys.Modify"
|
||||
"perm",
|
||||
"/",
|
||||
[
|
||||
"Sys.Audit",
|
||||
"Sys.Modify"
|
||||
]
|
||||
],
|
||||
[
|
||||
"perm",
|
||||
"/nodes/{node}",
|
||||
[
|
||||
"Sys.AccessNetwork"
|
||||
]
|
||||
]
|
||||
]
|
||||
]
|
||||
],
|
||||
"description" : "Requires allocation access on the storage and as this allows one to probe the (local!) host network indirectly it also requires one of Sys.Modify on / (for backwards compatibility) or the newer Sys.AccessNetwork privilege on the node."
|
||||
},
|
||||
"protected" : 1,
|
||||
"proxyto" : "node",
|
||||
@ -44281,6 +44391,118 @@ const apiSchema = [
|
||||
"leaf" : 1,
|
||||
"path" : "/nodes/{node}/storage/{storage}/download-url",
|
||||
"text" : "download-url"
|
||||
},
|
||||
{
|
||||
"info" : {
|
||||
"GET" : {
|
||||
"allowtoken" : 1,
|
||||
"description" : "Get the base parameters for creating a guest which imports data from a foreign importable guest, like an ESXi VM",
|
||||
"method" : "GET",
|
||||
"name" : "get_import_metadata",
|
||||
"parameters" : {
|
||||
"additionalProperties" : 0,
|
||||
"properties" : {
|
||||
"node" : {
|
||||
"description" : "The cluster node name.",
|
||||
"format" : "pve-node",
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"storage" : {
|
||||
"description" : "The storage identifier.",
|
||||
"format" : "pve-storage-id",
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"volume" : {
|
||||
"description" : "Volume identifier for the guest archive/entry.",
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
}
|
||||
}
|
||||
},
|
||||
"permissions" : {
|
||||
"description" : "You need read access for the volume.",
|
||||
"user" : "all"
|
||||
},
|
||||
"protected" : 1,
|
||||
"proxyto" : "node",
|
||||
"returns" : {
|
||||
"additionalProperties" : 0,
|
||||
"description" : "Information about how to import a guest.",
|
||||
"properties" : {
|
||||
"create-args" : {
|
||||
"additionalProperties" : 1,
|
||||
"description" : "Parameters which can be used in a call to create a VM or container.",
|
||||
"type" : "object"
|
||||
},
|
||||
"disks" : {
|
||||
"additionalProperties" : 1,
|
||||
"description" : "Recognised disk volumes as `$bus$id` => `$storeid:$path` map.",
|
||||
"optional" : 1,
|
||||
"type" : "object"
|
||||
},
|
||||
"net" : {
|
||||
"additionalProperties" : 1,
|
||||
"description" : "Recognised network interfaces as `net$id` => { ...params } object.",
|
||||
"optional" : 1,
|
||||
"type" : "object"
|
||||
},
|
||||
"source" : {
|
||||
"description" : "The type of the import-source of this guest volume.",
|
||||
"enum" : [
|
||||
"esxi"
|
||||
],
|
||||
"type" : "string"
|
||||
},
|
||||
"type" : {
|
||||
"description" : "The type of guest this is going to produce.",
|
||||
"enum" : [
|
||||
"vm"
|
||||
],
|
||||
"type" : "string"
|
||||
},
|
||||
"warnings" : {
|
||||
"description" : "List of known issues that can affect the import of a guest. Note that lack of warning does not imply that there cannot be any problems.",
|
||||
"items" : {
|
||||
"additionalProperties" : 1,
|
||||
"properties" : {
|
||||
"key" : {
|
||||
"description" : "Related subject (config) key of warning.",
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"type" : {
|
||||
"description" : "What this warning is about.",
|
||||
"enum" : [
|
||||
"cdrom-image-ignored",
|
||||
"efi-state-lost",
|
||||
"guest-is-running",
|
||||
"nvme-unsupported",
|
||||
"ovmf-with-lsi-unsupported",
|
||||
"serial-port-socket-only"
|
||||
],
|
||||
"type" : "string"
|
||||
},
|
||||
"value" : {
|
||||
"description" : "Related subject (config) value of warning.",
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
}
|
||||
},
|
||||
"type" : "object"
|
||||
},
|
||||
"optional" : 1,
|
||||
"type" : "array"
|
||||
}
|
||||
},
|
||||
"type" : "object"
|
||||
}
|
||||
}
|
||||
},
|
||||
"leaf" : 1,
|
||||
"path" : "/nodes/{node}/storage/{storage}/import-metadata",
|
||||
"text" : "import-metadata"
|
||||
}
|
||||
],
|
||||
"info" : {
|
||||
@ -48551,6 +48773,50 @@ const apiSchema = [
|
||||
},
|
||||
"proxyto" : "node",
|
||||
"returns" : {
|
||||
"additionalProperties" : 1,
|
||||
"properties" : {
|
||||
"boot-info" : {
|
||||
"description" : "Meta-information about the boot mode.",
|
||||
"properties" : {
|
||||
"mode" : {
|
||||
"description" : "Through which firmware the system got booted.",
|
||||
"enum" : [
|
||||
"efi",
|
||||
"legacy-bios"
|
||||
],
|
||||
"type" : "string"
|
||||
},
|
||||
"secureboot" : {
|
||||
"description" : "System is booted in secure mode, only applicable for the \"efi\" mode.",
|
||||
"optional" : 1,
|
||||
"type" : "boolean"
|
||||
}
|
||||
},
|
||||
"type" : "object"
|
||||
},
|
||||
"current-kernel" : {
|
||||
"description" : "The uptime of the system in seconds.",
|
||||
"properties" : {
|
||||
"machine" : {
|
||||
"description" : "Hardware (architecture) type",
|
||||
"type" : "string"
|
||||
},
|
||||
"release" : {
|
||||
"description" : "OS kernel release (e.g., \"6.8.0\")",
|
||||
"type" : "string"
|
||||
},
|
||||
"sysname" : {
|
||||
"description" : "OS kernel name (e.g., \"Linux\")",
|
||||
"type" : "string"
|
||||
},
|
||||
"version" : {
|
||||
"description" : "OS kernel version with build info",
|
||||
"type" : "string"
|
||||
}
|
||||
},
|
||||
"type" : "object"
|
||||
}
|
||||
},
|
||||
"type" : "object"
|
||||
}
|
||||
},
|
||||
@ -49017,9 +49283,9 @@ const apiSchema = [
|
||||
"default" : "login",
|
||||
"description" : "Run specific command or default to login (requires 'root@pam')",
|
||||
"enum" : [
|
||||
"ceph_install",
|
||||
"login",
|
||||
"upgrade"
|
||||
"upgrade",
|
||||
"ceph_install"
|
||||
],
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
@ -49112,9 +49378,9 @@ const apiSchema = [
|
||||
"default" : "login",
|
||||
"description" : "Run specific command or default to login (requires 'root@pam')",
|
||||
"enum" : [
|
||||
"ceph_install",
|
||||
"login",
|
||||
"upgrade"
|
||||
"upgrade",
|
||||
"ceph_install"
|
||||
],
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
@ -49237,9 +49503,9 @@ const apiSchema = [
|
||||
"default" : "login",
|
||||
"description" : "Run specific command or default to login (requires 'root@pam')",
|
||||
"enum" : [
|
||||
"ceph_install",
|
||||
"login",
|
||||
"upgrade"
|
||||
"upgrade",
|
||||
"ceph_install"
|
||||
],
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
@ -49624,11 +49890,21 @@ const apiSchema = [
|
||||
},
|
||||
"permissions" : {
|
||||
"check" : [
|
||||
"perm",
|
||||
"/",
|
||||
"or",
|
||||
[
|
||||
"Sys.Audit",
|
||||
"Sys.Modify"
|
||||
"perm",
|
||||
"/",
|
||||
[
|
||||
"Sys.Audit",
|
||||
"Sys.Modify"
|
||||
]
|
||||
],
|
||||
[
|
||||
"perm",
|
||||
"/nodes/{node}",
|
||||
[
|
||||
"Sys.AccessNetwork"
|
||||
]
|
||||
]
|
||||
]
|
||||
},
|
||||
@ -50423,7 +50699,7 @@ const apiSchema = [
|
||||
"typetext" : "<boolean>"
|
||||
},
|
||||
"nodes" : {
|
||||
"description" : "List of cluster node names.",
|
||||
"description" : "List of nodes for which the storage configuration applies.",
|
||||
"format" : "pve-node-list",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -50511,7 +50787,14 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"shared" : {
|
||||
"description" : "Mark storage as shared.",
|
||||
"description" : "Indicate that this is a single storage with the same contents on all nodes (or all listed in the 'nodes' option). It will not make the contents of a local storage automatically accessible to other nodes, it just marks an already shared storage as such!",
|
||||
"optional" : 1,
|
||||
"type" : "boolean",
|
||||
"typetext" : "<boolean>"
|
||||
},
|
||||
"skip-cert-verification" : {
|
||||
"default" : "false",
|
||||
"description" : "Disable TLS certificate verification, only enable on fully trusted networks!",
|
||||
"optional" : 1,
|
||||
"type" : "boolean",
|
||||
"typetext" : "<boolean>"
|
||||
@ -50610,6 +50893,7 @@ const apiSchema = [
|
||||
"cephfs",
|
||||
"cifs",
|
||||
"dir",
|
||||
"esxi",
|
||||
"glusterfs",
|
||||
"iscsi",
|
||||
"iscsidirect",
|
||||
@ -50649,6 +50933,7 @@ const apiSchema = [
|
||||
"cephfs",
|
||||
"cifs",
|
||||
"dir",
|
||||
"esxi",
|
||||
"glusterfs",
|
||||
"iscsi",
|
||||
"iscsidirect",
|
||||
@ -50948,7 +51233,7 @@ const apiSchema = [
|
||||
"typetext" : "<boolean>"
|
||||
},
|
||||
"nodes" : {
|
||||
"description" : "List of cluster node names.",
|
||||
"description" : "List of nodes for which the storage configuration applies.",
|
||||
"format" : "pve-node-list",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
@ -51056,7 +51341,14 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"shared" : {
|
||||
"description" : "Mark storage as shared.",
|
||||
"description" : "Indicate that this is a single storage with the same contents on all nodes (or all listed in the 'nodes' option). It will not make the contents of a local storage automatically accessible to other nodes, it just marks an already shared storage as such!",
|
||||
"optional" : 1,
|
||||
"type" : "boolean",
|
||||
"typetext" : "<boolean>"
|
||||
},
|
||||
"skip-cert-verification" : {
|
||||
"default" : "false",
|
||||
"description" : "Disable TLS certificate verification, only enable on fully trusted networks!",
|
||||
"optional" : 1,
|
||||
"type" : "boolean",
|
||||
"typetext" : "<boolean>"
|
||||
@ -51130,6 +51422,7 @@ const apiSchema = [
|
||||
"cephfs",
|
||||
"cifs",
|
||||
"dir",
|
||||
"esxi",
|
||||
"glusterfs",
|
||||
"iscsi",
|
||||
"iscsidirect",
|
||||
@ -51201,6 +51494,7 @@ const apiSchema = [
|
||||
"cephfs",
|
||||
"cifs",
|
||||
"dir",
|
||||
"esxi",
|
||||
"glusterfs",
|
||||
"iscsi",
|
||||
"iscsidirect",
|
||||
@ -51789,11 +52083,13 @@ const apiSchema = [
|
||||
"additionalProperties" : 0,
|
||||
"properties" : {
|
||||
"comment" : {
|
||||
"maxLength" : 2048,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"email" : {
|
||||
"format" : "email-opt",
|
||||
"maxLength" : 254,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
@ -51810,6 +52106,7 @@ const apiSchema = [
|
||||
"type" : "integer"
|
||||
},
|
||||
"firstname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
@ -51824,9 +52121,11 @@ const apiSchema = [
|
||||
"keys" : {
|
||||
"description" : "Keys for two factor auth (yubico).",
|
||||
"optional" : 1,
|
||||
"pattern" : "[0-9a-zA-Z!=]{0,4096}",
|
||||
"type" : "string"
|
||||
},
|
||||
"lastname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
@ -51875,12 +52174,14 @@ const apiSchema = [
|
||||
"typetext" : "<boolean>"
|
||||
},
|
||||
"comment" : {
|
||||
"maxLength" : 2048,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"email" : {
|
||||
"format" : "email-opt",
|
||||
"maxLength" : 254,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
@ -51900,6 +52201,7 @@ const apiSchema = [
|
||||
"typetext" : "<integer> (0 - N)"
|
||||
},
|
||||
"firstname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
@ -51913,10 +52215,11 @@ const apiSchema = [
|
||||
"keys" : {
|
||||
"description" : "Keys for two factor auth (yubico).",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
"pattern" : "[0-9a-zA-Z!=]{0,4096}",
|
||||
"type" : "string"
|
||||
},
|
||||
"lastname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
@ -51984,11 +52287,13 @@ const apiSchema = [
|
||||
"items" : {
|
||||
"properties" : {
|
||||
"comment" : {
|
||||
"maxLength" : 2048,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
"email" : {
|
||||
"format" : "email-opt",
|
||||
"maxLength" : 254,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
@ -52005,6 +52310,7 @@ const apiSchema = [
|
||||
"type" : "integer"
|
||||
},
|
||||
"firstname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
@ -52016,9 +52322,11 @@ const apiSchema = [
|
||||
"keys" : {
|
||||
"description" : "Keys for two factor auth (yubico).",
|
||||
"optional" : 1,
|
||||
"pattern" : "[0-9a-zA-Z!=]{0,4096}",
|
||||
"type" : "string"
|
||||
},
|
||||
"lastname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string"
|
||||
},
|
||||
@ -52096,12 +52404,14 @@ const apiSchema = [
|
||||
"additionalProperties" : 0,
|
||||
"properties" : {
|
||||
"comment" : {
|
||||
"maxLength" : 2048,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"email" : {
|
||||
"format" : "email-opt",
|
||||
"maxLength" : 254,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
@ -52121,6 +52431,7 @@ const apiSchema = [
|
||||
"typetext" : "<integer> (0 - N)"
|
||||
},
|
||||
"firstname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
@ -52134,10 +52445,11 @@ const apiSchema = [
|
||||
"keys" : {
|
||||
"description" : "Keys for two factor auth (yubico).",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
"pattern" : "[0-9a-zA-Z!=]{0,4096}",
|
||||
"type" : "string"
|
||||
},
|
||||
"lastname" : {
|
||||
"maxLength" : 1024,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
@ -52506,6 +52818,10 @@ const apiSchema = [
|
||||
"optional" : 1,
|
||||
"type" : "boolean"
|
||||
},
|
||||
"Sys.AccessNetwork" : {
|
||||
"optional" : 1,
|
||||
"type" : "boolean"
|
||||
},
|
||||
"Sys.Audit" : {
|
||||
"optional" : 1,
|
||||
"type" : "boolean"
|
||||
@ -53030,8 +53346,8 @@ const apiSchema = [
|
||||
"acr-values" : {
|
||||
"description" : "Specifies the Authentication Context Class Reference values that theAuthorization Server is being requested to use for the Auth Request.",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
"pattern" : "^[^\\x00-\\x1F\\x7F <>#\"]*$",
|
||||
"type" : "string"
|
||||
},
|
||||
"autocreate" : {
|
||||
"default" : 0,
|
||||
@ -53383,8 +53699,8 @@ const apiSchema = [
|
||||
"acr-values" : {
|
||||
"description" : "Specifies the Authentication Context Class Reference values that theAuthorization Server is being requested to use for the Auth Request.",
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
"pattern" : "^[^\\x00-\\x1F\\x7F <>#\"]*$",
|
||||
"type" : "string"
|
||||
},
|
||||
"autocreate" : {
|
||||
"default" : 0,
|
||||
@ -53835,7 +54151,7 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"password" : {
|
||||
"description" : "The current password.",
|
||||
"description" : "The current password of the user performing the change.",
|
||||
"maxLength" : 64,
|
||||
"minLength" : 5,
|
||||
"optional" : 1,
|
||||
@ -53973,7 +54289,7 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"password" : {
|
||||
"description" : "The current password.",
|
||||
"description" : "The current password of the user performing the change.",
|
||||
"maxLength" : 64,
|
||||
"minLength" : 5,
|
||||
"optional" : 1,
|
||||
@ -54118,7 +54434,7 @@ const apiSchema = [
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"password" : {
|
||||
"description" : "The current password.",
|
||||
"description" : "The current password of the user performing the change.",
|
||||
"maxLength" : 64,
|
||||
"minLength" : 5,
|
||||
"optional" : 1,
|
||||
@ -54413,6 +54729,14 @@ const apiSchema = [
|
||||
"parameters" : {
|
||||
"additionalProperties" : 0,
|
||||
"properties" : {
|
||||
"confirmation-password" : {
|
||||
"description" : "The current password of the user performing the change.",
|
||||
"maxLength" : 64,
|
||||
"minLength" : 5,
|
||||
"optional" : 1,
|
||||
"type" : "string",
|
||||
"typetext" : "<string>"
|
||||
},
|
||||
"password" : {
|
||||
"description" : "The new password.",
|
||||
"maxLength" : 64,
|
||||
|
||||
@ -14,7 +14,7 @@ The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a spe
|
||||
|
||||
The physical memory address bits that are reported to the guest OS. Should be smaller or equal to the host's. Set to 'host' to use value from host CPU, but note that doing so will break live migration to CPUs with other values.
|
||||
|
||||
`reported-model`: `<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Cascadelake-Server | Cascadelake-Server-noTSX | Cascadelake-Server-v2 | Cascadelake-Server-v4 | Cascadelake-Server-v5 | Conroe | Cooperlake | Cooperlake-v2 | EPYC | EPYC-IBPB | EPYC-Milan | EPYC-Rome | EPYC-Rome-v2 | EPYC-v3 | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | Icelake-Client | Icelake-Client-noTSX | Icelake-Server | Icelake-Server-noTSX | Icelake-Server-v3 | Icelake-Server-v4 | Icelake-Server-v5 | Icelake-Server-v6 | IvyBridge | IvyBridge-IBRS | KnightsMill | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | SapphireRapids | Skylake-Client | Skylake-Client-IBRS | Skylake-Client-noTSX-IBRS | Skylake-Client-v4 | Skylake-Server | Skylake-Server-IBRS | Skylake-Server-noTSX-IBRS | Skylake-Server-v4 | Skylake-Server-v5 | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`)::
|
||||
`reported-model`: `<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Cascadelake-Server | Cascadelake-Server-noTSX | Cascadelake-Server-v2 | Cascadelake-Server-v4 | Cascadelake-Server-v5 | Conroe | Cooperlake | Cooperlake-v2 | EPYC | EPYC-Genoa | EPYC-IBPB | EPYC-Milan | EPYC-Milan-v2 | EPYC-Rome | EPYC-Rome-v2 | EPYC-Rome-v3 | EPYC-Rome-v4 | EPYC-v3 | EPYC-v4 | GraniteRapids | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | Icelake-Client | Icelake-Client-noTSX | Icelake-Server | Icelake-Server-noTSX | Icelake-Server-v3 | Icelake-Server-v4 | Icelake-Server-v5 | Icelake-Server-v6 | IvyBridge | IvyBridge-IBRS | KnightsMill | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | SapphireRapids | SapphireRapids-v2 | Skylake-Client | Skylake-Client-IBRS | Skylake-Client-noTSX-IBRS | Skylake-Client-v4 | Skylake-Server | Skylake-Server-IBRS | Skylake-Server-noTSX-IBRS | Skylake-Server-v4 | Skylake-Server-v5 | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`)::
|
||||
|
||||
CPU model and vendor to report to the guest. Must be a QEMU/KVM supported model. Only valid for custom CPU model definitions, default models will always report themselves to the guest OS.
|
||||
|
||||
|
||||
@ -296,7 +296,7 @@ Get the container's current disk usage.
|
||||
|
||||
The (unique) ID of the VM.
|
||||
|
||||
*pct enter* `<vmid>`
|
||||
*pct enter* `<vmid>` `[OPTIONS]`
|
||||
|
||||
Launch a shell for the specified container.
|
||||
|
||||
@ -304,7 +304,11 @@ Launch a shell for the specified container.
|
||||
|
||||
The (unique) ID of the VM.
|
||||
|
||||
*pct exec* `<vmid> [<extra-args>]`
|
||||
`--keep-env` `<boolean>` ('default =' `1`)::
|
||||
|
||||
Keep the current environment. This option will disabled by default with PVE 9. If you rely on a preserved environment, please use this option to be future-proof.
|
||||
|
||||
*pct exec* `<vmid> [<extra-args>]` `[OPTIONS]`
|
||||
|
||||
Launch a command inside the specified container.
|
||||
|
||||
@ -316,6 +320,10 @@ The (unique) ID of the VM.
|
||||
|
||||
Extra arguments as array
|
||||
|
||||
`--keep-env` `<boolean>` ('default =' `1`)::
|
||||
|
||||
Keep the current environment. This option will disabled by default with PVE 9. If you rely on a preserved environment, please use this option to be future-proof.
|
||||
|
||||
*pct fsck* `<vmid>` `[OPTIONS]`
|
||||
|
||||
Run a filesystem check (fsck) on a container volume.
|
||||
@ -549,7 +557,7 @@ The (unique) ID of the VM.
|
||||
|
||||
The (unique) ID of the VM.
|
||||
|
||||
`<target-endpoint>`: `apitoken=<A full Proxmox API token including the secret value.> ,host=<Remote Proxmox hostname or IP> [,fingerprint=<Remote host's certificate fingerprint, if not trusted by system store.>] [,port=<integer>]` ::
|
||||
`<target-endpoint>`: `apitoken=<user@realm!token=SECRET> ,host=<ADDRESS> [,fingerprint=<FINGERPRINT>] [,port=<PORT>]` ::
|
||||
|
||||
Remote target endpoint
|
||||
|
||||
|
||||
@ -4,7 +4,7 @@
|
||||
|
||||
Create a new storage.
|
||||
|
||||
`<type>`: `<btrfs | cephfs | cifs | dir | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | pbs | rbd | zfs | zfspool>` ::
|
||||
`<type>`: `<btrfs | cephfs | cifs | dir | esxi | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | pbs | rbd | zfs | zfspool>` ::
|
||||
|
||||
Storage type.
|
||||
|
||||
@ -148,7 +148,7 @@ Set the NOCOW flag on files. Disables data checksumming and causes data errors t
|
||||
|
||||
`--nodes` `<string>` ::
|
||||
|
||||
List of cluster node names.
|
||||
List of nodes for which the storage configuration applies.
|
||||
|
||||
`--nowritecache` `<boolean>` ::
|
||||
|
||||
@ -210,7 +210,11 @@ CIFS share.
|
||||
|
||||
`--shared` `<boolean>` ::
|
||||
|
||||
Mark storage as shared.
|
||||
Indicate that this is a single storage with the same contents on all nodes (or all listed in the 'nodes' option). It will not make the contents of a local storage automatically accessible to other nodes, it just marks an already shared storage as such!
|
||||
|
||||
`--skip-cert-verification` `<boolean>` ('default =' `false`)::
|
||||
|
||||
Disable TLS certificate verification, only enable on fully trusted networks!
|
||||
|
||||
`--smbversion` `<2.0 | 2.1 | 3 | 3.0 | 3.11 | default>` ('default =' `default`)::
|
||||
|
||||
@ -708,7 +712,7 @@ Set the NOCOW flag on files. Disables data checksumming and causes data errors t
|
||||
|
||||
`--nodes` `<string>` ::
|
||||
|
||||
List of cluster node names.
|
||||
List of nodes for which the storage configuration applies.
|
||||
|
||||
`--nowritecache` `<boolean>` ::
|
||||
|
||||
@ -758,7 +762,11 @@ NOTE: Requires option(s): `server`
|
||||
|
||||
`--shared` `<boolean>` ::
|
||||
|
||||
Mark storage as shared.
|
||||
Indicate that this is a single storage with the same contents on all nodes (or all listed in the 'nodes' option). It will not make the contents of a local storage automatically accessible to other nodes, it just marks an already shared storage as such!
|
||||
|
||||
`--skip-cert-verification` `<boolean>` ('default =' `false`)::
|
||||
|
||||
Disable TLS certificate verification, only enable on fully trusted networks!
|
||||
|
||||
`--smbversion` `<2.0 | 2.1 | 3 | 3.0 | 3.11 | default>` ('default =' `default`)::
|
||||
|
||||
|
||||
@ -30,11 +30,12 @@ Proxmox VE subscription key
|
||||
|
||||
*pvesubscription set-offline-key* `<data>`
|
||||
|
||||
(Internal use only!) Set a signed subscription info blob as offline key
|
||||
Internal use only! To set an offline key, use the package
|
||||
proxmox-offline-mirror-helper instead.
|
||||
|
||||
`<data>`: `<string>` ::
|
||||
|
||||
no description available
|
||||
A signed subscription info blob
|
||||
|
||||
*pvesubscription update* `[OPTIONS]`
|
||||
|
||||
|
||||
@ -128,7 +128,7 @@ Shows help for a specific command
|
||||
|
||||
Verbose output format.
|
||||
|
||||
*pveum passwd* `<userid>`
|
||||
*pveum passwd* `<userid>` `[OPTIONS]`
|
||||
|
||||
Change user password.
|
||||
|
||||
@ -136,6 +136,10 @@ Change user password.
|
||||
|
||||
Full User ID, in the `name@realm` format.
|
||||
|
||||
`--confirmation-password` `<string>` ::
|
||||
|
||||
The current password of the user performing the change.
|
||||
|
||||
*pveum pool add* `<poolid>` `[OPTIONS]`
|
||||
|
||||
Create new pool.
|
||||
@ -206,7 +210,7 @@ Add an authentication server.
|
||||
|
||||
Authentication domain ID
|
||||
|
||||
`--acr-values` `<string>` ::
|
||||
`--acr-values` `^[^\x00-\x1F\x7F <>#"]*$` ::
|
||||
|
||||
Specifies the Authentication Context Class Reference values that theAuthorization Server is being requested to use for the Auth Request.
|
||||
|
||||
@ -374,7 +378,7 @@ Update authentication server settings.
|
||||
|
||||
Authentication domain ID
|
||||
|
||||
`--acr-values` `<string>` ::
|
||||
`--acr-values` `^[^\x00-\x1F\x7F <>#"]*$` ::
|
||||
|
||||
Specifies the Authentication Context Class Reference values that theAuthorization Server is being requested to use for the Auth Request.
|
||||
|
||||
@ -678,7 +682,7 @@ no description available
|
||||
|
||||
no description available
|
||||
|
||||
`--keys` `<string>` ::
|
||||
`--keys` `[0-9a-zA-Z!=]{0,4096}` ::
|
||||
|
||||
Keys for two factor auth (yubico).
|
||||
|
||||
@ -748,7 +752,7 @@ no description available
|
||||
|
||||
no description available
|
||||
|
||||
`--keys` `<string>` ::
|
||||
`--keys` `[0-9a-zA-Z!=]{0,4096}` ::
|
||||
|
||||
Keys for two factor auth (yubico).
|
||||
|
||||
|
||||
@ -285,9 +285,7 @@ Enable/disable KVM hardware virtualization.
|
||||
|
||||
`--live-restore` `<boolean>` ::
|
||||
|
||||
Start the VM immediately from the backup and restore in background. PBS only.
|
||||
+
|
||||
NOTE: Requires option(s): `archive`
|
||||
Start the VM immediately while importing or restoring in the background.
|
||||
|
||||
`--localtime` `<boolean>` ::
|
||||
|
||||
@ -365,7 +363,7 @@ Configure a VirtIO-based Random Number Generator.
|
||||
|
||||
Use volume as SATA hard disk or CD-ROM (n is 0 to 5). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume.
|
||||
|
||||
`--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
`--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
|
||||
Use volume as SCSI hard disk or CD-ROM (n is 0 to 30). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume.
|
||||
|
||||
@ -711,6 +709,357 @@ Shows help for a specific command
|
||||
|
||||
Verbose output format.
|
||||
|
||||
*qm import* `<vmid> <source> --storage <string>` `[OPTIONS]`
|
||||
|
||||
Import a foreign virtual guest from a supported import source, such as an
|
||||
ESXi storage.
|
||||
|
||||
`<vmid>`: `<integer> (100 - 999999999)` ::
|
||||
|
||||
The (unique) ID of the VM.
|
||||
|
||||
`<source>`: `<string>` ::
|
||||
|
||||
The import source volume id.
|
||||
|
||||
`--acpi` `<boolean>` ('default =' `1`)::
|
||||
|
||||
Enable/disable ACPI.
|
||||
|
||||
`--affinity` `<string>` ::
|
||||
|
||||
List of host cores used to execute guest processes, for example: 0,5,8-11
|
||||
|
||||
`--agent` `[enabled=]<1|0> [,freeze-fs-on-backup=<1|0>] [,fstrim_cloned_disks=<1|0>] [,type=<virtio|isa>]` ::
|
||||
|
||||
Enable/disable communication with the QEMU Guest Agent and its properties.
|
||||
|
||||
`--arch` `<aarch64 | x86_64>` ::
|
||||
|
||||
Virtual processor architecture. Defaults to the host.
|
||||
|
||||
`--args` `<string>` ::
|
||||
|
||||
Arbitrary arguments passed to kvm.
|
||||
|
||||
`--audio0` `device=<ich9-intel-hda|intel-hda|AC97> [,driver=<spice|none>]` ::
|
||||
|
||||
Configure a audio device, useful in combination with QXL/Spice.
|
||||
|
||||
`--autostart` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Automatic restart after crash (currently ignored).
|
||||
|
||||
`--balloon` `<integer> (0 - N)` ::
|
||||
|
||||
Amount of target RAM for the VM in MiB. Using zero disables the ballon driver.
|
||||
|
||||
`--bios` `<ovmf | seabios>` ('default =' `seabios`)::
|
||||
|
||||
Select BIOS implementation.
|
||||
|
||||
`--boot` `[[legacy=]<[acdn]{1,4}>] [,order=<device[;device...]>]` ::
|
||||
|
||||
Specify guest boot order. Use the 'order=' sub-property as usage with no key or 'legacy=' is deprecated.
|
||||
|
||||
`--bootdisk` `(ide|sata|scsi|virtio)\d+` ::
|
||||
|
||||
Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead.
|
||||
|
||||
`--cdrom` `<volume>` ::
|
||||
|
||||
This is an alias for option -ide2
|
||||
|
||||
`--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>] [,vendor=<volume>]` ::
|
||||
|
||||
cloud-init: Specify custom files to replace the automatically generated ones at start.
|
||||
|
||||
`--cipassword` `<string>` ::
|
||||
|
||||
cloud-init: Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.
|
||||
|
||||
`--citype` `<configdrive2 | nocloud | opennebula>` ::
|
||||
|
||||
Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows.
|
||||
|
||||
`--ciupgrade` `<boolean>` ('default =' `1`)::
|
||||
|
||||
cloud-init: do an automatic package upgrade after the first boot.
|
||||
|
||||
`--ciuser` `<string>` ::
|
||||
|
||||
cloud-init: User name to change ssh keys and password for instead of the image's configured default user.
|
||||
|
||||
`--cores` `<integer> (1 - N)` ('default =' `1`)::
|
||||
|
||||
The number of cores per socket.
|
||||
|
||||
`--cpu` `[[cputype=]<string>] [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>] [,phys-bits=<8-64|host>] [,reported-model=<enum>]` ::
|
||||
|
||||
Emulated CPU type.
|
||||
|
||||
`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
|
||||
|
||||
Limit of CPU usage.
|
||||
|
||||
`--cpuunits` `<integer> (1 - 262144)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::
|
||||
|
||||
CPU weight for a VM, will be clamped to [1, 10000] in cgroup v2.
|
||||
|
||||
`--delete` `<string>` ::
|
||||
|
||||
A list of settings you want to delete.
|
||||
|
||||
`--description` `<string>` ::
|
||||
|
||||
Description for the VM. Shown in the web-interface VM's summary. This is saved as comment inside the configuration file.
|
||||
|
||||
`--dryrun` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Show the create command and exit without doing anything.
|
||||
|
||||
`--efidisk0` `[file=]<volume> [,efitype=<2m|4m>] [,format=<enum>] [,pre-enrolled-keys=<1|0>] [,size=<DiskSize>]` ::
|
||||
|
||||
Configure a disk for storing EFI vars.
|
||||
|
||||
`--format` `<qcow2 | raw | vmdk>` ::
|
||||
|
||||
Target format
|
||||
|
||||
`--freeze` `<boolean>` ::
|
||||
|
||||
Freeze CPU at startup (use 'c' monitor command to start execution).
|
||||
|
||||
`--hookscript` `<string>` ::
|
||||
|
||||
Script that will be executed during various steps in the vms lifetime.
|
||||
|
||||
`--hostpci[n]` `[[host=]<HOSTPCIID[;HOSTPCIID2...]>] [,device-id=<hex id>] [,legacy-igd=<1|0>] [,mapping=<mapping-id>] [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,sub-device-id=<hex id>] [,sub-vendor-id=<hex id>] [,vendor-id=<hex id>] [,x-vga=<1|0>]` ::
|
||||
|
||||
Map host PCI devices into guest.
|
||||
|
||||
`--hotplug` `<string>` ('default =' `network,disk,usb`)::
|
||||
|
||||
Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7.
|
||||
|
||||
`--hugepages` `<1024 | 2 | any>` ::
|
||||
|
||||
Enable/disable hugepages memory.
|
||||
|
||||
`--ide[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
|
||||
Use volume as IDE hard disk or CD-ROM (n is 0 to 3).
|
||||
|
||||
`--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::
|
||||
|
||||
cloud-init: Specify IP addresses and gateways for the corresponding interface.
|
||||
+
|
||||
IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
|
||||
+
|
||||
The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit
|
||||
gateway should be provided.
|
||||
For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. This requires
|
||||
cloud-init 19.4 or newer.
|
||||
+
|
||||
If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using
|
||||
dhcp on IPv4.
|
||||
|
||||
`--ivshmem` `size=<integer> [,name=<string>]` ::
|
||||
|
||||
Inter-VM shared memory. Useful for direct communication between VMs, or to the host.
|
||||
|
||||
`--keephugepages` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts.
|
||||
|
||||
`--keyboard` `<da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr>` ::
|
||||
|
||||
Keyboard layout for VNC server. This option is generally not required and is often better handled from within the guest OS.
|
||||
|
||||
`--kvm` `<boolean>` ('default =' `1`)::
|
||||
|
||||
Enable/disable KVM hardware virtualization.
|
||||
|
||||
`--live-import` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Immediately start the VM and copy the data in the background.
|
||||
|
||||
`--localtime` `<boolean>` ::
|
||||
|
||||
Set the real time clock (RTC) to local time. This is enabled by default if the `ostype` indicates a Microsoft Windows OS.
|
||||
|
||||
`--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>` ::
|
||||
|
||||
Lock/unlock the VM.
|
||||
|
||||
`--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)+(\+pve\d+)?(\.pxe)?|q35|pc-q35-\d+(\.\d+)+(\+pve\d+)?(\.pxe)?|virt(?:-\d+(\.\d+)+)?(\+pve\d+)?)` ::
|
||||
|
||||
Specifies the QEMU machine type.
|
||||
|
||||
`--memory` `[current=]<integer>` ::
|
||||
|
||||
Memory properties.
|
||||
|
||||
`--migrate_downtime` `<number> (0 - N)` ('default =' `0.1`)::
|
||||
|
||||
Set maximum tolerated downtime (in seconds) for migrations.
|
||||
|
||||
`--migrate_speed` `<integer> (0 - N)` ('default =' `0`)::
|
||||
|
||||
Set maximum speed (in MB/s) for migrations. Value 0 is no limit.
|
||||
|
||||
`--name` `<string>` ::
|
||||
|
||||
Set a name for the VM. Only used on the configuration web interface.
|
||||
|
||||
`--nameserver` `<string>` ::
|
||||
|
||||
cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
|
||||
|
||||
`--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,mtu=<integer>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,<model>=<macaddr>]` ::
|
||||
|
||||
Specify network devices.
|
||||
|
||||
`--numa` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Enable/disable NUMA.
|
||||
|
||||
`--numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
|
||||
|
||||
NUMA topology.
|
||||
|
||||
`--onboot` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Specifies whether a VM will be started during system bootup.
|
||||
|
||||
`--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win11 | win7 | win8 | wvista | wxp>` ::
|
||||
|
||||
Specify guest operating system.
|
||||
|
||||
`--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::
|
||||
|
||||
Map host parallel devices (n is 0 to 2).
|
||||
|
||||
`--protection` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.
|
||||
|
||||
`--reboot` `<boolean>` ('default =' `1`)::
|
||||
|
||||
Allow reboot. If set to '0' the VM exit on reboot.
|
||||
|
||||
`--rng0` `[source=]</dev/urandom|/dev/random|/dev/hwrng> [,max_bytes=<integer>] [,period=<integer>]` ::
|
||||
|
||||
Configure a VirtIO-based Random Number Generator.
|
||||
|
||||
`--sata[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
|
||||
Use volume as SATA hard disk or CD-ROM (n is 0 to 5).
|
||||
|
||||
`--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
|
||||
Use volume as SCSI hard disk or CD-ROM (n is 0 to 30).
|
||||
|
||||
`--scsihw` `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::
|
||||
|
||||
SCSI controller model
|
||||
|
||||
`--searchdomain` `<string>` ::
|
||||
|
||||
cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
|
||||
|
||||
`--serial[n]` `(/dev/.+|socket)` ::
|
||||
|
||||
Create a serial device inside the VM (n is 0 to 3)
|
||||
|
||||
`--shares` `<integer> (0 - 50000)` ('default =' `1000`)::
|
||||
|
||||
Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd.
|
||||
|
||||
`--smbios1` `[base64=<1|0>] [,family=<Base64 encoded string>] [,manufacturer=<Base64 encoded string>] [,product=<Base64 encoded string>] [,serial=<Base64 encoded string>] [,sku=<Base64 encoded string>] [,uuid=<UUID>] [,version=<Base64 encoded string>]` ::
|
||||
|
||||
Specify SMBIOS type 1 fields.
|
||||
|
||||
`--smp` `<integer> (1 - N)` ('default =' `1`)::
|
||||
|
||||
The number of CPUs. Please use option -sockets instead.
|
||||
|
||||
`--sockets` `<integer> (1 - N)` ('default =' `1`)::
|
||||
|
||||
The number of CPU sockets.
|
||||
|
||||
`--spice_enhancements` `[foldersharing=<1|0>] [,videostreaming=<off|all|filter>]` ::
|
||||
|
||||
Configure additional enhancements for SPICE.
|
||||
|
||||
`--sshkeys` `<string>` ::
|
||||
|
||||
cloud-init: Setup public SSH keys (one key per line, OpenSSH format).
|
||||
|
||||
`--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::
|
||||
|
||||
Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'.
|
||||
|
||||
`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
|
||||
|
||||
Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.
|
||||
|
||||
`--storage` `<string>` ::
|
||||
|
||||
Default storage.
|
||||
|
||||
`--tablet` `<boolean>` ('default =' `1`)::
|
||||
|
||||
Enable/disable the USB tablet device.
|
||||
|
||||
`--tags` `<string>` ::
|
||||
|
||||
Tags of the VM. This is only meta information.
|
||||
|
||||
`--tdf` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Enable/disable time drift fix.
|
||||
|
||||
`--template` `<boolean>` ('default =' `0`)::
|
||||
|
||||
Enable/disable Template.
|
||||
|
||||
`--tpmstate0` `[file=]<volume> [,size=<DiskSize>] [,version=<v1.2|v2.0>]` ::
|
||||
|
||||
Configure a Disk for storing TPM state. The format is fixed to 'raw'.
|
||||
|
||||
`--unused[n]` `[file=]<volume>` ::
|
||||
|
||||
Reference to unused volumes. This is used internally, and should not be modified manually.
|
||||
|
||||
`--usb[n]` `[[host=]<HOSTUSBDEVICE|spice>] [,mapping=<mapping-id>] [,usb3=<1|0>]` ::
|
||||
|
||||
Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14).
|
||||
|
||||
`--vcpus` `<integer> (1 - N)` ('default =' `0`)::
|
||||
|
||||
Number of hotplugged vcpus.
|
||||
|
||||
`--vga` `[[type=]<enum>] [,clipboard=<vnc>] [,memory=<integer>]` ::
|
||||
|
||||
Configure the VGA hardware.
|
||||
|
||||
`--virtio[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::
|
||||
|
||||
Use volume as VIRTIO hard disk (n is 0 to 15).
|
||||
|
||||
`--vmgenid` `<UUID>` ('default =' `1 (autogenerated)`)::
|
||||
|
||||
Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.
|
||||
|
||||
`--vmstatestorage` `<string>` ::
|
||||
|
||||
Default storage for VM state volumes/files.
|
||||
|
||||
`--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::
|
||||
|
||||
Create a virtual hardware watchdog device.
|
||||
|
||||
*qm importdisk*
|
||||
|
||||
An alias for 'qm disk import'.
|
||||
@ -857,7 +1206,7 @@ The (unique) ID of the VM.
|
||||
|
||||
The (unique) ID of the VM.
|
||||
|
||||
`<target-endpoint>`: `apitoken=<A full Proxmox API token including the secret value.> ,host=<Remote Proxmox hostname or IP> [,fingerprint=<Remote host's certificate fingerprint, if not trusted by system store.>] [,port=<integer>]` ::
|
||||
`<target-endpoint>`: `apitoken=<user@realm!token=SECRET> ,host=<ADDRESS> [,fingerprint=<FINGERPRINT>] [,port=<PORT>]` ::
|
||||
|
||||
Remote target endpoint
|
||||
|
||||
@ -1195,7 +1544,7 @@ Configure a VirtIO-based Random Number Generator.
|
||||
|
||||
Use volume as SATA hard disk or CD-ROM (n is 0 to 5). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume.
|
||||
|
||||
`--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
`--scsi[n]` `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,import-from=<source volume>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
|
||||
Use volume as SCSI hard disk or CD-ROM (n is 0 to 30). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume.
|
||||
|
||||
|
||||
@ -157,7 +157,7 @@ The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a spe
|
||||
|
||||
The physical memory address bits that are reported to the guest OS. Should be smaller or equal to the host's. Set to 'host' to use value from host CPU, but note that doing so will break live migration to CPUs with other values.
|
||||
|
||||
`reported-model`=`<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Cascadelake-Server | Cascadelake-Server-noTSX | Cascadelake-Server-v2 | Cascadelake-Server-v4 | Cascadelake-Server-v5 | Conroe | Cooperlake | Cooperlake-v2 | EPYC | EPYC-IBPB | EPYC-Milan | EPYC-Rome | EPYC-Rome-v2 | EPYC-v3 | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | Icelake-Client | Icelake-Client-noTSX | Icelake-Server | Icelake-Server-noTSX | Icelake-Server-v3 | Icelake-Server-v4 | Icelake-Server-v5 | Icelake-Server-v6 | IvyBridge | IvyBridge-IBRS | KnightsMill | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | SapphireRapids | Skylake-Client | Skylake-Client-IBRS | Skylake-Client-noTSX-IBRS | Skylake-Client-v4 | Skylake-Server | Skylake-Server-IBRS | Skylake-Server-noTSX-IBRS | Skylake-Server-v4 | Skylake-Server-v5 | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);;
|
||||
`reported-model`=`<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Cascadelake-Server | Cascadelake-Server-noTSX | Cascadelake-Server-v2 | Cascadelake-Server-v4 | Cascadelake-Server-v5 | Conroe | Cooperlake | Cooperlake-v2 | EPYC | EPYC-Genoa | EPYC-IBPB | EPYC-Milan | EPYC-Milan-v2 | EPYC-Rome | EPYC-Rome-v2 | EPYC-Rome-v3 | EPYC-Rome-v4 | EPYC-v3 | EPYC-v4 | GraniteRapids | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | Icelake-Client | Icelake-Client-noTSX | Icelake-Server | Icelake-Server-noTSX | Icelake-Server-v3 | Icelake-Server-v4 | Icelake-Server-v5 | Icelake-Server-v6 | IvyBridge | IvyBridge-IBRS | KnightsMill | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | SapphireRapids | SapphireRapids-v2 | Skylake-Client | Skylake-Client-IBRS | Skylake-Client-noTSX-IBRS | Skylake-Client-v4 | Skylake-Server | Skylake-Server-IBRS | Skylake-Server-noTSX-IBRS | Skylake-Server-v4 | Skylake-Server-v5 | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);;
|
||||
|
||||
CPU model and vendor to report to the guest. Must be a QEMU/KVM supported model. Only valid for custom CPU model definitions, default models will always report themselves to the guest OS.
|
||||
|
||||
@ -863,7 +863,7 @@ Write error action.
|
||||
|
||||
The drive's worldwide name, encoded as 16 bytes hex string, prefixed by '0x'.
|
||||
|
||||
`scsi[n]`: `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
`scsi[n]`: `[file=]<volume> [,aio=<native|threads|io_uring>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,product=<product>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,ro=<1|0>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,vendor=<vendor>] [,werror=<enum>] [,wwn=<wwn>]` ::
|
||||
|
||||
Use volume as SCSI hard disk or CD-ROM (n is 0 to 30).
|
||||
|
||||
@ -995,6 +995,10 @@ Maximum unthrottled write pool in megabytes per second.
|
||||
|
||||
The drive's media type.
|
||||
|
||||
`product`=`<product>` ;;
|
||||
|
||||
The drive's product name, up to 16 bytes long.
|
||||
|
||||
`queues`=`<integer> (2 - N)` ;;
|
||||
|
||||
Number of queues.
|
||||
@ -1047,6 +1051,10 @@ Whether to expose this drive as an SSD, rather than a rotational hard disk.
|
||||
|
||||
Force disk geometry bios translation mode.
|
||||
|
||||
`vendor`=`<vendor>` ;;
|
||||
|
||||
The drive's vendor name, up to 8 bytes long.
|
||||
|
||||
`werror`=`<enospc | ignore | report | stop>` ;;
|
||||
|
||||
Write error action.
|
||||
@ -1226,7 +1234,7 @@ You can also run without any graphic card, using a serial device as terminal.
|
||||
|
||||
`clipboard`=`<vnc>` ;;
|
||||
|
||||
Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added.
|
||||
Enable a specific clipboard. If not set, depending on the display type the SPICE one will be added. Migration with VNC clipboard is not yet supported!
|
||||
|
||||
`memory`=`<integer> (4 - 512)` ;;
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@ Exclude specified guest systems (assumes --all)
|
||||
|
||||
`--exclude-path` `<array>` ::
|
||||
|
||||
Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.
|
||||
Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.
|
||||
|
||||
`--ionice` `<integer> (0 - 8)` ('default =' `7`)::
|
||||
|
||||
@ -42,11 +42,11 @@ Maximal time to wait for the global lock (minutes).
|
||||
|
||||
`--mailnotification` `<always | failure>` ('default =' `always`)::
|
||||
|
||||
Deprecated: use 'notification-policy' instead.
|
||||
Deprecated: use notification targets/matchers instead. Specify when to send a notification mail
|
||||
|
||||
`--mailto` `<string>` ::
|
||||
|
||||
Comma-separated list of email addresses or users that should receive email notifications. Has no effect if the 'notification-target' option is set at the same time.
|
||||
Deprecated: Use notification targets/matchers instead. Comma-separated list of email addresses or users that should receive email notifications.
|
||||
|
||||
`--maxfiles` `<integer> (1 - N)` ::
|
||||
|
||||
@ -66,13 +66,17 @@ Template string for generating notes for the backup(s). It can contain variables
|
||||
+
|
||||
NOTE: Requires option(s): `storage`
|
||||
|
||||
`--notification-mode` `<auto | legacy-sendmail | notification-system>` ('default =' `auto`)::
|
||||
|
||||
Determine which notification system to use. If set to 'legacy-sendmail', vzdump will consider the mailto/mailnotification parameters and send emails to the specified address(es) via the 'sendmail' command. If set to 'notification-system', a notification will be sent via PVE's notification system, and the mailto and mailnotification will be ignored. If set to 'auto' (default setting), an email will be sent if mailto is set, and the notification system will be used if not.
|
||||
|
||||
`--notification-policy` `<always | failure | never>` ('default =' `always`)::
|
||||
|
||||
Specify when to send a notification
|
||||
Deprecated: Do not use
|
||||
|
||||
`--notification-target` `<string>` ::
|
||||
|
||||
Determine the target to which notifications should be sent. Can either be a notification endpoint or a notification group. This option takes precedence over 'mailto', meaning that if both are set, the 'mailto' option will be ignored.
|
||||
Deprecated: Do not use
|
||||
|
||||
`--performance` `[max-workers=<integer>] [,pbs-entries-max=<integer>]` ::
|
||||
|
||||
@ -134,5 +138,5 @@ Store temporary files to specified directory.
|
||||
|
||||
`--zstd` `<integer>` ('default =' `1`)::
|
||||
|
||||
Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.
|
||||
Zstd threads. N=0 uses half of the available cores, if N is set to a value bigger than 0, N is used as thread count.
|
||||
|
||||
|
||||
@ -12,7 +12,7 @@ Store resulting files to specified directory.
|
||||
|
||||
`exclude-path`: `<array>` ::
|
||||
|
||||
Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.
|
||||
Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.
|
||||
|
||||
`ionice`: `<integer> (0 - 8)` ('default =' `7`)::
|
||||
|
||||
@ -24,11 +24,11 @@ Maximal time to wait for the global lock (minutes).
|
||||
|
||||
`mailnotification`: `<always | failure>` ('default =' `always`)::
|
||||
|
||||
Deprecated: use 'notification-policy' instead.
|
||||
Deprecated: use notification targets/matchers instead. Specify when to send a notification mail
|
||||
|
||||
`mailto`: `<string>` ::
|
||||
|
||||
Comma-separated list of email addresses or users that should receive email notifications. Has no effect if the 'notification-target' option is set at the same time.
|
||||
Deprecated: Use notification targets/matchers instead. Comma-separated list of email addresses or users that should receive email notifications.
|
||||
|
||||
`maxfiles`: `<integer> (1 - N)` ::
|
||||
|
||||
@ -44,13 +44,17 @@ Template string for generating notes for the backup(s). It can contain variables
|
||||
+
|
||||
NOTE: Requires option(s): `storage`
|
||||
|
||||
`notification-mode`: `<auto | legacy-sendmail | notification-system>` ('default =' `auto`)::
|
||||
|
||||
Determine which notification system to use. If set to 'legacy-sendmail', vzdump will consider the mailto/mailnotification parameters and send emails to the specified address(es) via the 'sendmail' command. If set to 'notification-system', a notification will be sent via PVE's notification system, and the mailto and mailnotification will be ignored. If set to 'auto' (default setting), an email will be sent if mailto is set, and the notification system will be used if not.
|
||||
|
||||
`notification-policy`: `<always | failure | never>` ('default =' `always`)::
|
||||
|
||||
Specify when to send a notification
|
||||
Deprecated: Do not use
|
||||
|
||||
`notification-target`: `<string>` ::
|
||||
|
||||
Determine the target to which notifications should be sent. Can either be a notification endpoint or a notification group. This option takes precedence over 'mailto', meaning that if both are set, the 'mailto' option will be ignored.
|
||||
Deprecated: Do not use
|
||||
|
||||
`performance`: `[max-workers=<integer>] [,pbs-entries-max=<integer>]` ::
|
||||
|
||||
@ -136,5 +140,5 @@ Store temporary files to specified directory.
|
||||
|
||||
`zstd`: `<integer>` ('default =' `1`)::
|
||||
|
||||
Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.
|
||||
Zstd threads. N=0 uses half of the available cores, if N is set to a value bigger than 0, N is used as thread count.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user