New in version 1.8.
- python >= 2.6
- zabbix-api
parameter | required | default | choices | comments |
---|---|---|---|---|
collect_data |
no | true | Type of maintenance. With data collection, or without. | |
desc |
yes | Created by Ansible | Short description of maintenance window. | |
host_groups |
no | Host groups to manage maintenance window for. Separate multiple groups with commas.
host_group is an alias for host_groups . Required option when state is present and no host_names specified.aliases: host_group | ||
host_names |
no | Hosts to manage maintenance window for. Separate multiple hosts with commas.
host_name is an alias for host_names . Required option when state is present and no host_groups specified.aliases: host_name | ||
http_login_password (added in 2.1) |
no | None | Basic Auth password | |
http_login_user (added in 2.1) |
no | None | Basic Auth login | |
login_password |
yes | Zabbix user password. | ||
login_user |
yes | Zabbix user name. | ||
minutes |
no | 10 | Length of maintenance window in minutes. | |
name |
yes | Unique name of maintenance window. | ||
server_url |
yes | Url of Zabbix server, with protocol (http or https).
url is an alias for server_url .aliases: url | ||
state |
no | present |
|
Create or remove a maintenance window. |
timeout (added in 2.1) |
no | 10 | The timeout of API request (seconds). |
- name: Create a named maintenance window for host www1 for 90 minutes zabbix_maintenance: name: Update of www1 host_name: www1.example.com state: present minutes: 90 server_url: https://monitoring.example.com login_user: ansible login_password: pAsSwOrD - name: Create a named maintenance window for host www1 and host groups Office and Dev zabbix_maintenance: name: Update of www1 host_name: www1.example.com host_groups: - Office - Dev state: present server_url: https://monitoring.example.com login_user: ansible login_password: pAsSwOrD - name: Create a named maintenance window for hosts www1 and db1, without data collection. zabbix_maintenance: name: update host_names: - www1.example.com - db1.example.com state: present collect_data: False server_url: https://monitoring.example.com login_user: ansible login_password: pAsSwOrD - name: Remove maintenance window by name zabbix_maintenance: name: Test1 state: absent server_url: https://monitoring.example.com login_user: ansible login_password: pAsSwOrD
Note
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.