community / community.general / 8.5.0 / module / proxmox_pool Pool management for Proxmox VE cluster | "added in version" 7.1.0 of community.general" Authors: Sergei Antipov (@UnderGreen) <greendayonfire@gmail.com>community.general.proxmox_pool (8.5.0) — module
Install with ansible-galaxy collection install community.general:==8.5.0
collections: - name: community.general version: 8.5.0
Create or delete a pool for Proxmox VE clusters.
For pool members management please consult M(community.general.proxmox_pool_member) module.
- name: Create new Proxmox VE pool community.general.proxmox_pool: api_host: node1 api_user: root@pam api_password: password poolid: test comment: 'New pool'
- name: Delete the Proxmox VE pool community.general.proxmox_pool: api_host: node1 api_user: root@pam api_password: password poolid: test state: absent
state: choices: - present - absent default: present description: - Indicate desired state of the pool. - The pool must be empty prior deleting it with O(state=absent). type: str poolid: aliases: - name description: - The pool ID. required: true type: str comment: description: - Specify the description for the pool. - Parameter is ignored when pool already exists or O(state=absent). type: str api_host: description: - Specify the target host of the Proxmox VE cluster. required: true type: str api_user: description: - Specify the user to authenticate with. required: true type: str api_password: description: - Specify the password to authenticate with. - You can use E(PROXMOX_PASSWORD) environment variable. type: str api_token_id: description: - Specify the token ID. - Requires C(proxmoxer>=1.1.0) to work. type: str version_added: 1.3.0 version_added_collection: community.general validate_certs: default: false description: - If V(false), SSL certificates will not be validated. - This should only be used on personally controlled sites using self-signed certificates. type: bool api_token_secret: description: - Specify the token secret. - Requires C(proxmoxer>=1.1.0) to work. type: str version_added: 1.3.0 version_added_collection: community.general
msg: description: A short message on what the module did. returned: always sample: Pool test successfully created type: str poolid: description: The pool ID. returned: success sample: test type: str