Documentación API pública

GET /api/config/hosts/address/{address}/

Given an ip address, returns its configuration asking to all realms.

Given an ip address, returns its configuration asking to all realms. Useful for getting the location (realm) of a host represented by address, as usually comes in traps and other events

Parameters
  • address (string) –

Query Parameters
  • skip_hostgroup_realms (boolean) – By default, only standard realms are retreived. Setting skip_hostgroup_realms to false will retrieve all the realms, including hostgroup-based realms.

Status Codes
GET /api/config/hosts/host_name/{host_name}

Given an hostname, returns its configuration asking to all realms.

Given an hostname, returns its configuration asking to all realms. Useful for getting the location (realm) of a host represented by address, as usually comes in traps and other events

Parameters
  • host_name (string) –

Query Parameters
  • skip_hostgroup_realms (boolean) – By default, only standard realms are retreived. Setting skip_hostgroup_realms to false will retrieve all the realms, including hostgroup-based realms.

Status Codes
POST /api/config/realm/create-realm/
Request JSON Object
  • activated (boolean) –

  • category (integer) –

  • collectd (string) – (required)

  • display_name (string) – (required)

  • host_groups (string) – Filter realm information by specified hostgroup(s)

  • host_name (string) – (required)

  • import_tool (integer) –

  • link (string) – Link to external Wocu apps menu (including NagVis, Panorama, etc.). Leave it blank in case of doubt

  • logger_resources[] (string) –

  • metrics (string) – Metric database used by this realm

  • metrics_db (string) – (required)

  • monitoring_ip (string) – (required)

  • monitoring_port (integer) – (required)

  • monitoring_socket (string) – Livestatus socket file, for example: /var/opt/wocu/run/shinken/livestatus.sock

  • origin[] (string) –

  • section (string) – (required)

Status Codes
GET /api/config/realm/{realm_name}/active-host-group/{hostgroup_name}/members/

Given a realm name and a hostgroup name, returns the list of members of the given hostgroup.

Given a realm name and a hostgroup name, returns the list of members of the given hostgroup.

Parameters
  • realm_name (string) –

  • hostgroup_name (string) –

Status Codes
GET /api/config/realm/{realm_name}/active-host-groups-only-names/

Given a realm name, returns the list of hostgroups of that realm

Given a realm name, returns the list of hostgroups of that realm (only hostgroup names).

Parameters
  • realm_name (string) –

Status Codes
GET /api/config/realm/{realm_name}/hosts/active/

Given a realm_name and a list of args check if api_optimization is

Given a realm_name and a list of args check if api_optimization is enabled in the import_tool related to the realm. If it is enabled trigger _ask_collectors method sending the realm object and the list of arguments to it, otherwise trigger _ask_import_tool sending the request, the realm name string and the rest of extra arguments.

Parameters
  • request (HttpRequest) – HTTP Request

  • realm_name (string) – Name of the realm to query

  • realm_name

Status Codes
GET /api/config/realm/{realm_name}/hosts/pending/

Given a realm_name and a list of args check if api_optimization is

Given a realm_name and a list of args check if api_optimization is enabled in the import_tool related to the realm. If it is enabled trigger _ask_collectors method sending the realm object and the list of arguments to it, otherwise trigger _ask_import_tool sending the request, the realm name string and the rest of extra arguments.

Parameters
  • request (HttpRequest) – HTTP Request

  • realm_name (string) – Name of the realm to query

  • realm_name

Status Codes
GET /api/config/realm/{realm_name}/hosts/{host_name}/

Return the info of a specific host.

Return the info of a specific host.

Parameters
  • realm_name (string) –

  • host_name (string) –

Status Codes
GET /api/device-inventory/realm/{realm_name}/host/{host}/inventory/
Parameters
  • realm_name (string) –

  • host (string) –

Status Codes
GET /api/events/monitoring/kpi/{kpi_id}/
Parameters
  • kpi_id (string) –

Status Codes
GET /api/events/multirealms/{realm_name}/monitoring/

Web service that returns monitoring events from a MultiRealm.

Web service that returns monitoring events from a MultiRealm.

At least one of the filters (parameters named arg_filter, except for hostgroup_filter) must be set to true in order to get any result.

Default time range if no dates are provided is 24 hours from now.

Parameters
  • realm_name (string) –

  • realm_type (string) – Type of realm: realm or multirealm

