devopsarr.whisparr.whisparr_root_folder module – Manages Whisparr root folder.

Note

This module is part of the devopsarr.whisparr collection (version 0.1.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install devopsarr.whisparr.

To use it in a playbook, specify: devopsarr.whisparr.whisparr_root_folder.

New in devopsarr.whisparr 0.0.1

Synopsis

  • Manages Whisparr root folder.

Parameters

Parameter

Comments

path

string / required

Actual root folder.

state

string

Create or delete a root_folder.

Choices:

  • "present" ← (default)

  • "absent"

whisparr_api_key

string / required

API key for Whisparr authentication.

whisparr_url

string / required

Full Whisparr URL with protocol and port (e.g. `https://test.whisparr.tv:7878`)

Notes

Note

  • for authentication, you can set service_account_file using the c(WHISPARR_URL) env variable.

  • for authentication, you can set service_account_contents using the c(WHISPARR_API_KEY) env variable.

Examples

# Create a root folder
- name: Create a root folder
  devopsarr.whisparr.root_folder:
    path: '/series'

# Delete a root folder
- name: Delete a root_folder
  devopsarr.whisparr.root_folder:
    path: '/series'
    state: absent

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

accessible

string

Access flag.

Returned: on create/update

Sample: "true"

id

integer

root folder ID.

Returned: always

Sample: 1

path

string

The root folder path.

Returned: on create/update

Sample: "/series"

unmapped_folders

dictionary

List of unmapped folders

Returned: always

Sample: "[]"

Authors

  • Fuochi (@Fuochi)