NAME

Zabbix2::API::HostInterface -- Zabbix host interface objects

SYNOPSIS

  my $new_host = Zabbix2::API::Host->new(root => $zabber,
                                         data => { host => 'Another Server',
                                                   ip => '255.255.255.255',
                                                   useip => 1,
                                                   groups => [ { groupid => 4 } ] });
  $new_host->interfaces([ Zabbix2::API::HostInterface->new(
                              root => $zabber,
                              data => {
                                  dns => 'localhost',
                                  ip => '',
                                  main => 1,
                                  port => 10000,
                                  type => Zabbix2::API::HostInterface::INTERFACE_TYPE_AGENT,
                                  useip => 0,
                              }) ]);
  $new_host->create;

DESCRIPTION

While technically a subclass of Zabbix2::API::CRUDE, this class does not actually implement all methods necessary to behave as a full-fledged Zabbix object. Instead, we recommend using Zabbix2::API::HostInterface objects via their parent Zabbix2::API::Host object. Calls to unimplemented methods will throw an exception.

Unlike Zabbix2::API::GraphItem objects, for which the usual API methods are not all implemented on the server, this is mostly a case of laziness of our part, so patches are welcome.

Zabbix2::API::HostInterface objects will be automatically created from a Zabbix2::API::Host object's properties whenever it is pulled from the server. Conversely, if you add interfaces manually to a Zabbix2::API::Host object, the Zabbix2::API::HostInterface objects will be automatically turned into properties just before a call to create or update, causing the relevant host interface objects to be created or updated on the server.

EXPORTS

Some constants:

  INTERFACE_TYPE_UNKNOWN
  INTERFACE_TYPE_AGENT
  INTERFACE_TYPE_SNMP
  INTERFACE_TYPE_IPMI
  INTERFACE_TYPE_JMX
  INTERFACE_TYPE_ANY

They are not exported by default, only on request; or you could import the :interface_types tag.

SEE ALSO

Zabbix2::API::CRUDE, Zabbix2::API::Host

AUTHOR

Fabrice Gabolde <fga@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2014 Fabrice Gabolde

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.