salt.states.zabbix_host module

Management of Zabbix hosts.

codeauthor:Jiri Kotlin <jiri.kotlin@ultimum.io>
salt.states.zabbix_host.absent(name, **kwargs)

Ensures that the host does not exists, eventually deletes host.

New in version 2016.3.0.

Param:

name: technical name of the host

Parameters:
  • _connection_user -- Optional - zabbix user (can also be set in opts or pillar, see module's docstring)
  • _connection_password -- Optional - zabbix password (can also be set in opts or pillar, see module's docstring)
  • _connection_url -- Optional - url of zabbix frontend (can also be set in opts, pillar, see module's docstring)
TestHostWithInterfaces:
    zabbix_host.absent
salt.states.zabbix_host.assign_templates(host, templates, **kwargs)

Ensures that templates are assigned to the host.

New in version 2017.7.0.

Parameters:
  • host -- technical name of the host
  • _connection_user -- Optional - zabbix user (can also be set in opts or pillar, see module's docstring)
  • _connection_password -- Optional - zabbix password (can also be set in opts or pillar, see module's docstring)
  • _connection_url -- Optional - url of zabbix frontend (can also be set in opts, pillar, see module's docstring)
add_zabbix_templates_to_host:
    zabbix_host.assign_templates:
        - host: TestHost
        - templates:
            - "Template OS Linux"
            - "Template App MySQL"
salt.states.zabbix_host.present(host, groups, interfaces, **kwargs)

Ensures that the host exists, eventually creates new host. NOTE: please use argument visible_name instead of name to not mess with name from salt sls. This function accepts all standard host properties: keyword argument names differ depending on your zabbix version, see: https://www.zabbix.com/documentation/2.4/manual/api/reference/host/object#host

New in version 2016.3.0.

Parameters:
  • host -- technical name of the host
  • groups -- groupids of host groups to add the host to
  • interfaces -- interfaces to be created for the host
  • proxy_host -- Optional proxy name or proxyid to monitor host
  • inventory -- Optional list of inventory names and values
  • _connection_user -- Optional - zabbix user (can also be set in opts or pillar, see module's docstring)
  • _connection_password -- Optional - zabbix password (can also be set in opts or pillar, see module's docstring)
  • _connection_url -- Optional - url of zabbix frontend (can also be set in opts, pillar, see module's docstring)
  • visible_name -- Optional - string with visible name of the host, use 'visible_name' instead of 'name' parameter to not mess with value supplied from Salt sls file.
create_test_host:
    zabbix_host.present:
        - host: TestHostWithInterfaces
        - proxy_host: 12345
        - groups:
            - 5
            - 6
            - 7
        - interfaces:
            - test1.example.com:
                - ip: '192.168.1.8'
                - type: 'Agent'
                - port: 92
            - testing2_create:
                - ip: '192.168.1.9'
                - dns: 'test2.example.com'
                - type: 'agent'
                - main: false
            - testovaci1_ipmi:
                - ip: '192.168.100.111'
                - type: 'ipmi'
        - inventory:
            - alias: some alias
            - asset_tag: jlm3937