NAME

Zabbix2::API::Macro -- Zabbix usermacro objects

SYNOPSIS

  # create a new global macro (set its hostid attribute if you need a
  # host macro instead)
  my $macro = Zabbix2::API::Macro->new(root => $zabber,
                                       data => { macro => '{$SUPERMACRO}',
                                                 value => 'ITSABIRD' });
  $macro->create;
  
  # change its value
  $macro->value('ITSAPLANE');
  $macro->update;

DESCRIPTION

Handles CRUD for Zabbix usermacro objects.

Both global and host macro types are represented by this class. If the hostid attribute is undef or empty, then we assume it's a global macro.

This class' methods work transparently around the weird Zabbix macro API, which uses different methods on the same object depending on whether it's a global or host macro... except sometimes, for instance the usermacro.get method which can be called on both and will return different keys... And macros don't seem to have an exists method. It's kind of a mess.

METHODS

_prefix

This class' _prefix method is not a class method. The _prefix returned depends on the type of macro (global or host) which is a characteristic of an instance.

globalp

  say $macro->globalp ? 'a global macro' : 'a host macro';

Returns a true value when the macro is global, a false value otherwise.

name

  say $macro->name;

Returns the macro's name, which is also how it's referred to in expressions, e.g. "{$SUPERMACRO}".

value

  $macro->value('new value');
  say $macro->value;

Mutator for the macro's value.

SEE ALSO

Zabbix2::API::CRUDE

AUTHOR

Fabrice Gabolde <fga@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2011, 2014 SFR

This library is free software; you can redistribute it and/or modify it under the terms of the GPLv3.