salt.states.hipchat

Send a message to Hipchat

This state is useful for sending messages to Hipchat during state runs.

New in version 2015.5.0.

hipchat-message:
  hipchat.send_message:
    - room_id: 123456
    - from_name: SuperAdmin
    - message: 'This state was executed successfully.'
    - api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15
    - api_version: v1

The api key can be specified in the master or minion configuration like below: .. code-block:: yaml

hipchat:
api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15 api_version: v1
salt.states.hipchat.send_message(name, room_id, from_name, message, api_key=None, api_version=None, message_color='yellow', notify=False)

Send a message to a Hipchat room.

hipchat-message:
  hipchat.send_message:
    - room_id: 123456
    - from_name: SuperAdmin
    - message: 'This state was executed successfully.'
    - api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15
    - api_version: v1
    - color: green
    - notify: True

The following parameters are required:

name
The unique name for this event.
room_id
The room to send the message to. Can either be the ID or the name.
from_name
The name of that is to be shown in the "from" field. If not specified, defaults to.
message
The message that is to be sent to the Hipchat room.

The following parameters are optional:

api_key
The api key for Hipchat to use for authentication, if not specified in the configuration options of master or minion.
api_version
The api version for Hipchat to use, if not specified in the configuration options of master or minion.
color
The color the Hipchat message should be displayed in. One of the following, default: yellow "yellow", "red", "green", "purple", "gray", or "random".
notify
Should a notification in the room be raised.