This state is useful for sending messages to Hipchat during state runs.
The property api_url is optional. By defaul will use the public HipChat API at https://api.hipchat.com
New in version 2015.5.0.
hipchat-message:
hipchat.send_message:
- room_id: 123456
- from_name: SuperAdmin
- message: 'This state was executed successfully.'
- api_url: https://hipchat.myteam.com
- api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15
- api_version: v1
The api key can be specified in the master or minion configuration like below:
hipchat:
api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15
api_version: v1
salt.states.hipchat.
send_message
(name, room_id, from_name, message, api_url=None, 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_url: https://hipchat.myteam.com
- api_key: peWcBiMOS9HrZG15peWcBiMOS9HrZG15
- api_version: v1
- message_color: green
- notify: True
The following parameters are required:
The unique name for this event.
The room to send the message to. Can either be the ID or the name.
The name of that is to be shown in the "from" field. If not specified, defaults to.
The message that is to be sent to the Hipchat room.
The following parameters are optional:
The API URl to be used. If not specified here or in the configuration options of master or minion, will use the public HipChat API: https://api.hipchat.com
The api key for Hipchat to use for authentication, if not specified in the configuration options of master or minion.
The api version for Hipchat to use, if not specified in the configuration options of master or minion.
The color the Hipchat message should be displayed in. One of the following, default: yellow "yellow", "red", "green", "purple", "gray", or "random".
Should a notification in the room be raised.