maxhoesel.proxmox.pbs_acl (5.0.1) — module

Manage ACLs on a Proxmox Backup Server

| "added in version" 4.0.0 of maxhoesel.proxmox"

Authors: Max Hösel (@maxhoesel)

Install collection

Install with ansible-galaxy collection install maxhoesel.proxmox:==5.0.1


Add to requirements.yml

  collections:
    - name: maxhoesel.proxmox
      version: 5.0.1

Description

Create, update and delete ACLs for users/tokens on a Proxmox Backup Server


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: ACL for user john is present
  maxhoesel.proxmox.pbs_acl:
    api_user: root@pam
    api_password: secret
    api_host: helldorado
    path: /datastore/backup1
    role: DatastoreBackup
    auth_id: john@pbs

Inputs

    
path:
    description: Access control path.
    required: true
    type: str

role:
    description: 'Role name to be assigned to the ACL. Example: DatastoreAdmin

      '
    required: true
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description: Whether this ACL should be C(present) or C(absent)
    type: str

auth_id:
    description: 'Authentication ID to assign the ACL to. Example: C(john@pbs)

      '
    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

propagate:
    description: Propagate this ACL so subdirectories (inherit this ACL)
    type: bool

api_password:
    description:
    - Specify the password to authenticate with.
    - You can also use the C(PROXMOX_PASSWORD) environment variable.
    type: str

validate_certs:
    default: false
    description:
    - Validate SSL certificate of the PVE host upon connecting
    type: bool