Parameter |
Choices/Defaults |
Comments |
ca_cert
string
added in 2.5 |
|
Required certificate issuer.
Works only with >= Zabbix 3.0
aliases: tls_issuer
|
description
string
added in 2.5 |
|
Description of the host in Zabbix.
|
force
boolean
|
|
Overwrite the host configuration, even if already present.
|
host_groups
list
/ elements=string
|
|
List of host groups the host is part of.
|
host_name
string
/ required
|
|
Name of the host in Zabbix.
host_name is the unique identifier used and cannot be updated using this module.
|
http_login_password
string
|
|
Basic Auth password
|
http_login_user
string
/ required
|
|
Basic Auth login
|
interfaces
list
/ elements=dictionary
|
Default:
[]
|
List of interfaces to be created for the host (see example below).
For more information, review host interface documentation at
|
|
bulk
integer
|
|
Whether to use bulk SNMP requests.
0 (don't use bulk requests), 1 (use bulk requests)
|
|
dns
string
|
Default:
""
|
DNS name of the host interface.
Required if useip=0.
|
|
ip
string
|
Default:
""
|
IP address used by host interface.
Required if useip=1.
|
|
main
integer
|
|
Whether the interface is used as default.
If multiple interfaces with the same type are provided, only one can be default.
0 (not default), 1 (default)
|
|
port
string
|
|
Port used by host interface.
If not specified, default port for each type of interface is used
10050 if type='agent'
161 if type='snmp'
623 if type='ipmi'
12345 if type='jmx'
|
|
type
-
/ required
|
Choices:
- agent
- snmp
- ipmi
- jmx
|
Interface type to add
Numerical values are also accepted for interface type
1 = agent
2 = snmp
3 = ipmi
4 = jmx
|
|
useip
integer
|
|
Connect to host interface with IP address instead of DNS name.
0 (don't use ip), 1 (use ip)
|
inventory_mode
string
|
Choices:
- automatic
- manual
- disabled
|
Configure the inventory mode.
|
inventory_zabbix
dictionary
added in 2.5 |
|
Add Facts for a zabbix inventory (e.g. Tag) (see example below).
Please review the interface documentation for more information on the supported properties
|
ipmi_authtype
integer
added in 2.5 |
|
IPMI authentication algorithm.
Please review the Host object documentation for more information on the supported properties
https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object
Possible values are, 0 (none), 1 (MD2), 2 (MD5), 4 (straight), 5 (OEM), 6 (RMCP+), with -1 being the API default.
Please note that the Zabbix API will treat absent settings as default when updating any of the ipmi_-options; this means that if you attempt to set any of the four options individually, the rest will be reset to default values.
|
ipmi_password
string
added in 2.5 |
|
IPMI password.
also see the last note in the ipmi_authtype documentation
|
ipmi_privilege
integer
added in 2.5 |
|
IPMI privilege level.
Please review the Host object documentation for more information on the supported properties
https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object
Possible values are 1 (callback), 2 (user), 3 (operator), 4 (admin), 5 (OEM), with 2 being the API default.
also see the last note in the ipmi_authtype documentation
|
ipmi_username
string
added in 2.5 |
|
IPMI username.
also see the last note in the ipmi_authtype documentation
|
link_templates
list
/ elements=string
|
|
List of templates linked to the host.
|
login_password
string
/ required
|
|
Zabbix user password.
|
login_user
string
/ required
|
|
Zabbix user name.
|
proxy
string
|
|
The name of the Zabbix proxy to be used.
|
server_url
string
/ required
|
|
URL of Zabbix server, with protocol (http or https). url is an alias for server_url .
aliases: url
|
state
string
|
Choices:
present ←
- absent
|
State of the host.
On present , it will create if host does not exist or update the host if the associated data is different.
On absent will remove a host if it exists.
|
status
string
|
Choices:
enabled ←
- disabled
|
Monitoring status of the host.
|
timeout
integer
|
Default:
10
|
The timeout of API request (seconds).
|
tls_accept
integer
added in 2.5 |
Default:
1
|
Specifies what types of connections are allowed for incoming connections.
The tls_accept parameter accepts values of 1 to 7
Possible values, 1 (no encryption), 2 (PSK), 4 (certificate).
Values can be combined.
Works only with >= Zabbix 3.0
|
tls_connect
integer
added in 2.5 |
Default:
1
|
Specifies what encryption to use for outgoing connections.
Possible values, 1 (no encryption), 2 (PSK), 4 (certificate).
Works only with >= Zabbix 3.0
|
tls_psk
string
added in 2.5 |
|
PSK value is a hard to guess string of hexadecimal digits.
The preshared key, at least 32 hex digits. Required if either tls_connect or tls_accept has PSK enabled.
Works only with >= Zabbix 3.0
|
tls_psk_identity
string
added in 2.5 |
|
It is a unique name by which this specific PSK is referred to by Zabbix components
Do not put sensitive information in the PSK identity string, it is transmitted over the network unencrypted.
Works only with >= Zabbix 3.0
|
tls_subject
string
added in 2.5 |
|
Required certificate subject.
Works only with >= Zabbix 3.0
|
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.
|
visible_name
string
|
|
Visible name of the host in Zabbix.
|