Query Parameters
  • time_from (string) – More info: https://github.com/sonirico/datetoken#motivation

  • time_to (string) – More info: https://github.com/sonirico/datetoken#motivation

  • hostgroup_filter (string) – Name of hostgroup. To look only for events of hosts and services of a specific hostgroup

  • hosts_filter (string) – Either true or false. Show host related events

  • services_filter (string) – Either true or false. Show service related events

  • notifications_filter (string) – Either true or false. Show notification related events

  • external_commands_filter (string) – Either true or false. Show external command related events

  • flapping_filter (string) – Either true or false. Show host and service flapping related events

  • service_desc (string) – Name of a service. To look only for events of that service

Status Codes
GET /api/events/realms/{realm_name}/hosts/{host}/monitoring/

Web service that returns monitoring events from a host belonging to a Realm

Web service that returns monitoring events from a host belonging to a Realm

At least one of the filters (parameters named arg_filter) must be set to true in order to get any result.

Default time range if no dates are provided is 24 hours from now.

Parameters
  • realm_name (string) –

  • host (string) –

  • realm_type (string) – Type of realm: realm or multirealm

Query Parameters
  • time_from (string) – More info: https://github.com/sonirico/datetoken#motivation

  • time_to (string) – More info: https://github.com/sonirico/datetoken#motivation

  • hostgroup_filter (string) – Name of hostgroup. To look only for events of hosts and services of a specific hostgroup

  • hosts_filter (string) – Either true or false. Show host related events

  • services_filter (string) – Either true or false. Show service related events

  • notifications_filter (string) – Either true or false. Show notification related events

  • external_commands_filter (string) – Either true or false. Show external command related events

  • flapping_filter (string) – Either true or false. Show host and service flapping related events

  • service_desc (string) – Name of a service. To look only for events of that service

Status Codes
GET /api/events/realms/{realm_name}/monitoring/

Web service that returns monitoring events from a Realm.

Web service that returns monitoring events from a Realm.

At least one of the filters (parameters named arg_filter, except for hostgroup_filter) must be set to true in order to get any result.

Default time range if no dates are provided is 24 hours from now.

Parameters
  • realm_name (string) –

  • realm_type (string) – Type of realm: realm or multirealm

Query Parameters
  • time_from (string) – More info: https://github.com/sonirico/datetoken#motivation

  • time_to (string) – More info: https://github.com/sonirico/datetoken#motivation

  • hostgroup_filter (string) – Name of hostgroup. To look only for events of hosts and services of a specific hostgroup

  • hosts_filter (string) – Either true or false. Show host related events

  • services_filter (string) – Either true or false. Show service related events

  • notifications_filter (string) – Either true or false. Show notification related events

  • external_commands_filter (string) – Either true or false. Show external command related events

  • flapping_filter (string) – Either true or false. Show host and service flapping related events

  • service_desc (string) – Name of a service. To look only for events of that service

Status Codes
GET /api/events/{realm_type}/{realm_name}/monitoring/kpi/hosts/
Parameters
  • realm_type (string) – Type of realm: realm or multirealm

  • realm_name (string) –

