The below requirements are needed on the host that executes this module.
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| force boolean added in 2.5 |
| Only updates an existing macro if set to yes. |
| host_name - / required | Name of the host. | |
| http_login_password string | Basic Auth password | |
| http_login_user string / required | Basic Auth login | |
| login_password string / required | Zabbix user password. | |
| login_user string / required | Zabbix user name. | |
| macro_name - / required | Name of the host macro without the enclosing curly braces and the leading dollar sign. | |
| macro_value - / required | Value of the host macro. | |
| server_url string / required | URL of Zabbix server, with protocol (http or https). url is an alias for server_url.aliases: url | |
| state - |
| State of the macro. On present, it will create if macro does not exist or update the macro if the associated data is different.On absent will remove a macro if it exists. |
| timeout integer | Default: 10 | The timeout of API request (seconds). |
| validate_certs boolean added in 2.5 |
| If set to False, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates. |
Note
no_log. See this FAQ for more information.- name: Create a new host macro or update an existing macro's value
local_action:
module: zabbix_hostmacro
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
macro_name: EXAMPLE.MACRO
macro_value: Example value
state: present
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/zabbix_hostmacro_module.html