devopsarr.lidarr.lidarr_notification module – Manages Lidarr notification.

Note

This module is part of the devopsarr.lidarr 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.lidarr.

To use it in a playbook, specify: devopsarr.lidarr.lidarr_notification.

New in devopsarr.lidarr 1.0.0

Synopsis

  • Manages Lidarr notification.

Parameters

Parameter

Comments

config_contract

string

Config contract.

fields

list / elements=dictionary

Configuration field list.

name

string

Field name.

value

any

Field value.

implementation

string

Implementation.

lidarr_api_key

string / required

API key for Lidarr authentication.

lidarr_url

string / required

Full Lidarr URL with protocol and port (e.g. `https://test.lidarr.tv:8686`)

name

string / required

Name.

on_album_delete

boolean

On album delete flag.

Choices:

  • false ← (default)

  • true

on_application_update

boolean

On application update flag.

Choices:

  • false ← (default)

  • true

on_artist_delete

boolean

On artist delete flag.

Choices:

  • false ← (default)

  • true

on_download_failure

boolean

On download failure flag.

Choices:

  • false ← (default)

  • true

on_grab

boolean

On grab flag.

Choices:

  • false ← (default)

  • true

on_health_issue

boolean

On health issue flag.

Choices:

  • false ← (default)

  • true

on_health_restored

boolean

On health restored flag.

Choices:

  • false ← (default)

  • true

on_import_failure

boolean

On import failure flag.

Choices:

  • false ← (default)

  • true

on_release_import

boolean

On release import flag.

Choices:

  • false ← (default)

  • true

on_rename

boolean

On rename flag.

Choices:

  • false ← (default)

  • true

on_track_retag

boolean

On track retag flag.

Choices:

  • false ← (default)

  • true

on_upgrade

boolean

On upgrade flag.

Choices:

  • false ← (default)

  • true

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(LIDARR_URL) env variable.

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

Examples

---
# Create a notification
- name: Create a notification
  devopsarr.lidarr.lidarr_notification:
    name: "Example"
    on_grab: true
    config_contract: "WebhookSettings"
    implementation: "Webhook"
    fields:
    - name: "username"
      value: "User"
    - name: "password"
      value: "test"
    - name: "url"
      value: "webhook.lcl"
    - name: "method"
      value: 1
    tags: [1,2]

# Delete a notification
- name: Delete a notification
  devopsarr.lidarr.lidarr_notification:
    name: Example
    state: absent

Return Values

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

Key

Description

config_contract

string

Config contract.

Returned: always

Sample: "WebhookSettings"

fields

list / elements=string

field list.

Returned: always

id

integer

notification ID.

Returned: always

Sample: 1

implementation

string

Implementation.

Returned: always

Sample: "Webhook"

name

string

Name.

Returned: always

Sample: "Example"

on_album_delete

boolean

On album delete flag.

Returned: always

Sample: true

on_application_update

boolean

On application update flag.

Returned: always

Sample: true

on_artist_delete

boolean

On artist delete flag.

Returned: always

Sample: true

on_download_failure

boolean

On download failure flag.

Returned: always

Sample: false

on_grab

boolean

On grab flag.

Returned: always

Sample: true

on_health_issue

boolean

On health issue flag.

Returned: always

Sample: true

on_health_restored

boolean

On health restored flag.

Returned: always

Sample: true

on_import_failure

boolean

On import failure flag.

Returned: always

Sample: true

on_release_import

boolean

On release import flag.

Returned: always

Sample: true

on_rename

boolean

On rename flag.

Returned: always

Sample: true

on_track_retag

boolean

On track retag flag.

Returned: always

Sample: true

on_upgrade

boolean

On upgrade flag.

Returned: always

Sample: true

tags

list / elements=integer

Tag list.

Returned: always

Sample: [1, 2]

Authors

  • Fuochi (@Fuochi)