Docs4dev
Docs
ansible / 2.10 / collections / community / general / pushover_module.html

community.general.pushover – Send notifications via https://pushover.net

Note

This plugin is part of the community.general collection (version 1.3.2).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.pushover.

Synopsis

  • Send notifications via pushover, to subscriber list of devices, and email addresses. Requires pushover app on devices.

Parameters

Parameter Choices/Defaults Comments
app_token
string / required
Pushover issued token identifying your pushover app.
device
string
added in 1.2.0 of community.general
A device the message should be sent to. Multiple devices can be specified, separated by a comma.
msg
string / required
What message you wish to send.
pri
string
    Choices:
  • -2
  • -1
  • 0 ←
  • 1
  • 2
Message priority (see https://pushover.net for details).
title
string
Message title.
user_key
string / required
Pushover issued authentication key for your user.

Notes

Note

  • You will require a pushover.net account to use this module. But no account is required to receive messages.

Examples

- name: Send notifications via pushover.net
  community.general.pushover:
    msg: '{{ inventory_hostname }} is acting strange ...'
    app_token: wxfdksl
    user_key: baa5fe97f2c5ab3ca8f0bb59
  delegate_to: localhost

- name: Send notifications via pushover.net
  community.general.pushover:
    title: 'Alert!'
    msg: '{{ inventory_hostname }} has exploded in flames, It is now time to panic'
    pri: 1
    app_token: wxfdksl
    user_key: baa5fe97f2c5ab3ca8f0bb59
  delegate_to: localhost

- name: Send notifications via pushover.net to a specific device
  community.general.pushover:
    msg: '{{ inventory_hostname }} has been lost somewhere'
    app_token: wxfdksl
    user_key: baa5fe97f2c5ab3ca8f0bb59
    device: admins-iPhone
  delegate_to: localhost

Authors

  • Jim Richardson (@weaselkeeper)
  • Bernd Arnold (@wopfel)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/pushover_module.html