Skip to content

pools ​

7 operations.

GET /pools ​

ts
proxmox.pools.$get()

List pools or get pool configuration.

Returns an array of object.

ParameterTypeRequiredNotes
poolidstringformat pve-poolid
typeqemu | lxc | storage

POST /pools ​

ts
proxmox.pools.$post()

Create new pool.

Returns nothing.

ParameterTypeRequiredNotes
commentstring
poolidstringyesformat pve-poolid

PUT /pools ​

ts
proxmox.pools.$put()

Update pool.

Returns nothing.

ParameterTypeRequiredNotes
allow-movebooleanAllow adding a guest even if already in another pool. The guest will be removed from its current pool and added to this one. — default 0
commentstring
deletebooleanRemove the passed VMIDs and/or storage IDs instead of adding them. — default 0
poolidstringyesformat pve-poolid
storagestringList of storage IDs to add or remove from this pool. — format pve-storage-id-list
vmsstringList of guest VMIDs to add or remove from this pool. — format pve-vmid-list

DELETE /pools ​

ts
proxmox.pools.$delete()

Delete pool.

Returns nothing.

ParameterTypeRequiredNotes
poolidstringyesformat pve-poolid

GET /pools/{poolid} ​

ts
proxmox.pools.$(poolid).$get()

Get pool configuration (deprecated, no support for nested pools, use 'GET /pools/?poolid={poolid}').

Returns object.

ParameterTypeRequiredNotes
poolidstringyesformat pve-poolid
typeqemu | lxc | storage

PUT /pools/{poolid} ​

ts
proxmox.pools.$(poolid).$put()

Update pool data (deprecated, no support for nested pools - use 'PUT /pools/?poolid={poolid}' instead).

Returns nothing.

ParameterTypeRequiredNotes
allow-movebooleanAllow adding a guest even if already in another pool. The guest will be removed from its current pool and added to this one. — default 0
commentstring
deletebooleanRemove the passed VMIDs and/or storage IDs instead of adding them. — default 0
poolidstringyesformat pve-poolid
storagestringList of storage IDs to add or remove from this pool. — format pve-storage-id-list
vmsstringList of guest VMIDs to add or remove from this pool. — format pve-vmid-list

DELETE /pools/{poolid} ​

ts
proxmox.pools.$(poolid).$delete()

Delete pool (deprecated, no support for nested pools, use 'DELETE /pools/?poolid={poolid}').

Returns nothing.

ParameterTypeRequiredNotes
poolidstringyesformat pve-poolid