devopsarr.prowlarr.prowlarr_download_client module – Manages Prowlarr download client.

Note

This module is part of the devopsarr.prowlarr collection (version 1.0.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.prowlarr.

To use it in a playbook, specify: devopsarr.prowlarr.prowlarr_download_client.

New in devopsarr.prowlarr 1.0.0

Synopsis

  • Manages Prowlarr download client.

Parameters

Parameter

Comments

categories

list / elements=dictionary

List of mapped categories.

Default: []

categories

list / elements=integer

Mapped category list.

client_category

string

Client category name.

config_contract

string

Config contract.

enable

boolean

Enable flag.

Choices:

  • false

  • true

fields

list / elements=dictionary

Configuration field list.

name

string

Field name.

value

any

Field value.

implementation

string

Implementation.

name

string / required

Name.

priority

integer

Priority.

protocol

string

Protocol.

Choices:

  • "torrent"

  • "usenet"

prowlarr_api_key

string / required

API key for Prowlarr authentication.

prowlarr_url

string / required

Full Prowlarr URL with protocol and port (e.g. `https://test.prowlarr.tv:9696`)

state

string

Create or delete resource.

Choices:

  • "present" ← (default)

  • "absent"

tags

list / elements=integer

Tag list.

Default: []

update_secrets

boolean

Flag to force update of secret fields.

Choices:

  • false ← (default)

  • true

Notes

Note

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

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

Examples

---
# Create a download client
- name: Create a download client
  devopsarr.prowlarr.prowlarr_download_client:
    enable: false
    priority: 1
    name: "Hadouken"
    fields:
    - name: "host"
      value: "hadouken.lcl"
    - name: "urlBase"
      value: "/hadouken/"
    - name: "port"
      value: 9091
    - name: "category"
      value: "prowlarr-tv"
    - name: "username"
      value: "username"
    - name: "password"
      value: "password"
    - name: "useSsl"
      value: true
    protocol: "torrent"
    config_contract: "HadoukenSettings"
    implementation: "Hadouken"
    tags: [1,2]

# Delete a download client
- name: Delete a download client
  devopsarr.prowlarr.prowlarr_download_client:
    name: Example
    state: absent

Return Values

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

Key

Description

categories

list / elements=dictionary

List of mapped categories.

Returned: always

Sample: [{"categories": [0], "client_category": "example"}]

config_contract

string

Config contract.

Returned: always

Sample: "BroadcastheNetSettings"

enable

boolean

Enable flag.

Returned: always

Sample: true

fields

list / elements=string

field list.

Returned: always

id

integer

download clientID.

Returned: always

Sample: 1

implementation

string

Implementation.

Returned: always

Sample: "BroadcastheNet"

name

string

Name.

Returned: always

Sample: "Example"

priority

integer

Priority.

Returned: always

Sample: 1

protocol

string

Protocol.

Returned: always

Sample: "torrent"

tags

list / elements=integer

Tag list.

Returned: always

Sample: [1, 2]

Authors

  • Fuochi (@Fuochi)