Query Parameters
  • time_from (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • time_to (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • hostgroup_filter (string) – Name of hostgroup. To look only for events of hosts and services of a specific hostgroup

Status Codes
GET /api/events/{realm_type}/{realm_name}/monitoring/kpi/services/
Parameters
  • realm_type (string) – Type of realm: realm or multirealm

  • realm_name (string) –

Query Parameters
  • time_from (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • time_to (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • hostgroup_filter (string) – Name of hostgroup. To look only for events of hosts and services of a specific hostgroup

Status Codes
GET /api/stats/get-users-and-sessions/

Web service that returns the number of logged users and the number of

Web service that returns the number of logged users and the number of active sessions.

Status Codes
GET /api/stats/realms/

Web service that returns the config of every single realm.

Web service that returns the config of every single realm.

Status Codes
GET /api/stats/realms/{user_name}/

Web service that returns all Realms y MultiRealms associated to an User.

Web service that returns all Realms y MultiRealms associated to an User.

Parameters
  • user_name (string) –

Status Codes
GET /api/stats/{id_origin}/realms/

Web service that returns all Realms associated to an Origin.

Web service that returns all Realms associated to an Origin.

Parameters
  • id_origin (string) –

Status Codes
GET /api/status/multirealms/{realm_name}/

Web service that returns the global state of a MultiRealm.

Web service that returns the global state of a MultiRealm.

Parameters
  • realm_name (string) –

Status Codes
GET /api/status/multirealms/{realm_name}/business_processes/

Returns the BP assets and info on them, in a MultiRealm.

Returns the BP assets and info on them, in a MultiRealm.

Parameters
  • realm_name (string) –

Status Codes
GET /api/status/multirealms/{realm_name}/host/{host}/services/

Returns the services and their status, of a host in a Realm.

Returns the services and their status, of a host in a Realm.

Parameters
  • realm_name (string) –

  • host (string) –

Status Codes
GET /api/status/multirealms/{realm_name}/hostgroups/

Returns the status of hosts and services in a hostgroup, in a MultiRealm.

Returns the status of hosts and services in a hostgroup, in a MultiRealm.

Parameters
  • realm_name (string) –

Status Codes
GET /api/status/multirealms/{realm_name}/hostgroups/{hostgroup_name}/hosts/

Web service that returns all hosts and their status, of a hostgroup in a MultiRealm.

Web service that returns all hosts and their status, of a hostgroup in a MultiRealm.

Parameters
  • realm_name (string) –

  • hostgroup_name (string) –

Status Codes
GET /api/status/multirealms/{realm_name}/hosts/

Web service that returns all the hosts, and their status, of a MultiRealm.

Web service that returns all the hosts, and their status, of a MultiRealm.

Parameters
  • realm_name (string) –

Query Parameters
  • macros (boolean) –

Status Codes
GET /api/status/realms/{realm_name}/

Web service that returns the global state of a Realm.

Web service that returns the global state of a Realm.

Parameters
  • realm_name (string) –

Status Codes
GET /api/status/realms/{realm_name}/business_processes/

Returns the BP assets and info on them, in a Realm.

Returns the BP assets and info on them, in a Realm.

Parameters
  • realm_name (string) –

Status Codes
GET /api/status/realms/{realm_name}/host/{host}/services/

Returns the services and their status, of a host in a Realm.

Returns the services and their status, of a host in a Realm.

Parameters
  • realm_name (string) –

  • host (string) –

Status Codes
GET /api/status/realms/{realm_name}/hostgroups/

Returns the status of hosts and services in a hostgroup, in a Realm.

Returns the status of hosts and services in a hostgroup, in a Realm.

Parameters
  • realm_name (string) –

Status Codes
GET /api/status/realms/{realm_name}/hostgroups/{hostgroup_name}/hosts/

Web service that returns all hosts and their status, of a hostgroup in a Realm.

Web service that returns all hosts and their status, of a hostgroup in a Realm.

Parameters
  • realm_name (string) –

  • hostgroup_name (string) –

Status Codes
GET /api/status/realms/{realm_name}/hosts-grouped-by-pack/

Web service that returns all host names grouped by assigned pack.

Web service that returns all host names grouped by assigned pack.

Parameters
  • realm_name (string) –

Status Codes
GET /api/status/realms/{realm_name}/hosts/

Web service that returns all the hosts, and their status, of a Realm.

Web service that returns all the hosts, and their status, of a Realm.

Parameters
  • realm_name (string) –

Query Parameters
  • macros (boolean) –

Status Codes
GET /api/status/realms/{realm_name}/hosts/{host}/

Web service that returns the state of a host belonging to a Realm.

Web service that returns the state of a host belonging to a Realm.

Parameters
  • realm_name (string) –

  • host (string) –

Status Codes
GET /api/status/{realm_type}/{realm_name}/host/availability/{host}/

Web service that returns Availability info of unique host.

Web service that returns Availability info of unique host.

Parameters
  • realm_type (string) –

  • realm_name (string) –

  • host (string) –

Query Parameters
  • time_from (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • time_to (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • threshold (integer) – Min: 0 - Max: 100

  • h_unavailable_states (array) –

    Comma-separated list of states. Available options:

    • UP

    • PENDING

    • UNREACHABLE

    • DOWN

  • hostgroup (string) – Name of a hostgroup

Status Codes
GET /api/status/{realm_type}/{realm_name}/hosts-grouped-by-pack/

Web service that returns all host names grouped by assigned pack.

Web service that returns all host names grouped by assigned pack.

Parameters
  • realm_type (string) –

  • realm_name (string) –

Status Codes
GET /api/status/{realm_type}/{realm_name}/hosts/availability/

Web service that returns Availability info of hosts of Realm.

Web service that returns Availability info of hosts of Realm.

Parameters
  • realm_type (string) –

  • realm_name (string) –

Query Parameters
  • time_from (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • time_to (string) – Format: YYYY-MM-DDThh:mm:ssTZD. More info: https://www.w3.org/TR/NOTE-datetime

  • threshold (integer) – Min: 0 - Max: 100

  • h_unavailable_states (array) –

    Comma-separated list of states. Available options:

    • UP

    • PENDING

    • UNREACHABLE

    • DOWN

  • hostgroup (string) – Name of a hostgroup

Status Codes