Miquel Ruiz Martin > Opsview-REST-0.004 > Opsview::REST

Download:
Opsview-REST-0.004.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.004   Source   Latest Release: Opsview-REST-0.013

NAME ^

Opsview::REST - Interface to the Opsview REST API

SYNOPSIS ^

    use Opsview::REST;

    my $ops = Opsview::REST->new(
        base_url => 'http://opsview.example.com/rest',
        user     => 'username',
        pass     => 'password',
    );

    # These are equivalent
    my $status = $ops->get('/status/hostgroup?hostgroupid=1&...');
    my $status = $ops->status(
        'hostgroup',
        'hostgroupid' => [1, 2],
        'filter'      => 'unhandled',
        ...
    );

DESCRIPTION ^

Opsview::REST is a set of modules to access the Opsview REST API, which is the recommended method for scripting configuration changes or any other form of integration since version 3.9.0

METHODS ^

new

Return an instance of the Opsview::REST.

Required Arguments

base_url

Base url where the REST API resides. By default it is under /rest.

user

Username to login as.

Other Arguments

pass
auth_tkt

Either the pass or the auth_tkt MUST be passed. It will die horribly if none of these are found.

get($url)

Makes a "GET" request to the API. The response is properly deserialized and returned as a Perl data structure.

status( $endpoint, [ %args ] )

Convenience method to request the "status" part of the API. $endpoint is the endpoint to send the query to. %args is a hash which will get properly translated to URL arguments.

More info: http://docs.opsview.com/doku.php?id=opsview-community:restapi:status

downtimes

create_downtime( %args )

delete_downtime( [ %args ] )

Downtime related methods.

More info: http://docs.opsview.com/doku.php?id=opsview-community:restapi:downtimes

events( [ %args ] )

Get events. An event is considered to be either:

More info: http://docs.opsview.com/doku.php?id=opsview-community:restapi:event

acknowledge( [ %args ] )

Acknowledge problems.

More info: http://docs.opsview.com/doku.php?id=opsview-community:restapi:acknowledge

acknowledge_list

Lists the problems which the current logged in user has permission to acknowledge.

reload

Initiates a synchronous reload. Be careful: if your opsview reload takes more than 60 seconds to run, this call will time out. The returned data contains the info of the reload.

More info: http://docs.opsview.com/doku.php?id=opsview-community:restapi#initiating_an_opsview_reload

reload_info

Get status of reload.

More info: http://docs.opsview.com/doku.php?id=opsview-community:restapi#initiating_an_opsview_reload

SEE ALSO ^

AUTHOR ^

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2012 by Miquel Ruiz.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: