o

�N�g=
�@sdZd
d�Z
ddd�
ZdS)a�

Create an Event in VictorOps
============================

.. versionadded:: 2015.8.0

This state is useful for creating events on the
VictorOps service during state runs.

.. code-block:: yaml

    webserver-warning-message:
      victorops.create_event:
        - message_type: 'CRITICAL'
        - entity_id: 'webserver/diskspace'
        - state_message: 'Webserver diskspace is low.'
cCsd
tvrdSdS)zD
    Only load if the victorops module is available in __salt__
    �victorops.create_eventZ	victorops)Fz$victorops module could not be loaded)
�__salt__�rr�I/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/victorops.py�__virtual__s

r�everyonecKs�|id
dd�}tdrd|��|d<|St
dd|
|d�|�
�
}|d	d
kr6d|d	<d�||d
�|d<|Sd|d	<d�|d�
|d<|S)a
    Create an event on the VictorOps service

    .. code-block:: yaml

        webserver-warning-message:
          victorops.create_event:
            - message_type: 'CRITICAL'
            - entity_id: 'webserver/diskspace'
            - state_message: 'Webserver diskspace is low.'

        database-server-warning-message:
          victorops.create_event:
            - message_type: 'WARNING'
            - entity_id: 'db_server/load'
            - state_message: 'Database Server load is high.'
            - entity_is_host: True
            - entity_display_name: 'dbdserver.example.com'

    The following parameters are required:

    name
        This is a short description of the event.

    message_type
        One of the following values: INFO, WARNING, ACKNOWLEDGEMENT, CRITICAL, RECOVERY.

    The following parameters are optional:

        routing_key
            The key for where messages should be routed. By default, sent to 'everyone' route.

        entity_id
            The name of alerting entity. If not provided, a random name will be assigned.

        timestamp
            Timestamp of the alert in seconds since epoch. Defaults to the time the alert is received at VictorOps.

        timestamp_fmt
            The date format for the timestamp parameter.  Defaults to ''%Y-%m-%dT%H:%M:%S'.

        state_start_time
            The time this entity entered its current state (seconds since epoch). Defaults to the time alert is received.

        state_start_time_fmt
            The date format for the timestamp parameter. Defaults to '%Y-%m-%dT%H:%M:%S'.

        state_message
            Any additional status information from the alert item.

        entity_is_host
            Used within VictorOps to select the appropriate display format for the incident.

        entity_display_name
            Used within VictorOps to display a human-readable name for the entity.

        ack_message
            A user entered comment for the acknowledgment.

        ack_author
            The user that acknowledged the incident.

    N�)�nameZchanges�result�comment�testzNeed to create event: r
r
)�message_type�routing_keyr	�successTzCreated event: {} for entity {}Z	entity_idFzFailed to create event: {}�messager)Z__opts__r�format)rrr
�kwargs�ret�resrrr�create_events$@


�
�


��

rN)
r)�__doc__rrrrrr�<module>
s