hall – Send notification to Hall¶
New in version 2.0.
Synopsis¶
The
hall
module connects to the https://hall.com messaging API and allows you to deliver notication messages to rooms.
Parameters¶
Parameter | Choices/Defaults | Comments |
---|---|---|
msg
-
/ required
|
The message you wish to deliver as a notification
|
|
picture
-
|
The full URL to the image you wish to use for the Icon of the message. Defaults to http://cdn2.hubspot.net/hub/330046/file-769078210-png/Official_Logos/ansible_logo_black_square_small.png?t=1421076128627
|
|
room_token
-
/ required
|
Room token provided to you by setting up the Ansible room integation on https://hall.com
|
|
title
-
/ required
|
The title of the message
|
Examples¶
- name: Send Hall notifiation
hall:
room_token: <hall room integration token>
title: Nginx
msg: 'Created virtual host file on {{ inventory_hostname }}'
delegate_to: loclahost
- name: Send Hall notification if EC2 servers were created.
hall:
room_token: <hall room integration token>
title: Server Creation
msg: 'Created instance {{ item.id }} of type {{ item.instance_type }}.\nInstance can be reached at {{ item.public_ip }} in the {{ item.region }} region.'
delegate_to: loclahost
when: ec2.instances|length > 0
with_items: '{{ ec2.instances }}'
Status¶
This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by the Ansible Community. [community]