Create a new storage.
-`<type>`: `<dir | drbd | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | rbd | sheepdog | zfs | zfspool>` ::
+`<type>`: `<cephfs | cifs | dir | drbd | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | pbs | rbd | zfs | zfspool>` ::
Storage type.
The storage identifier.
-`-authsupported` `<string>` ::
+`--authsupported` `<string>` ::
Authsupported.
-`-base` `<string>` ::
+`--base` `<string>` ::
Base volume. This volume is automatically activated.
-`-blocksize` `<string>` ::
+`--blocksize` `<string>` ::
block size
-`-comstar_hg` `<string>` ::
+`--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
+
+Set bandwidth/io limits various operations.
+
+`--comstar_hg` `<string>` ::
host group for comstar views
-`-comstar_tg` `<string>` ::
+`--comstar_tg` `<string>` ::
target group for comstar views
-`-content` `<string>` ::
+`--content` `<string>` ::
Allowed content types.
+
NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
-`-disable` `<boolean>` ::
+`--datastore` `<string>` ::
+
+Proxmox Backup Server datastore name.
+
+`--disable` `<boolean>` ::
Flag to disable the storage.
-`-export` `<string>` ::
+`--domain` `<string>` ::
+
+CIFS domain.
+
+`--encryption-key` `a file containing an encryption key, or the special value "autogen"` ::
+
+Encryption key. Use 'autogen' to generate one automatically without passphrase.
+
+`--export` `<string>` ::
NFS export path.
-`-format` `<string>` ::
+`--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
+
+Certificate SHA 256 fingerprint.
+
+`--format` `<string>` ::
Default image format.
-`-is_mountpoint` `<boolean>` ('default =' `no`)::
+`--fuse` `<boolean>` ::
+
+Mount CephFS through FUSE.
-Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline.
+`--is_mountpoint` `<string>` ('default =' `no`)::
-`-iscsiprovider` `<string>` ::
+Assume the given path is an externally managed mountpoint and consider the storage offline if it is not mounted. Using a boolean (yes/no) value serves as a shortcut to using the target path in this field.
+
+`--iscsiprovider` `<string>` ::
iscsi provider
-`-krbd` `<boolean>` ::
+`--krbd` `<boolean>` ::
+
+Always access rbd through krbd kernel module.
+
+`--lio_tpg` `<string>` ::
-Access rbd through krbd kernel module.
+target portal group for Linux LIO targets
-`-maxfiles` `<integer> (0 - N)` ::
+`--maxfiles` `<integer> (0 - N)` ::
Maximal number of backup files per VM. Use '0' for unlimted.
-`-mkdir` `<boolean>` ('default =' `yes`)::
+`--mkdir` `<boolean>` ('default =' `yes`)::
Create the directory if it doesn't exist.
-`-monhost` `<string>` ::
+`--monhost` `<string>` ::
+
+IP addresses of monitors (for external clusters).
+
+`--mountpoint` `<string>` ::
-Monitors daemon ips.
+mount point
-`-nodes` `<string>` ::
+`--nodes` `<string>` ::
List of cluster node names.
-`-nowritecache` `<boolean>` ::
+`--nowritecache` `<boolean>` ::
disable write caching on the target
-`-options` `<string>` ::
+`--options` `<string>` ::
NFS mount options (see 'man nfs')
-`-path` `<string>` ::
+`--password` `<password>` ::
+
+Password for accessing the share/datastore.
+
+`--path` `<string>` ::
File system path.
-`-pool` `<string>` ::
+`--pool` `<string>` ::
Pool.
-`-portal` `<string>` ::
+`--port` `<integer> (1 - 65535)` ('default =' `8007`)::
+
+For non default port.
+
+`--portal` `<string>` ::
iSCSI portal (IP or DNS name with optional port).
-`-redundancy` `<integer> (1 - 16)` ('default =' `2`)::
+`--prune-backups` `[keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]` ::
+
+The retention options with shorter intervals are processed first with --keep-last being the very first one. Each option covers a specific period of time. We say that backups within this period are covered by this option. The next option does not take care of already covered backups and only considers older backups.
+
+`--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
-`-saferemove` `<boolean>` ::
+`--saferemove` `<boolean>` ::
Zero-out data when removing LVs.
-`-saferemove_throughput` `<string>` ::
+`--saferemove_throughput` `<string>` ::
Wipe throughput (cstream -t parameter value).
-`-server` `<string>` ::
+`--server` `<string>` ::
Server IP or DNS name.
-`-server2` `<string>` ::
+`--server2` `<string>` ::
Backup volfile server IP or DNS name.
+
NOTE: Requires option(s): `server`
-`-shared` `<boolean>` ::
+`--share` `<string>` ::
+
+CIFS share.
+
+`--shared` `<boolean>` ::
Mark storage as shared.
-`-sparse` `<boolean>` ::
+`--smbversion` `<2.0 | 2.1 | 3.0>` ::
+
+SMB protocol version
+
+`--sparse` `<boolean>` ::
use sparse volumes
-`-tagged_only` `<boolean>` ::
+`--subdir` `<string>` ::
+
+Subdir to mount.
+
+`--tagged_only` `<boolean>` ::
Only use logical volumes tagged with 'pve-vm-ID'.
-`-target` `<string>` ::
+`--target` `<string>` ::
iSCSI target.
-`-thinpool` `<string>` ::
+`--thinpool` `<string>` ::
LVM thin pool LV name.
-`-transport` `<rdma | tcp | unix>` ::
+`--transport` `<rdma | tcp | unix>` ::
Gluster transport: tcp or rdma
-`-username` `<string>` ::
+`--username` `<string>` ::
RBD Id.
-`-vgname` `<string>` ::
+`--vgname` `<string>` ::
Volume group name.
-`-volume` `<string>` ::
+`--volume` `<string>` ::
Glusterfs Volume.
-
-
-
*pvesm alloc* `<storage> <vmid> <filename> <size>` `[OPTIONS]`
Allocate disk images.
Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M)
-`-format` `<qcow2 | raw | subvol>` ::
+`--format` `<qcow2 | raw | subvol>` ::
no description available
+
NOTE: Requires option(s): `size`
+*pvesm apiinfo*
+Returns APIVER and APIAGE.
+*pvesm cifsscan*
+
+An alias for 'pvesm scan cifs'.
*pvesm export* `<volume> <format> <filename>` `[OPTIONS]`
-Export a volume.
+Used internally to export a volume.
`<volume>`: `<string>` ::
Destination file name
-`-base` `(?^:[a-z0-9_\-]{1,40})` ::
+`--base` `(?^:[a-z0-9_\-]{1,40})` ::
Snapshot to start an incremental stream from
-`-snapshot` `(?^:[a-z0-9_\-]{1,40})` ::
+`--snapshot` `(?^:[a-z0-9_\-]{1,40})` ::
Snapshot to export
-`-with-snapshots` `<boolean>` ('default =' `0`)::
+`--with-snapshots` `<boolean>` ('default =' `0`)::
Whether to include intermediate snapshots in the stream
-
-
*pvesm extractconfig* `<volume>`
Extract configuration from vzdump backup archive.
Volume identifier
-
-
-
*pvesm free* `<volume>` `[OPTIONS]`
Delete volume
Volume identifier
-`-storage` `<string>` ::
-
-The storage identifier.
-
-
+`--delay` `<integer> (1 - 30)` ::
+Time to wait for the task to finish. We return 'null' if the task finish within that time.
-*pvesm glusterfsscan* `<server>`
-
-Scan remote GlusterFS server.
-
-`<server>`: `<string>` ::
-
-no description available
+`--storage` `<string>` ::
+The storage identifier.
+*pvesm glusterfsscan*
+An alias for 'pvesm scan glusterfs'.
-*pvesm help* `[<cmd>]` `[OPTIONS]`
+*pvesm help* `[OPTIONS]`
Get help about specified command.
-`<cmd>`: `<string>` ::
+`--extra-args` `<array>` ::
-Command name
+Shows help for a specific command
-`-verbose` `<boolean>` ::
+`--verbose` `<boolean>` ::
Verbose output format.
-
-
-
*pvesm import* `<volume> <format> <filename>` `[OPTIONS]`
-Import a volume.
+Used internally to import a volume.
`<volume>`: `<string>` ::
`<filename>`: `<string>` ::
-Source file name
+Source file name. For '-' stdin is used, the tcp://<IP-or-CIDR> format allows to use a TCP connection as input. Else, the file is treated as common file.
+
+`--allow-rename` `<boolean>` ('default =' `0`)::
-`-base` `(?^:[a-z0-9_\-]{1,40})` ::
+Choose a new volume ID if the requested volume ID already exists, instead of throwing an error.
+
+`--base` `(?^:[a-z0-9_\-]{1,40})` ::
Base snapshot of an incremental stream
-`-delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` ::
+`--delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` ::
A snapshot to delete on success
-`-with-snapshots` `<boolean>` ('default =' `0`)::
+`--with-snapshots` `<boolean>` ('default =' `0`)::
Whether the stream includes intermediate snapshots
+*pvesm iscsiscan*
+An alias for 'pvesm scan iscsi'.
+*pvesm list* `<storage>` `[OPTIONS]`
-*pvesm iscsiscan* `-portal <string>` `[OPTIONS]`
+List storage content.
-Scan remote iSCSI server.
+`<storage>`: `<string>` ::
-`-portal` `<string>` ::
+The storage identifier.
-no description available
+`--content` `<string>` ::
+Only list content of this type.
+`--vmid` `<integer> (1 - N)` ::
+Only list images for this VM
-*pvesm list* `<storage>` `[OPTIONS]`
+*pvesm lvmscan*
-List storage content.
+An alias for 'pvesm scan lvm'.
-`<storage>`: `<string>` ::
+*pvesm lvmthinscan*
-The storage identifier.
+An alias for 'pvesm scan lvmthin'.
-`-content` `<string>` ::
+*pvesm nfsscan*
-Only list content of this type.
+An alias for 'pvesm scan nfs'.
-`-vmid` `<integer> (1 - N)` ::
+*pvesm path* `<volume>`
-Only list images for this VM
+Get filesystem path for specified volume
+`<volume>`: `<string>` ::
+Volume identifier
+*pvesm prune-backups* `<storage>` `[OPTIONS]`
-*pvesm lvmscan*
+Prune backups. Only those using the standard naming scheme are considered.
+If no keep options are specified, those from the storage configuration are
+used.
-List local LVM volume groups.
+`<storage>`: `<string>` ::
+The storage identifier.
+`--dry-run` `<boolean>` ::
-*pvesm lvmthinscan* `<vg>`
+Only show what would be pruned, don't delete anything.
-List local LVM Thin Pools.
+`--keep-all` `<boolean>` ::
-`<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
+Keep all backups. Conflicts with the other options when true.
-no description available
+`--keep-daily` `<N>` ::
+Keep backups for the last <N> different days. If there is morethan one backup for a single day, only the latest one is kept.
+`--keep-hourly` `<N>` ::
-*pvesm nfsscan* `<server>`
+Keep backups for the last <N> different hours. If there is morethan one backup for a single hour, only the latest one is kept.
-Scan remote NFS server.
+`--keep-last` `<N>` ::
-`<server>`: `<string>` ::
+Keep the last <N> backups.
-no description available
+`--keep-monthly` `<N>` ::
+Keep backups for the last <N> different months. If there is morethan one backup for a single month, only the latest one is kept.
+`--keep-weekly` `<N>` ::
+Keep backups for the last <N> different weeks. If there is morethan one backup for a single week, only the latest one is kept.
-*pvesm path* `<volume>`
-
-Get filesystem path for specified volume
+`--keep-yearly` `<N>` ::
-`<volume>`: `<string>` ::
+Keep backups for the last <N> different years. If there is morethan one backup for a single year, only the latest one is kept.
-Volume identifier
+`--type` `<lxc | qemu>` ::
+Either 'qemu' or 'lxc'. Only consider backups for guests of this type.
+`--vmid` `<integer> (1 - N)` ::
+Only consider backups for this guest.
*pvesm remove* `<storage>`
The storage identifier.
+*pvesm scan cifs* `<server>` `[OPTIONS]`
+
+Scan remote CIFS server.
+
+`<server>`: `<string>` ::
+
+The server address (name or IP).
+
+`--domain` `<string>` ::
+
+SMB domain (Workgroup).
+
+`--password` `<password>` ::
+
+User password.
+
+`--username` `<string>` ::
+
+User name.
+
+*pvesm scan glusterfs* `<server>`
+
+Scan remote GlusterFS server.
+
+`<server>`: `<string>` ::
+
+The server address (name or IP).
+
+*pvesm scan iscsi* `<portal>`
+
+Scan remote iSCSI server.
+
+`<portal>`: `<string>` ::
+
+The iSCSI portal (IP or DNS name with optional port).
+
+*pvesm scan lvm*
+
+List local LVM volume groups.
+
+*pvesm scan lvmthin* `<vg>`
+
+List local LVM Thin Pools.
+
+`<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
+
+no description available
+
+*pvesm scan nfs* `<server>`
+
+Scan remote NFS server.
+
+`<server>`: `<string>` ::
+The server address (name or IP).
+
+*pvesm scan zfs*
+
+Scan zfs pool list on local node.
*pvesm set* `<storage>` `[OPTIONS]`
The storage identifier.
-`-blocksize` `<string>` ::
+`--blocksize` `<string>` ::
block size
-`-comstar_hg` `<string>` ::
+`--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
+
+Set bandwidth/io limits various operations.
+
+`--comstar_hg` `<string>` ::
host group for comstar views
-`-comstar_tg` `<string>` ::
+`--comstar_tg` `<string>` ::
target group for comstar views
-`-content` `<string>` ::
+`--content` `<string>` ::
Allowed content types.
+
NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
-`-delete` `<string>` ::
+`--delete` `<string>` ::
A list of settings you want to delete.
-`-digest` `<string>` ::
+`--digest` `<string>` ::
Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
-`-disable` `<boolean>` ::
+`--disable` `<boolean>` ::
Flag to disable the storage.
-`-format` `<string>` ::
+`--domain` `<string>` ::
+
+CIFS domain.
+
+`--encryption-key` `a file containing an encryption key, or the special value "autogen"` ::
+
+Encryption key. Use 'autogen' to generate one automatically without passphrase.
+
+`--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
+
+Certificate SHA 256 fingerprint.
+
+`--format` `<string>` ::
Default image format.
-`-is_mountpoint` `<boolean>` ('default =' `no`)::
+`--fuse` `<boolean>` ::
+
+Mount CephFS through FUSE.
+
+`--is_mountpoint` `<string>` ('default =' `no`)::
+
+Assume the given path is an externally managed mountpoint and consider the storage offline if it is not mounted. Using a boolean (yes/no) value serves as a shortcut to using the target path in this field.
+
+`--krbd` `<boolean>` ::
-Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline.
+Always access rbd through krbd kernel module.
-`-krbd` `<boolean>` ::
+`--lio_tpg` `<string>` ::
-Access rbd through krbd kernel module.
+target portal group for Linux LIO targets
-`-maxfiles` `<integer> (0 - N)` ::
+`--maxfiles` `<integer> (0 - N)` ::
Maximal number of backup files per VM. Use '0' for unlimted.
-`-mkdir` `<boolean>` ('default =' `yes`)::
+`--mkdir` `<boolean>` ('default =' `yes`)::
Create the directory if it doesn't exist.
-`-nodes` `<string>` ::
+`--monhost` `<string>` ::
+
+IP addresses of monitors (for external clusters).
+
+`--mountpoint` `<string>` ::
+
+mount point
+
+`--nodes` `<string>` ::
List of cluster node names.
-`-nowritecache` `<boolean>` ::
+`--nowritecache` `<boolean>` ::
disable write caching on the target
-`-options` `<string>` ::
+`--options` `<string>` ::
NFS mount options (see 'man nfs')
-`-pool` `<string>` ::
+`--password` `<password>` ::
+
+Password for accessing the share/datastore.
+
+`--pool` `<string>` ::
Pool.
-`-redundancy` `<integer> (1 - 16)` ('default =' `2`)::
+`--port` `<integer> (1 - 65535)` ('default =' `8007`)::
+
+For non default port.
+
+`--prune-backups` `[keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]` ::
+
+The retention options with shorter intervals are processed first with --keep-last being the very first one. Each option covers a specific period of time. We say that backups within this period are covered by this option. The next option does not take care of already covered backups and only considers older backups.
+
+`--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
-`-saferemove` `<boolean>` ::
+`--saferemove` `<boolean>` ::
Zero-out data when removing LVs.
-`-saferemove_throughput` `<string>` ::
+`--saferemove_throughput` `<string>` ::
Wipe throughput (cstream -t parameter value).
-`-server` `<string>` ::
+`--server` `<string>` ::
Server IP or DNS name.
-`-server2` `<string>` ::
+`--server2` `<string>` ::
Backup volfile server IP or DNS name.
+
NOTE: Requires option(s): `server`
-`-shared` `<boolean>` ::
+`--shared` `<boolean>` ::
Mark storage as shared.
-`-sparse` `<boolean>` ::
+`--smbversion` `<2.0 | 2.1 | 3.0>` ::
+
+SMB protocol version
+
+`--sparse` `<boolean>` ::
use sparse volumes
-`-tagged_only` `<boolean>` ::
+`--subdir` `<string>` ::
+
+Subdir to mount.
+
+`--tagged_only` `<boolean>` ::
Only use logical volumes tagged with 'pve-vm-ID'.
-`-transport` `<rdma | tcp | unix>` ::
+`--transport` `<rdma | tcp | unix>` ::
Gluster transport: tcp or rdma
-`-username` `<string>` ::
+`--username` `<string>` ::
RBD Id.
-
-
-
*pvesm status* `[OPTIONS]`
Get status for all datastores.
-`-content` `<string>` ::
+`--content` `<string>` ::
Only list stores which support this content type.
-`-enabled` `<boolean>` ('default =' `0`)::
+`--enabled` `<boolean>` ('default =' `0`)::
Only list stores which are enabled (not disabled in config).
-`-storage` `<string>` ::
+`--format` `<boolean>` ('default =' `0`)::
-Only list status for specified storage
+Include information about formats
-`-target` `<string>` ::
-
-If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
+`--storage` `<string>` ::
+Only list status for specified storage
+`--target` `<string>` ::
+If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
*pvesm zfsscan*
-Scan zfs pool list on local node.
-
-
+An alias for 'pvesm scan zfs'.
projects / pve-docs.git / blobdiff