Difference between revisions of "Pandora: Documentation es: Anexo API external"

From Pandora FMS Wiki
Jump to: navigation, search
(Ejemplo)
(API Externa de Pandora FMS)
Line 5,005: Line 5,005:
  
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
 
== Introducción ==
 
 
La API externa de Pandora FMS se utiliza haciendo llamadas remotas (via HTTP) sobre el fichero '''/include/api.php'''. Este es el método que se ha definido en Pandora FMS para integrar aplicaciones de terceros con Pandora FMS. Básicamente consiste en un llamada con los parámetros formateados para recibir un valor o una lista de valores que después su aplicación usará para realizar operaciones.
 
 
Una llamada al API.php es tan fácil como:
 
 
<nowiki>http://</nowiki>&lt;instalación Pandora Console&gt;/include/api.php&lt;parametros&gt;
 
 
El API sólo puede recibir los siguientes parámetros:
 
 
*op (obligatorio): es el primer parámetro. Especifica la naturaleza de la operación que puede ser "get" o "set" o "help:
 
:*get: devuelve un valor o valores
 
:*set: envía un valor o valores
 
:*help: devuelve una pequeña ayuda de las llamadas
 
*op2 (obligatorio): la llamada en sí con un nombre explicativo de sobre que actua.
 
*id (opcional): primer parámetro de la llamada.
 
*id2 (opcional): segundo parámetro de la llamada.
 
*other (opcional): tercer parámetro de la llamada, algunas veces puede ser un lista de valores serializados.
 
*other_mode (opcional): formato de la serialización. Lista de valores posibles:
 
:*url_encode: el valor de other es un alfanumérico formateado como [http://en.wikipedia.org/wiki/Percent-encoding UrlEncode].
 
:*url_encode_separator_<separador>: el valor sera una lista de valores serializados con el carácter separador por ejemplo
 
...other=peras|melones|sandias&other_mode=url_encode_separator_|
 
*returnType (opcional): formato de retorno del valor o valores. Los valores disponibles actuales son:
 
:*string: devuelve el valor tal cual como un alfanumérico.
 
:*csv: devuelve los valores como un CSV separado por defecto con el carácter ";" los campos, y separados con retornos de carro las filas.
 
:*csv_head: devuelve, igual que con "csv", salvo que añade una primera fila con los nombres de los campos a retornar.
 
 
==Seguridad==
 
Actualmente, la seguridad se basa en una lista de IPs que tendrán acceso a la herramienta. Y se podrá configurar como se ve en la imagen, en las opciones de configuración de Pandora Console.
 
 
Si se introduce en la caja de texto el carácter '''*''' se omite la comprobación de ACL relegando la seguridad al protocolo y al entorno.
 
 
<center><br><br>
 
[[image:Screnshot of api acl list setup.png|610px]]
 
</center><br><br>
 
 
También se puede establecer una password para realizar las acciones del API.
 
 
Para establecer la password hay que seguir los siguientes pasos:
 
 
*''apipass'': Password del API que se configura desde la consola. Desde la siguiente vista de configuración (Administration>Setup>):
 
 
<center><br><br>
 
[[image:Api_password.png|610px]]
 
</center><br><br>
 
 
Nota: Antes de la versión 4.0.2, este parámetro era ''pass''
 
 
Para acceder a las acciones de la API, también es necesario proporcionar un usuario y password válidos en el sistema Pandora FMS.
 
 
*''user'': Usuario de Pandora FMS válido
 
 
*''pass'': La contraseña del usuario proporcionado
 
 
'''Nota: Las llamadas a la API llevan las contraseñas sin codificar. Por lo que se debería tener cuidado y emplear conexiones SSL para evitar que se puedan ver en la red. La API admite peticiones via POST para poder cifrarlas cuando se usa SSL/HTTPS.'''
 
 
=== Retorno ===
 
Cuando la API denega el acceso, será devuelta una simple cadena de texto "auth error".
 
 
=== Ejemplos ===
 
En este caso, se está utilizando la password del API ''1234'' y se está accediendo con el usuario ''admin'' y la password ''pandora''.
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=plugins&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
Condiciones de acceso:
 
 
* La IP de origen está en la lista de ACLs
 
* La password de la API no está establecida o es ''1234''
 
* El usuario ''admin'' existe y su password es ''pandora''
 
 
=== Workflow del sistema de seguridad ===
 
'''A partir de la versión 4.0.2''', la API tiene algunas mejoras en el manejo de la seguridad. Esto se implementa ahora gracias a tres elementos:
 
 
* Filtrado IP. Sólo las IP's listadas podrán acceder a la API.
 
* Password global para la API, si se define, es obligatorio usarla en todas las llamadas.
 
* Usuario y password válido en la consola. Se utilizarán sus permisos para cada operación solicitada.
 
 
Esto se explica en el siguiente workflow:
 
 
<center><br><br>
 
[[image:API access.svg|400px]]
 
</center><br><br>
 
 
==Extensión de nuevas llamadas en el API==
 
Para desarrollar nuevas llamadas para el API tiene que tener en cuenta que:
 
 
*La llamada tiene que estar inscrita como una función en el fichero &lt;instalación Pandora Console&gt;/include/functions_api.php .
 
*La función tendrá la siguiente estructura: El prefijo "api", el tipo de llamada "get", "set" o "help" (según si se leen datos, se escriben datos o se obtiene ayuda) y el nombre de la llamada, intentando ser coherente con la operación, por ejemplo: function api_get_[nombre_llamada](parametros) .
 
*La función puede no tener parámetros, pero si los tiene, los parámetros recibidos serán los siguientes y en el mismo orden:
 
*id: primer operador o parámetro, contiene un string.
 
*id2: segundo operador o parámetro, contiene un string.
 
*other: resto de operadores o parámetros, contenido como un array de dos posiciones:
 
:*$other['type']: que puede ser string o array.
 
:*$other['data']: que será un string con el parámetro o un array de índices numéricos con los parámetros pasados.
 
*returnType: string que especifica el tipo de retorno que tendrá la llamada. En principio es transparente para usted, pero puede usarlo o modificarlo si fuese necesario.
 
 
=== Nuevas llamadas en el API desde las extensiones de Pandora FMS ===
 
Es posible crear nuevas llamadas del API sin utilizar /include/functions_api.php. La forma de hacerlo es añadiendo en el directorio de una extensión de Pandora FMS un fichero con el siguiente nombre: <nombre_de_la_extension>.api.php y dentro de este fichero crear las funciones deseadas con las mismas consideraciones de la API estándar pero con el prefijo "apiextension" en lugar de "api".
 
 
 
Por ejemplo, teniendo una extensión llamada "module_groups" con la ruta <instalación de Pandora>/extensions/module_groups debemos crear un fichero llamado module_groups.api.php en este directorio.
 
 
 
En este fichero estarán las funciones deseadas, por ejemplo una función para obtener el número de módulos de un grupo. Esta función debe tener un nombre parecido a: "apiextension_get_groupmodules".
 
 
==== Ejemplo de función ====
 
En esta función se han usado funciones imaginarias.
 
 
<code><pre>
 
function apiextension_get_groupmodules($group_name) {
 
    $group_id = group_id_from_name($group_name);
 
    if($group_id == false) {
 
      echo 'Group doesnt exist';
 
      return;
 
    }
 
 
    $number_of_modules = group_modules($group_id);
 
    echo $number_of_modules;
 
}
 
</pre></code>
 
 
==== Ejemplo de llamada ====
 
En esta llamada se obtiene el número de módulos del grupo "Servers"
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=extension&ext_name=module_groups&ext_function=groupmodules&id=Servers&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
===Funciones API===
 
Las siguientes funciones las puede usar en el código de la función de su llamada :
 
 
*returnError(typeError, returnType): devuelve un error de manera uniforme para todas las llamadas.
 
:*typeError: de momento 'id_not_found' o null.
 
:*returnType: de momento 'string' o mensaje de error.
 
*returnData(returnType, data, separator): es la función que retorna los datos de la llamada del API.
 
:*returnType: que puede ser 'string', 'csv', 'csv_head'
 
:*data: es un array que contiene los datos asi como su formato, tiene los siguientes campos:
 
::*'type' (obligatorio): que puede ser 'string' y 'array'.
 
::*'list_index' (opcional): contiene un array de índices numéricos conteniendo los índices alfanuméricos que se desean sacar por salida.
 
::*'data' (obligatorio): contiene o un string con el dato o un array de índice alfanuméricos o numéricos con los datos.
 
 
===Ejemplo===
 
<code><pre>
 
function api_get_module_last_value($idAgentModule, $trash1, $other = ';', $returnType)
 
{
 
$sql = sprintf('SELECT datos FROM tagente_estado WHERE id_agente_modulo = %d', $idAgentModule);
 
$value = get_db_value_sql($sql);
 
if ($value === false) {
 
switch ($other['type']) {
 
case 'string':
 
switch ($other['data']) {
 
case 'error_message':
 
default:
 
returnError('id_not_found', $returnType);
 
break;
 
}
 
break;
 
case 'array':
 
switch ($other['data'][0]) {
 
case 'error_value':
 
returnData($returnType, array('type' => 'string', 'data' => $other['data'][1]));
 
break;
 
}
 
break;
 
}
 
}
 
else {
 
$data = array('type' => 'string', 'data' => $value);
 
returnData($returnType, $data);
 
}
 
}
 
</pre></code>
 
 
==Llamadas al API==
 
Se dividen en dos grupos según si devuelven o escriben datos en Pandora FMS.
 
 
Existe una excepción: La llamada de retorno de información.
 
 
===RETORNO DE INFORMACIÓN===
 
Devuelve la versión de Pandora Console, de un modo parecido a la función ''get test'' pero sin chequear la conexión al API.
 
 
Esta llamada es útil para verificar que en esta ruta se encuentra una instalación de Pandora FMS y para obtener la versión antes de la autenticación.
 
 
La información que devuelve se puede obtener de la pantalla de login, por lo que no se considera que se vulnere la seguridad.
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?info=version
 
</nowiki>
 
Un ejemplo de respuesta podría ser: ''Pandora FMS v5.0 - PC131015''
 
 
===GET===
 
Devuelve los datos solicitados.
 
 
====get test====
 
Chequea la conexión al API y devuelve la versión del Pandora Console.
 
 
 
{{metaconsola}}
 
 
Sintaxis de la llamada:
 
Sin parámetros
 
 
=====Ejemplos=====
 
Este ejemplo devolverá OK,[version],[build]
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=test&apipass=1234&user=admin&pass=pandora
 
</nowiki>
 
Un ejemplo de respuesta podría ser: ''OK,v4.0.2,PC120614''
 
 
====get all_agents====
 
Devuelve la lista de agentes filtrados por los filtros seteados en other.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=all_agents (obligatorio)
 
*return_type= csv o json (obligatorio)
 
*other=&lt;parámetros serializados&gt; (opcional) parámetros para filtrar la búsqueda de agentes, serializados:
 
:*&lt;filter_so&gt;
 
:*&lt;filter_group&gt;
 
:*&lt;filter_module_states&gt;
 
:*&lt;filter_alias&gt;
 
:*&lt;filter_policy&gt;
 
:*&lt;csv_separator&gt;
 
 
=====Ejemplos=====
 
Este ejemplo devolverá todos los agentes cuyo id_so sea igual a 1, id_group igual a 2, estado de warning, su alias contenga 'j', y su política asociada tenga id igual a 2.
 
 
Ejemplo para CSV: <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_agents&return_type=csv&other=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
Ejemplo para JSON: <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_agents&return_type=json&other=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora
 
</nowiki>
 
 
====get module_last_value====
 
Devuelve el último valor de un módulo, el cual se selecciona por el ID pasado por el parámetro id. Con el parámetro other puede añadir el código de error para que tu aplicación detecte este valor fuera del rango de valores del módulo.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=module_last_value (obligatorio)
 
*id=&lt;índice&gt; (obligatorio) debe ser un índice de un módulo agente.
 
*other=&lt;retorno error&gt; (opcional) que quieres que te devuelva si hay un error (no encontrado en DB el módulo normalmente).
 
:*Códigos de retorno de error son:
 
::*'error_message' devuelve error en un mensaje de texto.
 
::*'error_value'&lt;separador&gt;&lt;código o valor&gt devuelve ese código o valor de error. Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_&lt;separador&gt; para pasar el separador en other.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_last_value&id=63&other=error_value|0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_last_value&id=62&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get agent_module_name_last_value====
 
Devuelve el último valor de un módulo, el cual se selecciona por nombre del agente pasado por el parámetro id y nombre del módulo pasado por el id2. Con el parámetro other puede añadir el código de error para que tu aplicación detecte este valor fuera del rango de valores que puede ser el módulo.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=agent_module_name_last_value (obligatorio)
 
*id=&lt;alfanumerico&gt; (obligatorio) contiene el nombre del agente.
 
*id2=&lt;alfanumerico&gt; (obligatorio) contiene el nombre del módulo.
 
*other=&lt;retorno error&gt; (opcional) que quieres que te devuelva si hay un error (no encontrado en DB el modulo normalmente).
 
:*Códigos de retorno de error son:
 
::*'error_message' devuelve error en un mensaje de texto.
 
::*'error_value'&lt;separador&gt;&lt;código o valor&gt devuelve ese código o valor de error. Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_&lt;separador&gt; para pasar el separador en other.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agent_module_name_last_value&id=user&id2=cpu_user&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get agent_module_name_last_value_alias====
 
>= 7.0NG
 
 
Devuelve el último valor de un módulo, el cual se selecciona por alias del agente pasado por el parámetro id y nombre del módulo pasado por el id2. Con el parámetro other puede añadir el código de error para que tu aplicación detecte este valor fuera del rango de valores que puede ser el módulo.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=agent_module_name_last_value_alias (obligatorio)
 
*id=&lt;alfanumerico&gt; (obligatorio) contiene el alias del agente.
 
*id2=&lt;alfanumerico&gt; (obligatorio) contiene el nombre del modulo.
 
*other=&lt;retorno error&gt; (opcional) que quieres que te devuelva si hay un error (no encontrado en DB el módulo normalmente).
 
:*Códigos de retorno de error son:
 
::*'error_message' devuelve error en un mensaje de texto.
 
::*'error_value'&lt;separador&gt;&lt;código o valor&gt devuelve ese código o valor de error. Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_&lt;separador&gt; para pasar el separador en other.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agent_module_name_last_value_alias&id=pandorafms&id2=Memory_Used&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get module_value_all_agents====
 
Devuelve una lista de agentes y el valor para el módulo, este módulo lo tienen todos los agentes y es pasado el nombre como parámetro id.
 
 
 
Síntaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=module_value_all_agents (obligatorio)
 
*id=&lt;name of the module&gt; (obligatorio) contiene el nombre del módulo.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_value_all_agents&id=example_module_name&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get agent_modules====
 
Devuelve la lista de módulos de un agente filtrado por el id del agente pasado como parámetro id.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=agent_modules (obligatorio)
 
*return_type=&lt;csv&gt; (obligatorio) Formato de salida.
 
*other=&lt;valores serializados&gt; (obligatorio) Valores serializados para filtrar la búsqueda de módulos por agente:
 
:*&lt;id_agent&gt;
 
Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_&lt;separador&gt; para pasar el separador en other.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agent_modules&return_type=csv&other=14&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get module_id====
 
Devuelve la id de un módulo concreto de un agente.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=module_id (obligatorio)
 
*id= id del agente (obligatorio)
 
*other=nombre del modulo (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_id&id=5&other=Host%20Alive&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get locate_agent====
 
Obtiene el id del servidor donde se encuentra el agente, e imprime todo el resultado como un archivo csv.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=locate_agent (obligatorio)
 
*return_type=&lt;csv&gt; (obligatorio) Formato de salida.
 
*id=id_agent (obligatorio)
 
*other_mode= other_mode=url_encode_separator_&lt;separador&gt (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=locate_agent&return_type=csv&apipass=1234&user=admin&pass=pandora&id=Pepito&other_mode=url_encode_separator_%7C</nowiki>
 
 
====get policies====
 
Devuelve la lista políticas de un agente pasado su id dentro del parámetro other.
 
 
Síntaxis de llamada:
 
 
*op=get (obligatorio)
 
*op2=policies (obligatorio)
 
*return_type=&lt;csv&gt; (obligatorio)
 
*other=&lt;valores serializados&gt; (opcional) Parámetros serializados para filtrar la búsqueda de políticas por agente:
 
:*&lt;id_agent&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=policies&return_type=csv&other=&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get tree_agents====
 
Devuelve una completa lista organizada por grupos en el primer nivel, agentes el segundo nivel y módulos el tercer nivel. Esta lista se filtra por el parámetro other.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=tree_agents (obligatorio)
 
*return_type=&lt;tipo retorno&gt; (obligatorio) que puede ser 'csv' o 'csv_head'.
 
*other=&lt;string o parámetros serializados&gt; (opcional) en este caso puede ser simplemente el separador o una lista de parámetros en orden y separados con el caracter separador, vemos los dos casos:
 
::*&lt;separador&gt; el separador si del 'csv'
 
::*&lt;separador csv&gt;|&lt;carácter sustitución de retorno de carro&gt;|&lt;campos 1&gt;,&lt;campos 2&gt;,&lt;campos N&gt; se compondrá de los siguientes parámetros en orden (el carácter '|' de separación se puede especificar en "other_mode"):
 
:::*&lt;separador csv&gt;: separador de los campos en el CSV.
 
:::*&lt;caracter sustitución de retorno de carro&gt;: carácter que sustituirá si encuentra en algún valor devuelto el carácter retorno de carro para evitar la ambigüedad con el uso estándar de retorno de carro para especificar registros/filas en el CSV. Si se pasa un string en other, el carácter sustituto es el espacio en blanco.
 
:::*&lt;campos 1&gt;,&lt;campos 2&gt;,&lt;campos N&gt : los campos a mostrar en el CSV y el orden en que mostrarlos, los posibles campos son:
 
::::*type_row
 
::::*group_id
 
::::*group_name
 
::::*group_parent
 
::::*disabled
 
::::*custom_id
 
::::*group_description
 
::::*group_contact
 
::::*group_other
 
::::*agent_id
 
::::*alias
 
::::*agent_direction
 
::::*agent_comentary
 
::::*agent_id_group
 
::::*agent_last_contant
 
::::*agent_mode
 
::::*agent_interval
 
::::*agent_id_os
 
::::*agent_os_version
 
::::*agent_version
 
::::*agent_last_remote_contact
 
::::*agent_disabled
 
::::*agent_id_parent
 
::::*agent_custom_id
 
::::*agent_server_name
 
::::*agent_cascade_protection
 
::::*agent_name
 
::::*module_id_agent_modulo
 
::::*module_id_agent
 
::::*module_id_module_type
 
::::*module_description
 
::::*module_name
 
::::*module_max
 
::::*module_min
 
::::*module_interval
 
::::*module_tcp_port
 
::::*module_tcp_send
 
::::*module_tcp_rcv
 
::::*module_snmp_community
 
::::*module_snmp_oid
 
::::*module_ip_target
 
::::*module_id_module_group
 
::::*module_flag
 
::::*module_id_module
 
::::*module_disabled
 
::::*module_id_export
 
::::*module_plugin_user
 
::::*module_plugin_pass
 
::::*module_plugin_parameter
 
::::*module_id_plugin
 
::::*module_post_process
 
::::*module_prediction_module
 
::::*module_max_timeout
 
::::*module_custom_id
 
::::*module_history_data
 
::::*module_min_warning
 
::::*module_max_warning
 
::::*module_min_critical
 
::::*module_max_critical
 
::::*module_min_ff_event
 
::::*module_delete_pending
 
::::*module_id_agent_state
 
::::*module_data
 
::::*module_timestamp
 
::::*module_state
 
::::*module_last_try
 
::::*module_utimestamp
 
::::*module_current_interval
 
::::*module_running_by
 
::::*module_last_execution_try
 
::::*module_status_changes
 
::::*module_last_status
 
::::*module_plugin_macros
 
::::*module_macros
 
::::*module_critical_inverse  (solo versión 6.0SP1)
 
::::*module_warning_inverse  (solo versión 6.0SP1)
 
::::*alert_id_agent_module
 
::::*alert_id_alert_template
 
::::*alert_internal_counter
 
::::*alert_last_fired
 
::::*alert_last_reference
 
::::*alert_times_fired
 
::::*alert_disabled
 
::::*alert_force_execution
 
::::*alert_id_alert_action
 
::::*alert_type
 
::::*alert_value
 
::::*alert_matches_value
 
::::*alert_max_value
 
::::*alert_min_value
 
::::*alert_time_threshold
 
::::*alert_max_alerts
 
::::*alert_min_alerts
 
::::*alert_time_from
 
::::*alert_time_to
 
::::*alert_monday
 
::::*alert_tuesday
 
::::*alert_wednesday
 
::::*alert_thursday
 
::::*alert_friday
 
::::*alert_saturday
 
::::*alert_sunday
 
::::*alert_recovery_notify
 
::::*alert_field2_recovery
 
::::*alert_field3_recovery
 
::::*alert_id_alert_template_module
 
::::*alert_fires_min
 
::::*alert_fires_max
 
::::*alert_id_alert_command
 
::::*alert_command
 
::::*alert_internal
 
::::*alert_template_modules_id
 
::::*alert_templates_id
 
::::*alert_template_module_actions_id
 
::::*alert_actions_id
 
::::*alert_commands_id
 
::::*alert_templates_name
 
::::*alert_actions_name
 
::::*alert_commands_name
 
::::*alert_templates_description
 
::::*alert_commands_description
 
::::*alert_template_modules_priority
 
::::*alert_templates_priority
 
::::*alert_templates_field1
 
::::*alert_actions_field1
 
::::*alert_templates_field2
 
::::*alert_actions_field2
 
::::*alert_templates_field3
 
::::*alert_actions_field3
 
::::*alert_templates_id_group
 
::::*alert_actions_id_group'
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=tree_agents&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=tree_agents&return_type=csv&other=;|%20|type_row,group_id,agent_name&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get module_data====
 
Devuelve una lista de valores de un módulo, este módulo se filtra por el id pasado por el parámetro id. Y la lista de valores es desde la fecha actual hasta el límite del periodo pasado como segundo parámetro en el other, el primero es el separador de CSV.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=module_data (obligatorio)
 
*id=&lt;id_modulo&gt; (obligatorio)
 
*other_mode=url_encode_separator_<separador> (obligatorio)
 
*other=&lt;parámetros serializados&gt;(opcional)
 
::*el carácter de separación del CSV (punto por defecto)
 
::*el periodo (en segundos)
 
::*tiempo de inicio (<año><mes><día>T<hora>:<minuto>)
 
::*tiempo de final (<año><mes><día>T<hora>:<minuto>)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_data&id=17&other=;|604800|20121201T13:40|20171215T13:40&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get graph_module_data====
 
Devuelve la gráfica de un módulo como un fichero de imagen, generada con el método de la gráficas estáticas de Pandora FMS. Es necesario pasar el ancho, alto, periodo, nombre de la gráfica y fecha de comienzo (sabiendo que en Pandora FMS la fecha que se indica en las gráficas siempre es la del final de los datos), pasados todos ellos como other parámetro.
 
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=module_data (obligatorio)
 
*id=&lt;id_modulo&gt; (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;period&gt;
 
:*&lt;width&gt;
 
:*&lt;height&gt;
 
:*&lt;label&gt;
 
:*&lt;start_date&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=graph_module_data&id=17&other=604800|555|245|example|2009-12-07&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get events====
 
Devuelve la lista de eventos filtrados por el parámetro other.
 
 
 
{{metaconsola}}
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=events (obligatorio)
 
*return_type=csv (obligatorio)
 
*other_mode=url_encode_separator_| (opcional)
 
*other=&lt;parámetros serializados&gt; (opcional), son los siguientes en este orden:
 
:*&lt;separator&gt;
 
:*&lt;criticity&gt; de 0 a 4, o -1 como valor para evitar el parámetro
 
:*&lt;agent alias&gt;
 
:*&lt;module name&gt;
 
:*&lt;alert template name&gt;
 
:*&lt;user&gt;
 
:*&lt;numeric interval minimum level &gt; en formato de tiempo unix
 
:*&lt;numeric interval maximum level &gt; en formato de tiempo unix
 
:*&lt;status&gt;
 
:*&lt;event substring&gt;
 
:*&lt;register limit&gt;
 
:*&lt;offset register&gt;
 
:*&lt;optional style [total|more_criticity]&gt; (total - retorna el total,  more_criticity - retorna los de mayor criticidad)
 
:*&lt;event type&gt; unknown, alert_fired, alert_recovered,.. o subcadena. Puedes usar 'not_normal'.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=events&return_type=csv&apipass=1234&user=admin&pass=pandora</nowiki>
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=events&other_mode=url_encode_separator_|&return_type=csv&other=;|2|SERVER|CPU|template_alert00||1274715715|127471781&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get all_alert_templates====
 
Devuelve la lista de plantillas de alertas definidas en el Pandora FMS.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=all_alert_templates (obligatorio)
 
*other=cvs_separator (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_alert_templates&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get module_groups====
 
Devuelve la lista de grupos de módulos.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=module_groups (obligatorio)
 
*other=cvs_separator (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_groups&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get plugins====
 
Devuelve la lista de plugins de servidor de Pandora FMS.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=plugins (obligatorio)
 
*other=cvs_separator (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=plugins&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get tags====
 
Devuelve la lista de tags definida en Pandora.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=tags (obligatorio)
 
*return_type=csv (obligatorio)
 
 
=====Ejemplos=====
 
Este ejemplo devolverá todos los tags del sistema.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=tags&return_type=csv&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get module_from_conf====
 
>= 5.0 (Sólo Enterprise)
 
 
Devuelve la configuración de módulo local.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=update_module_in_conf (obligatorio)
 
*id=&lt;id agente&gt; (obligatorio)
 
*id2=&lt;nombre módulo&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_from_conf&apipass=1234&user=admin&pass=pandora&id=9043&id2=example_name</nowiki>
 
 
Si no se encuentra el módulo se retornará cadena vacía
 
 
====get total_modules====
 
Devuelve el número total de módulos de un grupo.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=total_modules (obligatorio)
 
*id=&lt;id grupo&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=total_modules&id=2&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
 
Si se pone 0 como id de grupo, retornará el número total de módulos.
 
 
====get total_agents====
 
Devuelve el número total de agentes de un grupo.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=total_agents (obligatorio)
 
*id=&lt;id grupo&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=total_agents&id=2&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get agent_name====
 
Devuelve el nombre de un agente dado su identificador.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=agent_name (obligatorio)
 
*id=&lt;id agente&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=agent_name&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get agent_alias====
 
>= 7.0NG
 
 
Devuelve el alias de un agente dado su identificador.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=agent_alias (obligatorio)
 
*id=&lt;id agente&gt; (obligatorio)
 
*id2=<id del nodo> (obligatorio en la metaconsola, innecesario en el nodo)
 
 
=====Ejemplos=====
 
* Nodo:
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=agent_alias&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
* Metaconsola:
 
 
<nowiki>http://localhost/pandora_console/enterprise/meta/include/api.php?op=get&op2=agent_alias&id=1&id2=1&apipass=1234&user=admin&pass=pandora</nowiki><nowiki>Insert non-formatted text here</nowiki>
 
 
====get module_name====
 
Devuelve el nombre de un módulo dado su identificador.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=module_name (obligatorio)
 
*id=&lt;id modulo&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=module_name&id=1&apipass=1234&user=admin&pass=pandora
 
</nowiki>
 
 
====get alert_action_by_group====
 
Devuelve el total de ejecuciones de alertas con una determinada acción por grupo.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=alert_action_by_group (obligatorio)
 
*id=&lt;id grupo&gt; (obligatorio)
 
*id2=&lt;id acción&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=alert_action_by_group&id=0&id2=3&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get alert_actions====
 
Lista acciones de alertas
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=alert_actions (obligatorio)
 
*return_type=&lt;tipo retorno&gt; (obligatorio) que puede ser 'csv' o 'json'.
 
*other=&lt;parámetros serializados&gt; (opcional):
 
:*&lt;action_name&gt; (opcional)
 
:*&lt;separator&gt; (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=alert_actions&apipass=1234&user=admin&pass=pandora&other=Create|&other_mode=url_encode_separator_|&return_type=json</nowiki>
 
 
====get alert_actions_meta====
 
{{metaconsola}}
 
Lista acciones de alertas de nodos desde la metaconsola.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=alert_actions_meta (obligatorio)
 
*return_type=&lt;tipo retorno&gt; (obligatorio) que puede ser 'csv' o 'json'.
 
*other=&lt;parámetros serializados&gt; (opcional):
 
:*&lt;server_name&gt; (Opcional)
 
:*&lt;action_name&gt; (opcional)
 
:*&lt;separator&gt; (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=alert_actions_meta&apipass=1234&user=admin&pass=pandora&other=nodo|Create|&other_mode=url_encode_separator_|&return_type=json</nowiki>
 
 
====get all_alert_commands====
 
Devuelve todos los comandos de alertas.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=all_alert_commands (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=all_alert_commands&return_type=csv&other=$&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get event_info====
 
Devuelve toda la información de un evento pasando el id de este evento.
 
 
 
{{metaconsola}}
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=event_info (obligatorio)
 
*id=&lt;id_evento&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=event_info&id=80&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get tactical_view====
 
Devuelve la siguiente lista de valores (que se puede ver en la página táctica de Pandora Console)
 
* monitor_checks
 
* monitor_not_init
 
* monitor_unknown
 
* monitor_ok
 
* monitor_bad
 
* monitor_warning
 
* monitor_critical
 
* monitor_not_normal
 
* monitor_alerts
 
* monitor_alerts_fired
 
* monitor_alerts_fire_count
 
* total_agents
 
* total_alerts
 
* total_checks
 
* alerts
 
* agents_unknown
 
* monitor_health
 
* alert_level
 
* module_sanity
 
* server_sanity
 
* total_not_init
 
* monitor_non_init
 
* agent_ok
 
* agent_warning
 
* agent_critical
 
* agent_unknown
 
* agent_not_init
 
* global_health
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=tactical_view (obligatorio)
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=tactical_view&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get pandora_servers====
 
>= 5.0
 
 
Devuelve la lista de servidores de Pandora FMS que hay.
 
 
call syntax:
 
*op=get (obligatorio)
 
*op2=pandora_servers (obligatorio)
 
*return_type=csv (obligatorio)
 
*other=cvs_separator (opcional)
 
 
=====Example=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=pandora_servers&return_type=csv&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
Devuelve los campos en el siguiente orden:
 
*nombre
 
*estado (1 - arriba, 0 - abajo)
 
*tipo (cadena legible por humanos)
 
*maestro (1 - maestro 0 - esclavo) ????
 
*módulos en ejecución
 
*módulos totales
 
*max retardo (seg)
 
*módulos de retraso
 
*hilos
 
*módulos en cola
 
*fecha y hora de actualización (cadena legible por humanos)
 
 
====get custom_field_id====
 
>= 5.0
 
 
Traduce el nombre de un campo custom al id que tiene en la base de datos.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=custom_field_id (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) en este caso el nombre del custom field
 
:*&lt;name&gt; (obligatorio)
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=custom_field_id&other=mycustomfield&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki><nowiki>Insert non-formatted text here</nowiki>
 
 
====get gis_agent====
 
>= 5.0
 
 
Devuelve el último valor GIS de un agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=gis_agent (obligatorio)
 
*id=<índice> (obligatorio) debe ser un índice de un agente.
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=gis_agent&id=1</nowiki>
 
 
====get special_days====
 
>= 5.1
 
 
Devuelve listado de días especiales.
 
 
Sintaxis:
 
 
*op=get (obligatorio)
 
*op2=special_days (obligatorio)
 
*other=<csv separador> (opcional) CSV separador
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1111&user=admin&pass=pandora&op=get&op2=special_days</nowiki>
 
 
====get module_properties====
 
>= 5.1SP2
 
 
Devuelve una lista de las propiedades del módulo. La lista podría ser filtrada por el parámetro.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=module_properties (obligatorio)
 
*id=<id_modulo> (obligatorio)
 
*return_type=&lt;tipo retorno&gt; (obligatorio) que puede ser 'csv' o 'csv_head'.
 
*other=&lt;string o parámetros serializados&gt; (opcional) en este caso puede ser simplemente el separador o una lista de parámetros en orden y separados con el carácter separador, vemos los dos casos:
 
::*&lt;separador&gt; el separador si del 'csv'
 
::*&lt;separador csv&gt;|&lt;caracter sustitución de retorno de carro&gt;|&lt;campos 1&gt;,&lt;campos 2&gt;,&lt;campos N&gt; se compondra de los siguientes parámetros en orden (el caracter '|' de separación se puede especificar en "other_mode"):
 
:::*&lt;separador csv&gt;: separador de los campos en el CSV.
 
:::*&lt;caracter sustitucion de retorno de carro&gt;: caracter que sustituira si encuentra en algún valor devuelto el carácter retorno de carro para evitar la ambigüedad con el uso estándar de retorno de carro para especificar registros/filas en el CSV. Si se pasa un string en other, el carácter sustituto es el espacio en blanco.
 
:::*&lt;campos 1&gt;,&lt;campos 2&gt;,&lt;campos N&gt : los campos a mostrar en el CSV y el orden en que mostrarlos, los posibles campos son:
 
::::*module_id_agent_modulo
 
::::*module_id_agent
 
::::*module_id_module_type
 
::::*module_description
 
::::*module_name
 
::::*module_max
 
::::*module_min
 
::::*module_interval
 
::::*module_tcp_port
 
::::*module_tcp_send
 
::::*module_tcp_rcv
 
::::*module_snmp_community
 
::::*module_snmp_oid
 
::::*module_ip_target
 
::::*module_id_module_group
 
::::*module_flag
 
::::*module_id_module
 
::::*module_disabled
 
::::*module_id_export
 
::::*module_plugin_user
 
::::*module_plugin_pass
 
::::*module_plugin_parameter
 
::::*module_id_plugin
 
::::*module_post_process
 
::::*module_prediction_module
 
::::*module_max_timeout
 
::::*module_custom_id
 
::::*module_history_data
 
::::*module_min_warning
 
::::*module_max_warning
 
::::*module_min_critical
 
::::*module_max_critical
 
::::*module_min_ff_event
 
::::*module_delete_pending
 
::::*module_id_agent_state
 
::::*module_data
 
::::*module_timestamp
 
::::*module_state
 
::::*module_last_try
 
::::*module_utimestamp
 
::::*module_current_interval
 
::::*module_running_by
 
::::*module_last_execution_try
 
::::*module_status_changes
 
::::*module_last_status
 
::::*module_plugin_macros
 
::::*module_macros
 
::::*module_critical_inverse  (solo versión 6.0SP1)
 
::::*module_warning_inverse  (solo versión 6.0SP1)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_properties&id=6233&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_properties&id=1103&return_type=csv&other=;|%20|module_id_agent_module,module_id_module_type,module_name,module_last_try,module_state&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora
 
</nowiki>
 
 
====get module_properties_by_name====
 
>= 5.1SP2
 
 
Devuelve una lista de las propiedades del módulo. La lista podria ser filtrada por el parámetro.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=module_properties (obligatorio)
 
*id=<nombre agente> (obligatorio)
 
*id2=<nombre modulo> (obligatorio)
 
*return_type=&lt;tipo retorno&gt; (obligatorio) que puede ser 'csv' o 'csv_head'.
 
*other=&lt;string o parametros serializados&gt; (opcional) en este caso puede ser simplemente el separador o una lista de parametros en orden y separados con el caracter separador (el mismo que get_module_properties. para mas detalles, consulte el get_module_properties.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_properties_by_name&id=my_agent&id2=my_module&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_properties_by_name&id=my_agent&id2=my_module&return_type=csv&other=;|%20|module_id_agent_module,module_id_module_type,module_type,module_name,module_last_try,module_state&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get module_properties_by_alias====
 
>= 7.0NG
 
 
Devuelve una lista de las propiedades del módulo. La lista podria ser filtrada por el parámetro.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=module_properties (obligatorio)
 
*id=<alias agente> (obligatorio)
 
*id2=<nombre modulo> (obligatorio)
 
*return_type=&lt;tipo retorno&gt; (obligatorio) que puede ser 'csv' o 'csv_head'.
 
*other=&lt;string o parámetros serializados&gt; (opcional) en este caso puede ser simplemente el separador o una lista de parámetros en orden y separados con el carácter separador (el mismo que get_module_properties. para más detalles, consulte el get_module_properties.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_properties_by_alias&id=pandorafms&id2=Memory_Used&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora
 
</nowiki>
 
 
====get module_graph====
 
>= 6.0
 
 
Devuelve una gráfica de un módulo codificada con base64.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=module_graph (obligatorio)
 
*id=<id del módulo> (obligatorio)
 
*other=<período en segundos> (opcional) por defecto 3600 (1 hora). Rango de tiempo en el que se recogerán datos desde la fecha de la petición hacia atrás.
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=module_graph&id=5&other=3600%7C1&other_mode=url_encode_separator_%7C&apipass=1234&api=1&user=admin&pass=pandora
 
</nowiki>
 
 
====get all_planned_downtimes====
 
>= 5.1
 
 
Devuelve todas las registros coincidentes de paradas planificadas.
 
 
op=get
 
op2=all_planned_downtimes
 
return_type=csv
 
other=<nombre> <id_grupo> <tipo_parada> <tipo ejecución> <tipo de periocidad> (filtros)
 
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_planned_downtimes&other=test|0|quiet|periodically|weekly&other_mode=url_encode_separator_|&return_type=json&apipass=1234&user=admin&pass=pandora
 
</nowiki> <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_planned_downtimes&other=test|0|quiet|periodically|weekly&other_mode=url_encode_separator_|&return_type=csv&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get planned_downtimes_items====
 
>= 5.1
 
 
Retorna todos los objetos de las paradas planificadas que sean coincidentes.
 
 
op=get
 
op2=planned_downtimes_items
 
return_type=csv
 
other=<nombre> <grupo> <tipo_parada> <tipo ejecución> <tipo de periocidad>
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=planned_downtimes_items&other=test|0|quiet|periodically|weekly&other_mode=url_encode_separator_|&return_type=json&apipass=1234&user=admin&pass=pandora
 
</nowiki> <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=planned_downtimes_items&other=test|0|quiet|periodically|weekly&other_mode=url_encode_separator_|&return_type=csv&apipass=1234&user=admin&pass=pandora
 
</nowiki>
 
 
====get id_group_agent_by_name====
 
>= 5.1
 
 
Retorna el id de grupo de un agente.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=id_group_agent_by_name
 
* other=<parámetros serializados> (opcional) parámetros para filtrar, serializados:
 
:* <nombre_agente>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=id_group_agent_by_name&other_mode=url_encode_separator_|&other=192.168.50.40
 
</nowiki>
 
 
====get id_group_agent_by_alias====
 
>= 7.0NG
 
 
Retorna el id de grupo de un agente.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=id_group_agent_by_alias
 
* other=<parámetros serializados> (opcional) parámetros para filtrar, serializados:
 
:* <alias_agente>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=id_group_agent_by_alias&other_mode=url_encode_separator_%7C&other=pandorafms
 
</nowiki>
 
 
====get group_agent_by_name====
 
>= 5.1
 
 
Retorna el nombre de grupo de un agente.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=group_agent_by_name
 
* other=<parámetros serializados> (opcional) parámetros para filtrar, serializados:
 
:* <nombre_agente>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=group_agent_by_name&other_mode=url_encode_separator_|&other=192.168.50.40
 
</nowiki>
 
 
====get group_agent_by_alias====
 
>= 7.0NG
 
 
Retorna el nombre de grupo de un agente.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=group_agent_by_alias
 
* other=<parámetros serializados> (opcional) parámetros para filtrar, serializados:
 
:* <alias_agente>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=group_agent_by_alias&other_mode=url_encode_separator_%7C&other=pandorafms
 
</nowiki>
 
 
====get group_id_by_name====
 
>= 7.0NG
 
 
Retorna el id de grupo a partir del nombre.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=group_id_by_name
 
* other=<parámetros único> (obligatorio):
 
:* <group_name>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=group_id_by_name&other=Servers</nowiki>
 
 
====get timezone====
 
>= 7.0NG
 
 
Retorna el timezone con el que está configurado Pandora FMS.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=timezone
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=timezone</nowiki>
 
 
====get cluster_status====
 
>= 7.0
 
 
Obtener estado del cluster a partir del id
 
 
*op=get
 
*op2=cluster_status
 
*id=id del cluster
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=cluster_status&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get cluster_id_by_name====
 
>= 7.0
 
 
Obtener id de cluster a partir del nombre
 
 
*op=get
 
*op2=cluster_id_by_name
 
*id=nombre del cluster
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=cluster_id_by_name&id=paco&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get agents_id_name_by_cluster_id====
 
>= 7.0
 
 
Obtener los id => nombres de los agentes del cluster a partir del id de cluster
 
 
*op=get
 
*op2=agents_id_name_by_cluster_id
 
*id=id del cluster
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agents_id_name_by_cluster_id&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get agents_id_name_by_cluster_name====
 
>= 7.0
 
 
Obtener los id => nombres de los agentes del cluster a partir del nombre de cluster
 
 
*op=get
 
*op2=agents_id_name_by_cluster_name
 
*id=id del cluster
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agents_id_name_by_cluster_name&id=example&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get modules_id_name_by_cluster_id====
 
>= 7.0
 
 
Obtener los id => nombres de todos los módulos de los agentes del cluster a partir del id del cluster
 
 
*op=get
 
*op2=modules_id_name_by_cluster_id
 
*id=id del cluster
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=modules_id_name_by_cluster_id&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get modules_id_name_by_cluster_name====
 
>= 7.0
 
 
Obtener los id => nombres de todos los módulos de los agentes del cluster a partir del nombre del cluster
 
 
*op=get
 
*op2=modules_id_name_by_cluster_name
 
*id=id del cluster
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=modules_id_name_by_cluster_name&id=example&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get cluster_items====
 
>= 7.0
 
 
Obtener los items en un objeto json con el formato:  id de item => {nombre,id_agente_modulo,type,pcrit,pwarn}, apartir del id del cluster
 
 
pcrit: % para estado critico si es AA y 1 o 0 si es AP
 
 
pwarn: % para estado warning si es AP y nulo si es AP
 
 
*op=get
 
*op2=cluster_items
 
*id=id del cluster
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=cluster_items&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get policy====
 
>= 7.0NG. 725
 
 
Devuelve todos los datos de una política. Si no se especifica un id de política devolverá todos los datos de todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=policy
 
* id=id_policy (opcional)
 
* return_type=(json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=policy&apipass=1234&user=admin&pass=pandora&return_type=json.</nowiki>
 
 
====get collections_policy====
 
>= 7.0NG. 725
 
 
Devuelve todas las colecciones de una política, si no se especifica un id de política devolverá todas las colecciones de todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=collections_policy
 
* id=id_policy (opcional)
 
* return_type=(json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=collections_policy&apipass=1234&user=admin&pass=pandora&return_type=json.</nowiki>
 
 
====get plugins_policy====
 
>= 7.0NG. 725
 
 
Devuelve todas los plugins de una política, si no se especifica un id de política devolverá todos los plugins de todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=plugins_policy
 
* id=id_policy (opcional)
 
* return_type=(json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=plugins_policy&apipass=1234&user=admin&pass=pandora&return_type=json.</nowiki>
 
 
====get inventory_policy====
 
>= 7.0NG. 725
 
 
Devuelve todos los módulos de inventario de una política, si no se especifica un id de política devolverá todos los módulos de inventario de todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=inventory_policy
 
* id=id_policy (opcional)
 
* return_type=(json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=inventory_policy&apipass=1234&user=admin&pass=pandora&return_type=json&id=2</nowiki>
 
 
====get unlinking_policy====
 
>= 7.0NG. 725
 
 
Devuelve todos los módulos deslincados de una política, si no se especifica un id de política devolverá todos los módulos deslincados de todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=unlinking_policy
 
* id=id_policy(opcional)
 
* return_type=(json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=unlinking_policy&apipass=1234&user=admin&pass=pandora&return_type=json.</nowiki>
 
 
====get alerts_policy====
 
>= 7.0NG. 725
 
 
Devuelve las alertas asociadas a una política teniendo en cuenta:
 
 
* Si se especifica un id de política se mostraran las alertas de dicha política sino se mostrarán las de todas las políticas.
 
* Si se especifica el tipo de alerta:(tres opciones).
 
** 0: por defecto muestra todas.
 
** 1: Muestra solo las alertas normales.
 
** 2: Muestra solo las alertas de tipo externo.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=alerts_policy
 
* id=id_policy(opcional).
 
* id2= 0:todas(por defecto), 1:normal, 2:external.
 
* return_type=(json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=alerts_policy&apipass=1234&user=admin&pass=pandora&return_type=json&id2=2.</nowiki>
 
 
====get alerts_actions_policy====
 
>= 7.0NG. 725
 
 
Devuelve las acciones de las alertas asociadas a una política teniendo en cuenta:
 
 
* Si se especifica un id de política se mostraran las acciones de las alertas de dicha política sino se mostrarán las de todas las políticas.
 
* Si se especifica un id de alerta de política se mostrarán las acciones de dicha alerta especificada.
 
 
Sintaxis de la llamada:
 
 
* op = get
 
* op2 = alerts_actions_policy
 
* id = id_policy(opcional).
 
* id2 = id_policy_alert(opcional).
 
* return_type=(json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=alerts_actions_policy&apipass=1234&user=admin&pass=pandora&return_type=json&id=1&id2=3</nowiki>
 
 
====get agents_policy====
 
>= 7.0NG. 725
 
 
Devuelve todos los agentes que pertenecen a una política, si no se especifica un id de política devolverá todos agentes que pertenecen a todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op = get
 
* op2 = agents_policy
 
* id = id_policy(opcional)
 
* return_type = (json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=agents_policy&apipass=1234&user=admin&pass=pandora&return_type=json.</nowiki>
 
 
====get groups_policy====
 
>= 7.0NG. 725
 
 
Devuelve todos los grupos que pertenecen a una política, si no se especifica un id de política devolverá todos grupos que pertenecen a todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op = get
 
* op2 = groups_policy
 
* id = id_policy(opcional)
 
* return_type = (json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=groups_policy&apipass=1234&user=admin&pass=pandora&return_type=json&id=2</nowiki>
 
 
====get queue_policy====
 
>= 7.0NG. 725
 
 
Devuelve la cola que pertenecen a una política, si no se especifica un id de política devolverá todas las colas que pertenecen a todas las políticas.
 
 
Sintaxis de la llamada:
 
 
* op = get
 
* op2 = queue_policy
 
* id = id_policy(opcional)
 
* return_type = (json, csv, string).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=queue_policy&apipass=1234&user=admin&pass=pandora&return_type=json</nowiki>
 
 
====get traps====
 
>= 7.0NG. 728
 
 
Devuelve los traps de origen especificado, también puedes filtrar por timestamp y otros datos.
 
 
Sintaxis de la llamada:
 
 
* op = get
 
* op2 = traps
 
* other=<parámetros opcionales>:
 
:* <timestamp>
 
:* <limit>
 
:* <offset>
 
:* <status>
 
:* <oid_custom>
 
 
=====Ejemplo=====
 
<nowiki>https://localhost/pandora_console/include/api.php?op=get&op2=traps&other=1537128000%7C9000%7C0%7C1%7C.1.2.3.6.4&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get event_responses====
 
Devuelve la lista de respuesta de eventos a las que el usuario tiene acceso en Pandora FMS.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=event_reponses (obligatorio)
 
*return_type=csv|json (obligatorio)
 
 
=====Ejemplo=====
 
Este ejemplo devolverá todas las respuestas de eventos del sistema en formato csv.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=event_responses&return_type=csv&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get users====
 
Devuelve la lista de los usuario de Pandora FMS.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=users (obligatorio)
 
*return_type=csv|json (obligatorio)
 
 
=====Ejemplo=====
 
Este ejemplo devolverá todos usuario del sistema en formato csv.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=users&json&return_type=csv&other_mode=url_encode_separator_&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get list all user====
 
{{metaconsola}}
 
Listar todos los usuarios de Pandora FMS
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=list_all_user (obligatorio)
 
*return_type=csv|json (obligatorio)
 
 
=====Ejemplo=====
 
Puede retornar Json o CSV, este retorno se indica mediante la URL
 
solo se indica el tipo de retorno, no usa ninguna variable en específico
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=list_all_user&return_type=json&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get info user name====
 
{{metaconsola}}
 
Lista la informacion de un usuario
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=info_user_name (obligatorio)
 
*return_type=csv|json (obligatorio)
 
*other=nombre de usuario(obligatorio)
 
 
=====Ejemplo=====
 
Obtenemos toda la información de un usuario específico
 
Puede retornar Json o CSV, este retorno se indica mediante la URL
 
Usamos unicamente el nombre del usuario para obtener dicha información:
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=info_user_name&return_type=json&other=admin&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get user_profiles_info====
 
Devuelve la lista de los perfiles de usuario de Pandora FMS.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=user_profiles_info (obligatorio)
 
*return_type=csv|json (obligatorio)
 
 
=====Ejemplo=====
 
Este ejemplo devolverá todos los perfiles de usuario del sistema en formato json.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=user_profiles_info&return_type=json&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get migrate_agent====
 
>= 7.21 ONLY METACONSOLE
 
 
Mira si existe en la cola de migración de agentes un agente determinado devolviendo los datos de tmigration_queue
 
 
*op=get
 
*op2=migrate_agent
 
*id=id_agente a migrar
 
*return_type = string, json, etc
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=migrate_agent&apipass=1234&user=admin&pass=pandora&id=2&return_type=json</nowiki>
 
 
====get language====
 
>= 7.0NG 730
 
 
Retorna el idioma con el que está configurado Pandora FMS.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=language
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=language</nowiki>
 
 
====get session_timeout====
 
>= 7.0NG 730
 
 
Retorna el tiempo de sesión con el que está configurado Pandora FMS.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=session_timeout
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=get&op2=session_timeout</nowiki>
 
 
====get groups====
 
Retorna los grupos existentes.
 
 
Sintaxis de la llamada:
 
 
* op=get
 
* op2=groups
 
* other=<parámetros opcionales>:
 
:* <csv_separator>: ';' por defecto.
 
:* <return_all_group>: devuelve grupo 'All'.
 
:* <return_all_columns>: devuelve todas las columnas.
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=groups&other=;%7C1%7C0&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get filter user group====
 
{{metaconsola}}
 
Obtener grupos de usuario mediante filtrado.
 
 
Sintaxis de la llamada:
 
 
* op=get (obligatorio)
 
* op2=filter_user_group (obligatorio)
 
* return_type=csv|json(obligatorio)
 
*other= id group(obligatorio)|Habilitado o no(Disabled)(obligatorio)
 
 
=====Ejemplo=====
 
Puede retornar Json o CSV, este retorno se indica mediante la URL.
 
 
{{Warning|Puedes tener una de las dos variables (id grupo o Habilitado) vacías, pero tiene que tener mínimo una de ellas.}}
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=filter_user_group&return_type=json&other=0|0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get inventory_modules====
 
Devuelve la lista de los módulos de inventario de Pandora FMS.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=inventory_modules (obligatorio)
 
*return_type=csv|json (obligatorio)
 
 
=====Ejemplos=====
 
Este ejemplo devolverá información de todos los de inventario del sistema en formato json.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=inventory_modules&return_type=json&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get list_collections====
 
Devuelve la lista de todas las colecciones en Pandora FMS.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=list_collections (obligatorio)
 
 
=====Ejemplos=====
 
Este ejemplo devolverá información de todos las colecciones en formato json.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=list_collections&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get list_collection_files====
 
Devuelve la lista de todos los ficheros de una colección. Si no se le pasa id de colección, devolverá todos los ficheros de todas las colecciones.
 
 
Sintaxis de la llamada:
 
*op=get (obligatorio)
 
*op2=list_collections_files (obligatorio)
 
*id=id_collection
 
 
=====Ejemplos=====
 
Este ejemplo devolverá los nombres de todos los ficheros de una colección en formato json.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=get&op2=list_collection_files&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
===SET===
 
Envia los datos.
 
 
====set new_agent====
 
Crea un nuevo agente con los datos pasados como parámetros.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_agent (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del agente, serializados en el siguiente orden:
 
:*&lt;alias_agente&gt;
 
:*&lt;ip&gt;
 
:*&lt;id_parent&gt;
 
:*&lt;id_group&gt;
 
:*&lt;cascade_protection&gt;
 
:*&lt;cascade_protection_module&gt;
 
:*&lt;interval_sec&gt;
 
:*&lt;id_os&gt;
 
:*&lt;name_server&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;learning_mode&gt;
 
:*&lt;disabled&gt;
 
:*&lt;description&gt;
 
:*&lt;alias_as_name&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_agent&other=agente_alias%7C1.1.1.1%7C0%7C4%7C0%7C0%7C300%7C10%7Cpandorafms%7C8%7C10%7C%7Cla%20descripcion%7C1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
*Nota: Si ''alias_as_name'' es un 1, el nombre del agente será igual al alias. Si es un 0, el nombre del agente se generará automáticamente.
 
 
====set update_agent====
 
Actualiza el agente con los datos pasados como parámetros.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_agent (obligatorio)
 
*id=&lt;id_agente&gt; (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del agente, serializados en el siguiente orden:
 
:*&lt;alias_agente&gt;
 
:*&lt;ip&gt;
 
:*&lt;id_parent&gt;
 
:*&lt;id_group&gt;
 
:*&lt;cascade_protection&gt;
 
:*&lt;cascade_protection_module&gt;
 
:*&lt;interval_sec&gt;
 
:*&lt;id_os&gt;
 
:*&lt;name_server&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;learning_mode&gt;
 
:*&lt;disabled&gt;
 
:*&lt;description&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?id=5&op=set&op2=update_agent&other=agente_nombre|1.1.1.1|0|4|0|0|30|8|localhost.localdomain||0|0|la%20descripcion&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_agent====
 
Elimina un agente pasando el nombre como parámetro.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_agent (obligatorio)
 
*id=&lt;nombre_agente&gt; (obligatorio) debe ser un nombre agente.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_agent&id=agente_erroneo&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_module_template====
 
Crea una alerta a partir de la plantilla pasada como id, en un módulo elegido por id de módulo y id de agente que estarán en other.
 
 
Sintaxis de llamada:
 
*op=set (obligatorio)
 
*op2=create_module_template (obligatorio)
 
*id=&lt;id_template&gt; (obligatorio) debe ser un id de template.
 
*other=&lt;id_modulo&gt;|&lt;id_agente&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_module_template&id=1&other=1|10&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set apply_module_template====
 
Aplicar una plantilla de módulos a un agente..
 
 
Estas plantillas de módulos son una agrupación que contiene módulos de comprobación de red.  Estas plantillas pueden ser aplicadas directamente a agentes, evitando tener que añadir módulos uno a uno.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=apply_module_template (obligatorio)
 
*id=&lt;id_template&gt; (obligatorio) id de la plantilla que se aplicará sobre el agente.
 
*id2=&lt;id_agente&gt; (obligatorio) id del agente en el que se crearán los módulos.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=apply_module_template&id=2&id2=2&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_network_module====
 
Crea un módulo de red con los datos pasados como parámetros.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_network_module (obligatorio)
 
*id=&lt;nombre_agente&gt; (obligatorio) debe ser un nombre agente.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del modulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ip_target&gt;
 
:*&lt;tcp_port&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;each_ff&gt; (solo version 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;critical_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;warning_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;ff_type&gt; (solo versión 7.34)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_network_module&id=example&other=prueba|0|7|1|10|15|0|16|18|0|15|0|127.0.0.1|0||0|180|0|0|0|0|latency%20ping&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_plugin_module====
 
Crea un módulo de tipo plugin con los datos pasados como parámetros.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_plugin_module (obligatorio)
 
*id=&lt;nombre_agente&gt; (obligatorio) debe ser un nombre agente.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del módulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ip_target&gt;
 
:*&lt;tcp_port&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;id_plugin&gt;
 
:*&lt;plugin_user&gt;
 
:*&lt;plugin_pass&gt;
 
:*&lt;plugin_parameter&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El contenido del documento JSON debe ser un objeto compuesto de varios objetos con las siguientes propiedades:
 
** ''"macro"'': Nombre del macro. Deben ser ''_field1_'', ''_field2_'', ..., ''_fieldN_''.
 
**''"desc"'': Nombre descriptivo del macro.
 
**''"help"'': Descripción del macro.
 
**''"value"'': Valor del macro.
 
**''"hide"'': Poner a "1" para ocultar el valor del macro (útil para almacenar contraseñas).
 
=====Ejemplo=====
 
{
 
  "1": {
 
    "macro": "_field1_",
 
    "desc": "Target&#x20;IP",
 
    "help": "",
 
    "value": "192.168.0.1",
 
    "hide": ""
 
  },
 
  "2": {
 
    "macro": "_field2_",
 
    "desc": "Port",
 
    "help": "",
 
    "value": "80",
 
    "hide": ""
 
  }
 
}
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;critical_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;warning_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_plugin_module&id=example&other=prueba|0|1|2|0|0||0|0||0|0|127.0.0.1|0||0|300|0|0|0|0|plugin%20module%20from%20api|4|2|admin|pass|-p%20max&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_data_module====
 
Crea un módulo con los parámetros pasados.
 
 
{{warning|Con esta llamada se puede añadir datos al módulo en la base de datos, pero no se puede modificar el fichero de configuración de los agentes asociados al módulo}}
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_data_module (obligatorio)
 
*id=&lt;nombre_agente&gt; (obligatorio) debe ser un nombre agente.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del módulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;description&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;post_process&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;history_data&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;ff_threshold&gt; (solo versión 5.1)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_timeout&gt; (solo versión 5.1)
 
:*&lt;critical_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;warning_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_data_module&id=example&other=prueba|0|1|data%20module%20from%20api|1|10|20|10.50|180|10|15||16|20||0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_SNMP_module====
 
Crea un módulo SNMP.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_snmp_module (obligatorio)
 
*id=&lt;nombre_agente&gt; (obligatorio) debe ser un nombre agente.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del módulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ip_target&gt;
 
:*&lt;module_port&gt;
 
:*&lt;snmp_version&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;snmp3_priv_method [AES|DES]&gt;
 
:*&lt;snmp3_priv_pass&gt;
 
:*&lt;snmp3_sec_level [authNoPriv|authPriv|noAuthNoPriv]&gt;
 
:*&lt;snmp3_auth_method [MD5|SHA]&gt;
 
:*&lt;snmp3_auth_user&gt;
 
:*&lt;snmp3_auth_pass&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
Ejemplo 1 (snmp v: 3, snmp3_priv_method: AES, snmp3_priv_pass: example_priv_passw, snmp3_sec_level: authNoPriv, snmp3_auth_method:MD5, snmp3_auth_user: pepito_user, snmp3_auth_pass: example_priv_passw)
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_snmp_module&id=example&other=prueba|0|15|1|10|15||16|18||15|0|127.0.0.1|60|3|public|.1.3.6.1.2.1.1.1.0|180|0|0|0|0|SNMP%20module%20from%20API|AES|example_priv_passw|authNoPriv|MD5|pepito_user|example_auth_passw&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
Ejemplo 2 (snmp v: 1)
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_snmp_module&id=pepito1&other=prueba2|0|15|1|10|15||16|18||15|0|127.0.0.1|60|1|public|.1.3.6.1.2.1.1.1.0|180|0|0|0|0|SNMP module from API&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_network_module====
 
Actualiza la configuración de un módulo de red.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_network_module (obligatorio)
 
*id=&lt;id_modulo&gt; (obligatorio) debe ser el ID numérico del módulo (tagente_modulo)
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del modulo, serializados en el siguiente orden:
 
:*&lt;id_agent&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ip_target&gt;
 
:*&lt;tcp_port&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;disabled_types_event&gt; (solo versión 5)
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;critical_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;warning_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;ff_type&gt; (solo versión 733)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_network_module&id=3431&other=44|0|6|2|10|15||16|18||7|0|127.0.0.1|0||0|300|30.00|0|0|0|latency%20ping%20modified%20by%20the%20Api&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_plugin_module====
 
Actualiza la configuración de un módulo plugin.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_plugin_module (obligatorio)
 
*id=&lt;nombre_modulo&gt; (obligatorio) debe ser el ID numérico del módulo a actualizar (tagente_modulo)
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del módulo, serializados en el siguiente orden:
 
:*&lt;id_agent&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ip_target&gt;
 
:*&lt;tcp_port&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;id_plugin&gt;
 
:*&lt;plugin_user&gt;
 
:*&lt;plugin_pass&gt;
 
:*&lt;plugin_parameter&gt;
 
:*&lt;disabled_types_event&gt; (solo versión 5)
 
:*&lt;macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El contenido del documento JSON debe ser un objeto compuesto de varios objetos con las siguientes propiedades:
 
** ''"macro"'': Nombre del macro. Deben ser ''_field1_'', ''_field2_'', ..., ''_fieldN_''.
 
**''"desc"'': Nombre descriptivo del macro.
 
**''"help"'': Descripción del macro.
 
**''"value"'': Valor del macro.
 
=====Ejemplo=====
 
{
 
  "1": {
 
    "macro": "_field1_",
 
    "desc": "Target&#x20;IP",
 
    "help": "",
 
    "value": "192.168.0.1"
 
  },
 
  "2": {
 
    "macro": "_field2_",
 
    "desc": "Port",
 
    "help": "",
 
    "value": "80"
 
  }
 
}
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;critical_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;warning_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_plugin_module&id=2343&other=44|0|2|0|0||0|0||0|0|127.0.0.1|0||0|300|0|0|0|0|plugin%20module%20from%20api|2|admin|pass|-p%20max&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_data_module====
 
<br>
 
{{warning|Con esta llamada se puede añadir datos al módulo en la base de datos, pero no se puede modificar el fichero de configuración de los agentes asociados al módulo}}
 
 
Actualiza un módulo local.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_data_module_policy (obligatorio)
 
*id=&lt;id_agent_module&gt; (obligatorio) debe ser el ID numérico del módulo a actualizar.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del módulo, serializados en el siguiente orden:
 
:*&lt;id_agent&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ip_target&gt;
 
:*&lt;module_port&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;disabled_types_event&gt; (solo versión 5)
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;ff_threshold&gt; (solo versión 5.1)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_timeout&gt; (solo versión 5.1)
 
:*&lt;critical_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;warning_inverse&gt; (solo versión 6.0SP1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_data_module&id=23234&other=44|0|data%20module%20modified%20from%20API|6|0|0|50.00|300|10|15||16|18||0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_data_module_policy====
 
Actualiza el módulo de datos de una política y devuelve el id del nuevo módulo.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_data_module (obligatorio)
 
*id=&lt;id_agent_module&gt; (obligatorio) debe ser el ID numérico de la política del módulo.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del módulo, serializados en el siguiente orden:
 
:*&lt;id_policy_module&gt;
 
:*&lt;description&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min&gt;
 
:*&lt;max&gt;
 
:*&lt;post_process&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;history_data&gt;
 
:*&lt;configuration_data&gt;
 
:*&lt;disabled_types_event&gt; (solo versión 5)
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_data_module_policy&id=1&other=10~data%20module%20updated%20by%20Api~2~0~0~50.00~10~20~180~~21~35~~1~module_begin%0dmodule_name%20pandora_process%0dmodule_type%20generic_data%0dmodule_exec%20ps%20aux%20|%20grep%20pandora%20|%20wc%20-l%0dmodule_end&other_mode=url_encode_separator_</nowiki>
 
 
====set update_SNMP_module====
 
Actualiza un módulo SNMP.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_snmp_module (obligatorio)
 
*id=&lt;id_module&gt; (obligatorio) debe ser un ID numérico de módulo.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del modulo, serializados en el siguiente orden:
 
:*&lt;id_agent&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ip_target&gt;
 
:*&lt;module_port&gt;
 
:*&lt;snmp_version&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;snmp3_priv_method [AES|DES]&gt;
 
:*&lt;snmp3_priv_pass&gt;
 
:*&lt;snmp3_sec_level [authNoPriv|authPriv|noAuthNoPriv]&gt;
 
:*&lt;snmp3_auth_method [MD5|SHA]&gt;
 
:*&lt;snmp3_auth_user&gt;
 
:*&lt;snmp3_auth_pass&gt;
 
:*&lt;disabled_types_event&gt; (solo versión 5)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;policy_linked&gt; (solo versión 6.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
Example (snmp v: 3, snmp3_priv_method: AES, snmp3_priv_pass: example_priv_passw, snmp3_sec_level: authNoPriv, snmp3_auth_method:MD5, snmp3_auth_user: pepito_user, snmp3_auth_pass: example_priv_passw)
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_snmp_module&id=33432&other=44|0|6|20|25||26|30||15|1|127.0.0.1|60|3|public|.1.3.6.1.2.1.1.1.0|180|50.00|10|60|0|SNMP%20module%20modified%20by%20API|AES|example_priv_passw|authNoPriv|MD5|example_user|example_auth_passw&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set apply_policy====
 
Aplica la política, pasada por id, en uno o varios agentes.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=apply_policy (obligatorio)
 
*id=&lt;id_policy&gt; (obligatorio)
 
*id2=&lt;id_agent&gt; (opcional) Id o nombre del agente según se indique en el parámetro other. Si viene vacío se aplicará la política a todos los agentes de esta.
 
*other=&lt;parámetros serializados&gt;
 
:*&lt;name_agent (Boolean)&gt; Indica si se enviará el agente por Id (0) o por nombre (1).
 
:*&lt;id_servidor&gt; (obligatorio en caso de usar Metaconsola) Id del servidor sobre el que se aplicará la política.
 
 
=====Ejemplos=====
 
<nowiki>http://192.168.70.102/pandora_console/include/api.php?op=set&op2=apply_policy&id=22&id2=3e&other=0|1&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set apply_all_policies====
 
Aplica todas las políticas que contiene Pandora.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=apply_all_policies (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=apply_all_policies&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_network_module_policy====
 
Añade un módulo de red en la política pasada por id en el parámetro.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_network_module_policy (obligatorio)
 
*id=&lt;id_politica&gt; (obligatorio) debe ser un Id de política
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del modulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;description&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;post_process&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;history_data&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;disabled&gt;
 
:*&lt;module_port&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_network_module_policy&id=1&other=network_module_policy_example_name|6|network%20module%20created%20by%20Api|2|0|0|50.00|180|10|20||21|35||1|15|0|66|||0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_plugin_module_policy====
 
Añade un módulo de plugin en la política pasada por id en el parámetro.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_plugin_module_policy (obligatorio)
 
*id=&lt;id_politica&gt; (obligatorio) debe ser un Id de política.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del modulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;module_port&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;id_plugin&gt;
 
:*&lt;plugin_user&gt;
 
:*&lt;plugin_pass&gt;
 
:*&lt;plugin_parameter&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El contenido del documento JSON debe ser un objeto compuesto de varios objetos con las siguientes propiedades:
 
** ''"macro"'': Nombre del macro. Deben ser ''_field1_'', ''_field2_'', ..., ''_fieldN_''.
 
**''"desc"'': Nombre descriptivo del macro.
 
**''"help"'': Descripción del macro.
 
**''"value"'': Valor del macro.
 
=====Ejemplo=====
 
{
 
  "1": {
 
    "macro": "_field1_",
 
    "desc": "Target&#x20;IP",
 
    "help": "",
 
    "value": "192.168.0.1"
 
  },
 
  "2": {
 
    "macro": "_field2_",
 
    "desc": "Port",
 
    "help": "",
 
    "value": "80"
 
  }
 
}
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_plugin_module_policy&id=1&other=example%20plugin%20module%20name|0|1|2|0|0||0|0||15|0|66|||300|50.00|0|0|0|plugin%20module%20from%20api|2|admin|pass|-p%20max&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_data_module_policy====
 
Añade un módulo local en la política pasada por id en el parámetro.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_data_module_policy (obligatorio)
 
*id=&lt;id_política&gt; (obligatorio) debe ser un Id de política.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del módulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;description&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;post_process&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;history_data&gt;
 
:*&lt;configuration_data&gt; Este es el bloque de definición del módulo que será insertado en el fichero de configuración del agente.
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;module_macros&gt; (solo versión 5) Los valores deben estar en formato JSON codificado en base 64. El formato de los datos del documento JSON debe ser ''"<nombre de macro>": "<valor de macro>"''.
 
:*&lt;ff_threshold&gt; (solo versión 5.1)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_timeout&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_data_module_policy&id=1&other=data_module_policy_example_name~2~data%20module%20created%20by%20Api~2~0~0~50.00~10~20~180~~21~35~~1~module_begin%0dmodule_name%20pandora_process%0dmodule_type%20generic_data%0dmodule_exec%20ps%20aux%20|%20grep%20pandora%20|%20wc%20-l%0dmodule_end&other_mode=url_encode_separator_~&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_SNMP_module_policy====
 
Añade un módulo SNMP en la política pasada por id en el parámetro.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_snmp_module_policy (obligatorio)
 
*id=&lt;id_política&gt; (obligatorio) debe ser un Id de política.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del modulo, serializados en el siguiente orden:
 
:*&lt;name_module&gt;
 
:*&lt;disabled&gt;
 
:*&lt;id_module_type&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;history_data&gt;
 
:*&lt;module_port&gt;
 
:*&lt;snmp_version&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;post_process&gt;
 
:*&lt;min_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;custom_id&gt;
 
:*&lt;description&gt;
 
:*&lt;snmp3_priv_method [AES|DES]&gt;
 
:*&lt;snmp3_priv_pass&gt;
 
:*&lt;snmp3_sec_level [authNoPriv|authPriv|noAuthNoPriv]&gt;
 
:*&lt;snmp3_auth_method [MD5|SHA]&gt;
 
:*&lt;snmp3_auth_user&gt;
 
:*&lt;snmp3_auth_pass&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_snmp_module_policy&id=1&other=example%20SNMP%20module%20name|0|15|2|0|0||0|0||15|1|66|3|public|.1.3.6.1.2.1.1.1.0|180|50.00|10|60|0|SNMP%20module%20modified%20by%20API|AES|example_priv_passw|authNoPriv|MD5|example_user|example_auth_passw&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_agent_policy_by_id====
 
Añade un agente en una política utilizando el ID de agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_agent_policy_by_id (obligatorio)
 
*id=&lt;id_política&gt; (obligatorio) debe ser un Id de política.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del agente, serializados en el siguiente orden:
 
:*&lt;id_agent&gt;
 
:*&lt;id_node&gt; (obligatorio en caso de usar Metaconsola) ID del nodo al que pertenece el agente que deseamos añadir a la política.
 
 
=====Ejemplos=====
 
* Nodo:
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_agent_policy_by_id&id=2&other=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
* Metaconsola:
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_agent_policy_by_id&id=2&other=1%7C1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_agent_policy_by_name====
 
Añade un agente en una política utilizando el nombre de agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_agent_policy_by_name (obligatorio)
 
*id=&lt;id_política&gt; (obligatorio) debe ser un Id de política.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del agente, serializados en el siguiente orden:
 
:*&lt;agent_name&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_agent_policy_by_name&id=4&other=e76774025b24057cc71df514f27027c43484c3af766ed40f259a86a4fd568f9d&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set remove_agent_from_policy_by_id====
 
Elimina un agente de una política utilizando el ID de agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=remove_agent_from_policy_by_id (obligatorio)
 
*id=&lt;id_política&gt; (obligatorio) debe ser un Id de política.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del agente, serializados en el siguiente orden:
 
:*&lt;id_agent&gt;
 
:*&lt;id_node&gt; (obligatorio en caso de usar Metaconsola) ID del nodo al que pertenece el agente que deseamos eliminar de la política.
 
 
=====Ejemplos=====
 
* Nodo:
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=remove_agent_from_policy_by_id&id=2&other=2&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
* Metaconsola:
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=remove_agent_from_policy_by_id&id=4&other=1%7C1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set remove_agent_from_policy_by_name====
 
Elimina un agente de una política utilizando el nombre de agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=remove_agent_from_policy_by_name (obligatorio)
 
*id=&lt;id_política&gt; (obligatorio) debe ser un Id de política.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del agente, serializados en el siguiente orden:
 
:*&lt;agent_name&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=remove_agent_from_policy_by_name&id=4&other=e76774025b24057cc71df514f27027c43484c3af766ed40f259a86a4fd568f9d&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_network_component====
 
Crea un nuevo componente de red.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_network_component (obligatorio)
 
*id=&lt;network_component_name&gt; (obligatorio) debe ser el nombre del componente de red.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del componente de red, serializados en el siguiente orden:
 
:*&lt;network_component_type&gt;
 
:*&lt;description&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;max_value&gt;
 
:*&lt;min_value&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;max_timeout&gt;
 
:*&lt;history_data&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;post_process&gt;
 
:*&lt;network_component_group&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_network_component&id=example_network_component_name&other=7|network%20component%20created%20by%20Api|300|30|10|public|3||1|10|20|str|21|30|str1|10|50.00|12&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_plugin_component====
 
Crea un nuevo componente de plugin.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_plugin_component (obligatorio)
 
*id=&lt;plugin_component_name&gt; (obligatorio) debe ser el nombre del componente de tipo plugin.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del componente de tipo plugin, serializados en el siguiente orden:
 
:*&lt;plugin_component_type&gt;
 
:*&lt;description&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;max_value&gt;
 
:*&lt;min_value&gt;
 
:*&lt;module_port&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;id_plugin&gt;
 
:*&lt;max_timeout&gt;
 
:*&lt;history_data&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;post_process&gt;
 
:*&lt;plugin_component_group&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_plugin_component&id=example_plugin_component_name&other=2|plugin%20component%20created%20by%20Api|300|30|10|66|3|2|example_user|example_pass|-p%20max||1|10|20|str|21|30|str1|10|50.00|12&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_snmp_component====
 
Crea un nuevo componente de SNMP.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_snmp_component (obligatorio)
 
*id=&lt;snmp_component_name&gt; (obligatorio) debe ser el nombre del componente de tipo snmp.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del componente de tipo snmp, serializados en el siguiente orden:
 
:*&lt;snmp_component_type&gt;
 
:*&lt;description&gt;
 
:*&lt;module_interval&gt;
 
:*&lt;max_value&gt;
 
:*&lt;min_value&gt;
 
:*&lt;id_module_group&gt;
 
:*&lt;max_timeout&gt;
 
:*&lt;history_data&gt;
 
:*&lt;min_warning&gt;
 
:*&lt;max_warning&gt;
 
:*&lt;str_warning&gt;
 
:*&lt;min_critical&gt;
 
:*&lt;max_critical&gt;
 
:*&lt;str_critical&gt;
 
:*&lt;ff_threshold&gt;
 
:*&lt;post_process&gt;
 
:*&lt;snmp_version&gt;
 
:*&lt;snmp_oid&gt;
 
:*&lt;snmp_community&gt;
 
:*&lt;snmp3_auth_user&gt;
 
:*&lt;snmp3_auth_pass&gt;
 
:*&lt;module_port&gt;
 
:*&lt;snmp3_privacy_method&gt;
 
:*&lt;snmp3_privacy_pass&gt;
 
:*&lt;snmp3_auth_method&gt;
 
:*&lt;snmp3_security_level&gt;
 
:*&lt;snmp_component_group&gt;
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_snmp_component&id=example_snmp_component_name&other=16|SNMP%20component%20created%20by%20Api|300|30|10|3||1|10|20|str|21|30|str1|15|50.00|3|.1.3.6.1.2.1.2.2.1.8.2|public|example_auth_user|example_auth_pass|66|AES|example_priv_pass|MD5|authNoPriv|12&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_local_component====
 
Crea un nuevo componente local.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_local_component (obligatorio)
 
*id=&lt;local_component_name&gt; (obligatorio) debe ser el nombre del componente de tipo local.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del componente de tipo local, serializados en el siguiente orden:
 
:*&lt;description&gt;
 
:*&lt;id_os&gt;
 
:*&lt;local_component_group&gt;
 
:*&lt;configuration_data&gt; Este es el bloque de configuración de un módulo.
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
:*&lt;ff_threshold&gt; (solo versión 5.1)
 
:*&lt;each_ff&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_normal&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_warning&gt; (solo versión 5.1)
 
:*&lt;ff_threshold_critical&gt; (solo versión 5.1)
 
:*&lt;ff_timeout&gt; (solo versión 5.1)
 
:*&lt;ff_type&gt; (solo versión 734)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_local_component&id=example_local_component_name&other=local%20component%20created%20by%20Api~5~12~module_begin%0dmodule_name%20example_local_component_name%0dmodule_type%20generic_data%0dmodule_exec%20ps%20|%20grep%20pid%20|%20wc%20-l%0dmodule_interval%202%0dmodule_end&other_mode=url_encode_separator_~&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_alert_template====
 
Crea una plantilla de alerta.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=create_alert_template (obligatorio)
 
*id=&lt;template_name&gt; (obligatorio) el nombre de la plantilla.
 
*other=&lt;serialized parameters&gt; (obligatorio) las configuraciones y datos de la plantilla, serializados en el siguiente orden:
 
:*&lt;type [regex|max_min|max|min|equal|not_equal|warning|critical|onchange|unknown|always]&gt;
 
:*&lt;description&gt;
 
:*&lt;id_alert_action&gt;
 
:*&lt;field1&gt;
 
:*&lt;field2&gt;
 
:*&lt;field3&gt;
 
:*&lt;value&gt;
 
:*&lt;matches_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;min_value&gt;
 
:*&lt;time_threshold&gt;
 
:*&lt;max_alerts&gt;
 
:*&lt;min_alerts&gt;
 
:*&lt;time_from&gt;
 
:*&lt;time_to&gt;
 
:*&lt;monday&gt;
 
:*&lt;tuesday&gt;
 
:*&lt;wednesday&gt;
 
:*&lt;thursday&gt;
 
:*&lt;friday&gt;
 
:*&lt;saturday&gt;
 
:*&lt;sunday&gt;
 
:*&lt;recovery_notify&gt;
 
:*&lt;field2_recovery&gt;
 
:*&lt;field3_recovery&gt;
 
:*&lt;priority&gt;
 
:*&lt;id_group&gt;
 
 
=====Ejemplos=====
 
Ejemplo 1 (condition: regexp =~ /pp/, action: Mail to XXX, max_alert: 10, min_alert: 0, priority: WARNING, group: databases):
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_alert_template&id=example&other=regex|template%20based%20in%20regexp|1||||pp|1||||10|0|||||||||||||3&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
Ejemplo 2 (condition: value is not between 5 and 10, max_value: 10.00, min_value: 5.00, time_from: 00:00:00, time_to: 15:00:00, priority: CRITICAL, group: Servers):
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_alert_template&id=template_min_max&other=max_min|template%20based%20in%20range|NULL||||||10|5||||00:00:00|15:00:00|||||||||||4|2&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_alert_template====
 
Actualiza una plantilla de alerta.
 
 
Sintaxis de llamada:
 
 
*op=set (obligatorio)
 
*op2=update_alert_template (obligatorio)
 
*id=&lt;id_template&gt; (obligatorio) debe ser un id de template.
 
*other=&lt;serializar parámetros&gt; (oligatorio) son los datos de configuration del template, serializados en este orden:
 
:*&lt;template_name&gt;
 
:*&lt;type [regex|max_min|max|min|equal|not_equal|warning|critical|onchange|unknown|always]&gt;
 
:*&lt;description&gt;
 
:*&lt;id_alert_action&gt;
 
:*&lt;field1&gt;
 
:*&lt;field2&gt;
 
:*&lt;field3&gt;
 
:*&lt;value&gt;
 
:*&lt;matches_value&gt;
 
:*&lt;max_value&gt;
 
:*&lt;min_value&gt;
 
:*&lt;time_threshold&gt;
 
:*&lt;max_alerts&gt;
 
:*&lt;min_alerts&gt;
 
:*&lt;time_from&gt;
 
:*&lt;time_to&gt;
 
:*&lt;monday&gt;
 
:*&lt;tuesday&gt;
 
:*&lt;wednesday&gt;
 
:*&lt;thursday&gt;
 
:*&lt;friday&gt;
 
:*&lt;saturday&gt;
 
:*&lt;sunday&gt;
 
:*&lt;recovery_notify&gt;
 
:*&lt;field2_recovery&gt;
 
:*&lt;field3_recovery&gt;
 
:*&lt;priority&gt;
 
:*&lt;id_group&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_alert_template&id=38&other=example_template_with_changed_name|onchange|changing%20from%20min_max%20to%20onchange||||||1||||5|1|||1|1|0|1|1|0|0|1|field%20recovery%20example%201|field%20recovery%20example%202|1|8&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_alert_template====
 
Borra una plantilla de alerta y todas las alertas definidas por ella.
 
 
Sintaxis de llamada:
 
 
*op=set (oligatorio)
 
*op2=delete_alert_template (obligatorio)
 
*id=&lt;id_template&gt; (obligatorio) debe ser un id de template.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_alert_template&id=38&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_module_template====
 
Borra una plantilla de módulos.
 
 
Sintaxis de llamada:
 
 
*op=set (obligatorio)
 
*op2=delete_module_template (obligatorio)
 
*id=&lt;id_alert_template_module&gt; (obligatorio) debe ser un id de alert_template_module.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_module_template&id=38&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_module_template_by_names====
 
Borra una plantilla de módulos.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=new_alert_template (obligatorio)
 
*id=&lt;nombre del agente&gt; (obligatorio)
 
*id2=&lt;nombre de la plantilla de alerta&gt; (obligatorio)
 
*other=&lt;parametros serializados&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;nombre modulo&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_module_template_by_names&id=sample-agent&id2=test&other=memfree&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set stop_downtime====
 
Para una parada planificada.
 
 
Sintaxis de llamada:
 
 
*op=set (obligatorio)
 
*op2=stop_downtime (obligatorio)
 
*id=&lt;id_downtime&gt; (obligatorio) debe ser un id downtime.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=stop_downtime&id=1&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====Set new_user====
 
Crea un nuevo usuario en Pandora FMS.
 
 
Sintaxis de llamada:
 
*op=set (obligatorio)
 
*op2=new_user (obligatorio)
 
*id=&lt;user_name&gt; (obligatorio) será el nombre de usuario.
 
*other=&lt;parametros serializados&gt; (obligatorio) son los datos del usuario, serializados en el siguiente orden:
 
:*&lt;fullname&gt;
 
:*&lt;firstname&gt;
 
:*&lt;lastname&gt;
 
:*&lt;middlename&gt;
 
:*&lt;password&gt;
 
:*&lt;email&gt;
 
:*&lt;phone&gt;
 
:*&lt;languages&gt;
 
:*&lt;comments&gt;
 
:*&lt;time_autorefresh&gt;
 
:*&lt;default_event_filter&gt;
 
:*&lt;section&gt;
 
:*&lt;session_time&gt; (-1 para establecer la sesión como permanente)
 
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_user&id=md&other=fullname|lastname|middlename|password|[email protected]|111|es|descripcion|30|event_filter|section|-1&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====Set update_user====
 
Actualiza un usuario seleccionado por el id en parámetro id.
 
 
Sintaxis de llamada:
 
*op=set (obligatorio)
 
*op2=update_user (obligatorio)
 
*id=&lt;user_name&gt; (oligatorio) debe ser un nombre de usuario.
 
*other=&lt;parametros serializados&gt; (obligatorio) son los datos de configuración del usuario, serializados en este orden:
 
:*&lt;fullname&gt;
 
:*&lt;firstname&gt;
 
:*&lt;lastname&gt;
 
:*&lt;middlename&gt;
 
:*&lt;password&gt;
 
:*&lt;email&gt;
 
:*&lt;phone&gt;
 
:*&lt;languages&gt;
 
:*&lt;comments&gt;
 
:*&lt;is_admin&gt;
 
:*&lt;block_size&gt;
 
:*&lt;flash_chart&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_user&id=example_user_name&other=example_fullname||example_lastname||example_new_passwd|example_email||example_language|example%20comment|1|30|&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_user====
 
Borra un usuario seleccionado.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_user (obligatorio)
 
*id=&lt;nombre_usuario&gt; (obligatorio) debe ser un nombre usuario.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_user&id=md&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====Set delete_user_permissions====
 
<br>
 
{{metaconsola}}
 
Borra premisos de usuario.
 
 
Call syntax:
 
 
*Op = set(obligatorio)
 
*Op2 =delete_user_permission(obligatorio)
 
*Return_type = csv|json(obligatorio)
 
*Other = id profile(obligatorio)
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_user_permission&return_type=json&other=2&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
 
Borra los permisos de un usuario
 
Puede retornar Json o CSV, este retorno se indica mediante la URL.
 
 
====Set add_permission_user_group====
 
<br>
 
{{metaconsola}}
 
 
Añadir permisos a un grupo de usuario.
 
 
Call syntax:
 
* Op = set(obligatorio)
 
* Op2 =add_permission_user_to_group(obligatorio)
 
* Return_type = csv|json(obligatorio)
 
* Other = user id(obligatorio)|group_id(obligatorio)|profile id(obligatorio)|No hierarchy(opcional)| permissions id(opcional)
 
 
=====Ejemplo=====
 
Puede retornar Json o CSV, este retorno se indica mediante la URL.
 
{{Warning|no_hierarchy puede estar vacío, si es así toma el valor 0.}}
 
 
{{Warning|id de permissions (id_up) en la tabla, se puede usar si va a modificarse un permiso existente.}}
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=add_permission_user_to_group&return_type=json&other=admin|0|1|1||&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set enable_disable_user====
 
Activa un usuario desactivado.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=enable_disable_user (obligatorio)
 
*id=&lt;nombre_usuario&gt; (obligatorio) debe ser un nombre usuario.
 
 
=====Ejemplos=====
 
Ejemplo 1 (Disable user 'example_name')
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=enable_disable_user&id=example_name&other=0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
Ejemplo 2 (Enable user 'example_name')
 
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=enable_disable_user&id=example_name&other=1&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set meta_synch_user====
 
{{metaconsola}}
 
Sincroniza usuarios de la metaconsola con el nodo
 
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=meta_synch_user (obligatorio)
 
*other=&lt;parámetros serializados&gt; (opcional):
 
:*&lt;user_name_1,user_name_2,user_name_3..&gt; (Nombres de los usuarios separados por comas y sin espacios al inicio o al final, obligatorio)
 
:*&lt;server_name&gt; (obligatorio)
 
:*&lt;profile_mode(1-0)&gt; (opcional)
 
:*&lt;group_name&gt; (opcional)
 
:*&lt;profile_1,profile_2,profile_3&gt; (Perfiles separados por comas y sin espacios al principio y al final, opcional)
 
:*&lt;create_groups(1-0)&gt; (opcional)
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=meta_synch_user&apipass=1234&user=admin&pass=pandora&other=name1,name2|nodo1|0|||&other_mode=url_encode_separator_|</nowiki>
 
 
====set create_group====
 
Crea un nuevo grupo.
 
 
Call syntax:
 
 
*op=set (obligatorio)
 
*op2=create_group (obligatorio)
 
*id=&lt;group_name&gt; (obligatorio) debe ser un nombre de grupo.
 
*other=&lt;serialized_parameters&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;icon name&gt;
 
:*&lt;parent group id&gt; (opcional)
 
:*&lt;description&gt; (opcional)
 
:*&lt;propagate acl&gt; (opcional)
 
:*&lt;desactivar las alertas&gt; (opcional)
 
:*&lt;custom id&gt; (opcional)
 
:*&lt;Informacion de contacto&gt; (opcional)
 
:*&lt;otra informacion&gt; (opcional)
 
 
=====Ejemplos=====
 
Ejemplo 1 (con grupo padre: Servers)
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_group&id=example_group_name&other=applications|2&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
Ejemplo 2 (sin grupo padre)
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_group&id=example_group_name2&other=computer|&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_group====
 
Actualiza el grupo con los datos pasados como parámetros.
 
 
Call syntax:
 
 
*op=set (obligatorio)
 
*op2=update_group (obligatorio)
 
*id=&lt;group_id&gt; (obligatorio) id_grupo.
 
*other=&lt;serialized_parameters&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;group name&gt;
 
:*&lt;icon name&gt;
 
:*&lt;parent group id&gt;
 
:*&lt;description&gt;
 
:*&lt;propagate acl&gt;
 
:*&lt;desactivar las alertas&gt;
 
:*&lt;custom id&gt;
 
:*&lt;Informacion de contacto&gt;
 
:*&lt;otra informacion&gt;
 
 
=====Ejemplos=====
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_group&id=example_group_id&other=New%20Name|application|2|new%20description|1|0|custom%20id||&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_group====
 
Eliminar un grupo
 
 
Call syntax:
 
*op=set (obligatorio)
 
*op2=update_group (obligatorio)
 
*id=&lt;group_id&gt; (obligatorio) id_grupo.
 
 
=====Ejemplos=====
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_group&id=303&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_user_profile====
 
Añade un perfil a un usuario.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_user_profile (obligatorio)
 
*id=&lt;nombre_usuario&gt; (obligatorio) debe ser un nombre usuario.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del grupo y profile, serializados en el siguiente orden:
 
:*&lt;grupo&gt;
 
:*&lt;profile&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_user_profile&id=md&other=12|4&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_user_profile====
 
Quita un perfil a un usuario.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_user_profile (obligatorio)
 
*id=&lt;nombre_usuario&gt; (obligatorio) debe ser un nombre usuario.
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del grupo y profile, serializados en el siguiente orden:
 
:*&lt;grupo&gt;
 
:*&lt;profile&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_user_profile&id=md&other=12|4&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_incident====
 
Crea un nuevo incidente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_incident (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del incidente, serializados en el siguiente orden:
 
:*&lt;titulo&gt;
 
:*&lt;descripción&gt;
 
:*&lt;origen&gt;
 
:*&lt;prioridad&gt;
 
:*&lt;estado&gt;
 
:*&lt;grupo&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_incident&other=titulo|descripcion%20texto|Logfiles|2|10|12&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_note_incident====
 
Crea una nota dentro de una incidencia.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_note_incident (obligatorio)
 
*id=&lt;id_incidente&gt; (obligatorio) el id del incidente.
 
*id2=&lt;nombre_usuario&gt; (obligatorio) el nombre del usuario.
 
*other=&lt;nota&gt; (obligatorio) es la nota codificada en url encode.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_note_incident&id=5&id2=miguel&other=una%20nota%20para%20la%20incidencia&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set validate_all_alerts====
 
Valida todas las alertas.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=validate_all_alerts (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=validate_all_alerts&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set validate_all_policy_alerts====
 
Valida todas las alertas que vienen de políticas.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=validate_all_policy_alerts (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=validate_all_policy_alerts&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set event_validate_filter====
 
Valida todos los eventos que pasan el filtro pasado como parámetros.
 
 
 
{{metaconsola}}
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=event_validate_filter (obligatorio)
 
*other_mode=url_encode_separator_| (opcional)
 
*other=&lt;parámetros serializados&gt; (opcional), son los siguientes en este orden:
 
:*&lt;separator&gt;
 
:*&lt;criticity&gt; De 0 a 4
 
:*&lt;nombre agente&gt;
 
:*&lt;nombre módulo&gt;
 
:*&lt;nombre plantilla de alerta&gt;
 
:*&lt;usuario&gt;
 
:*&lt;nivel mínimo intervalo numérico &gt; en unix timestamp
 
:*&lt;nivel máximo intervalo numérico &gt; en unix timestamp
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=event_validate_filter&other_mode=url_encode_separator_|&other=;|2&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set event_validate_filter_pro====
 
Es igual que la anterior.
 
 
 
{{metaconsola}}
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=event_validate_filter_pro (obligatorio)
 
*other_mode=url_encode_separator_| (opcional)
 
*other=&lt;parámetros serializados&gt; (opcional), son los siguientes en este orden:
 
:*&lt;separator&gt;
 
:*&lt;criticity&gt; De 0 a 4
 
:*&lt;id agente&gt;
 
:*&lt;id modulo&gt;
 
:*&lt;id agente modulo alerta&gt;
 
:*&lt;usuario&gt;
 
:*&lt;nivel mínimo intervalo numérico &gt; en unix timestamp
 
:*&lt;nivel máximo intervalo numérico &gt; en unix timestamp
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=event_validate_filter_pro&other_mode=url_encode_separator_|&other=;|2&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_alert_template====
 
Aplica una alerta desde una plantilla y un módulo pasado como id de agente y nombre de módulo.
 
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_alert_template (obligatorio)
 
*id=&lt;nombre del agente&gt; (obligatorio)
 
*id2=&lt;nombre de la plantilla de alerta&gt; (obligatorio)
 
*other_mode=url_encode_separator_| (opcional)
 
*other=&lt;parámetros serializados&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;nombre modulo&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_alert_template&id=example&id2=test&other_mode=url_encode_separator_|&other=memfree&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set alert_actions====
 
Añade acciones a una alerta.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=alert_actions (obligatorio)
 
*id=&lt;nombre del agente&gt; (obligatorio)
 
*id2=&lt;nombre de la plantilla de alerta&gt; (obligatorio)
 
*other_mode=url_encode_separator_| (opcional)
 
*other=&lt;parámetros serializados&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;nombre modulo&gt; (obligatorio)
 
:*&lt;nombre acción&gt; (obligatorio)
 
:*&lt;fires min &gt; (opcional)
 
:*&lt;fires max &gt; (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=alert_actions&id=example&id2=test&other_mode=url_encode_separator_|&other=memfree|test&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=alert_actions&id=example&id2=test&other_mode=url_encode_separator_|&other=memfree|test|1|3&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set alert_commands====
 
Añade comandos a una alerta.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=alert_commands (obligatorio)
 
*id=&lt;nombre del comando&gt; (obligatorio)
 
*other_mode=url_encode_separator_| (opcional)
 
*other=&lt;parámetros serializados&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;command&gt; (obligatorio)
 
:*&lt;id_group&gt; (obligatorio)
 
:*&lt;description &gt; (opcional)
 
:*&lt;internal &gt; (opcional)
 
:*&lt;field_description_1&gt;&lt;field_value_1&gt;&lt;field_description_2&gt;&lt;field_value_2&gt;...&lt;field_description_n&gt;&lt;field_value_n&gt;
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=alert_commands&id=PRUEBA1&other=command|0|Desc|1|des1|val1|des2|val2|des3|val3||val4|des5&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_module====
 
Crea un nuevo módulo.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_module (obligatorio)
 
*id=&lt;nombre del agente&gt; (obligatorio)
 
*id2=&lt;nombre del nuevo modulo&gt; (obligatorio)
 
*other_mode=url_encode_separator_| (opcional)
 
*other=&lt;parámetros serializados&gt; (obligatorio), son los siguientes en este orden:
 
:*&lt;tipo de modulo de red&gt; (obligatorio)
 
:*&lt;nombre acción&gt; (obligatorio)
 
:*&lt;ip o url &gt; (obligatorio)
 
:*&lt;puerto &gt; (opcional)
 
:*&lt;descripción &gt; (opcional)
 
:*&lt;min &gt; (opcional)
 
:*&lt;max &gt; (opcional)
 
:*&lt;post process &gt; (opcional)
 
:*&lt;module interval &gt; (opcional)
 
:*&lt;min warning &gt; (opcional)
 
:*&lt;max warning &gt; (opcional)
 
:*&lt;min critical &gt; (opcional)
 
:*&lt;max critical &gt; (opcional)
 
:*&lt;history data &gt; (opcional)
 
:*&lt;enable_unknown_events&gt; (solo versión 5)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_module&id=miguel-portatil&id2=juanito&other_mode=url_encode_separator_|&other=remote_tcp_string|localhost|33|descripcion%20larga&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_module====
 
Borra un módulo.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_module (obligatorio)
 
*id=&lt;nombre del agente&gt; (obligatorio)
 
*id2=&lt;nombre del modulo&gt; (obligatorio)
 
*other=simulate (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_module&id=example&id2=example2&other=simulate&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_module&id=example&id2=example2&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set enable_alert====
 
Activa una alerta dentro de un agente.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=enable_alert
 
*id=&lt;Nombre del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
*other: nombre del template de la alerta (p.e: Warning event) (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=enable_alert&id=example&id2=Status&other=Warning%20condition&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set enable_alert_alias====
 
Activa una alerta dentro de un agente a partir del alias.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=enable_alert_alias
 
*id=&lt;Alias del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
*other: nombre del template de la alerta (p.e: Warning event) (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=enable_alert_alias&id=example&id2=CPU%20Load&other=critical%20condition&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set disable_alert====
 
Desactiva una alerta dentro de un agente.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=disable_alert
 
*id=&lt;Nombre del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
*other: nombre del template de la alerta (p.e: Warning event) (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=disable_alert&id=example&id2=Status&other=Warning%20condition&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set disable_alert_alias====
 
Desactiva una alerta dentro de un agente.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=disable_alert_alias
 
*id=&lt;Alias del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
*other: nombre del template de la alerta (p.e: Warning event) (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=disable_alert_alias&id=example&id2=CPU%20Load&other=critical%20condition&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set enable_module_alerts====
 
Igual que la llamada enable_alert.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=enable_module_alerts
 
*id=&lt;Nombre del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=enable_module_alerts&id=example&id2=Status&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set disable_module_alerts====
 
Igual que la llamada disable_alert.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=disable_module_alerts
 
*id=&lt;Nombre del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=disable_module_alerts&id=example&id2=Status&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set enable_module====
 
Activa el módulo.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=enable_module
 
*id=&lt;Nombre del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=enable_module&id=example&id2=Status&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set disable_module====
 
Desactiva el módulo.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=disable_module
 
*id=&lt;Nombre del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del modulo&gt; (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=disable_module&id=example&id2=Status&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_network_module_from_component====
 
Crea un nuevo módulo de red desde un componente.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=create_network_module_from_component (obligatorio)
 
*id=&lt;Nombre del agente&gt; (obligatorio)
 
*id2=&lt;Nombre del componente&gt; (obligatorio)
 
 
 
===== Ejemplo =====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_network_module_from_component&id=example&id2=OS%20Total%20process&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set module_data====
 
Añade un nuevo valor al módulo.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=module_data (obligatorio)
 
*id=&lt;id agente módulo&gt; (obligatorio)
 
*other: serializado el dato del módulo y el tiempo en que ocurre.
 
**dato: que puede ser cualquier tipo de dato de Pandora.
 
**tiempo: puede ser la cadena de texto "now" para el momento actual o el timestamp especifico.
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=module_data&id=14&other_mode=url_encode_separator_|&other=123|now&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set new_module_group====
 
Crea un nuevo grupo de módulos.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=new_module_group (obligatorio)
 
*id=&lt;nombre del grupo de módulos&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=new_module_group&id=Module_group_name&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set module_group_synch====
 
{{metaconsola}}
 
Sincronizar grupo de módulos desde la metaconsola.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=module_group_synch (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) en este caso el nombre del/de los servidor/es que se quiere/n sincronizar con la meta.
 
:*&lt;server_name_1&gt;&lt;server_name_2&gt;...&lt;server_name_n&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=module_group_synch&other=server_name1|server_name2|server_name3&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_module_in_conf====
 
>= 5.0 (Sólo Enterprise)
 
 
Añade una configuración a un módulo local.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_module_in_conf (obligatorio)
 
*id=&lt;id agente&gt; (obligatorio)
 
*id2=&lt;nombre módulo&gt; (obligatorio)
 
*other: los datos del modulo que irán en el fichero de configuración codificados en base64 (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_module_in_conf&apipass=1234&user=admin&pass=pandora&id=9043&id2=example_name&other=bW9kdWxlX2JlZ2luCm1vZHVsZV9uYW1lIGV4YW1wbGVfbmFtZQptb2R1bGVfdHlwZSBnZW5lcmljX2RhdGEKbW9kdWxlX2V4ZWMgZWNobyAxOwptb2R1bGVfZW5k</nowiki>
 
 
Se retornará '0' en caso de éxito,'-1' en caso de error, '-2' si ya existe
 
 
====set delete_module_in_conf====
 
>= 5.0 (Sólo Enterprise)
 
 
Borra la configuración de un módulo local.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=add_module_in_conf (obligatorio)
 
*id=&lt;id agente&gt; (obligatorio)
 
*id2=&lt;nombre módulo&gt; (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_module_in_conf&user=admin&pass=pandora&id=9043&id2=example_name</nowiki>
 
 
Se retornará '0' en caso de éxito ó '-1' en caso de error
 
 
====set update_module_in_conf====
 
>= 5.0 (Sólo Enterprise)
 
 
Actualiza la configuración de un módulo local.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_module_in_conf (obligatorio)
 
*id=&lt;id agente&gt; (obligatorio)
 
*id2=&lt;nombre módulo&gt; (obligatorio)
 
*other: los nuevos datos del módulo que irán en el fichero de configuración codificados en base64 (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_module_in_conf&apipass=1234&user=admin&pass=pandora&id=9043&id2=example_name&other=bW9kdWxlX2JlZ2luCm1vZHVsZV9uYW1lIGV4YW1wbGVfbmFtZQptb2R1bGVfdHlwZSBnZW5lcmljX2RhdGEKbW9kdWxlX2V4ZWMgZWNobyAxOwptb2R1bGVfZW5k</nowiki>
 
 
Se retornará '1' si no cambia, '0' en caso de éxito, '-1' en caso de error, '-2' si no existe
 
 
====set create_event====
 
Crea un evento nuevo en Pandora.
 
 
 
{{metaconsola}}
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_event (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) son la configuración y datos del evento, serializados en el siguiente orden:
 
:*&lt;event_text&gt; (obligatorio)(string)
 
:*&lt;id_group&gt; (obligatorio)(string)
 
:*&lt;id_agent&gt; (obligatorio)(numeric)
 
:*&lt;status&gt;(0 New, 1 Validated, 2 In process)
 
:*&lt;id_user&gt;(numeric)
 
:*&lt;event_type&gt;(unknown, alert_fired, alert_recovered, alert_ceased, alert_manual_validation, system, error, new_agent, configuration_change, going_unknown, going_down_critical, going_down_warning, going_up_normal)
 
:*&lt;severity&gt; (0 Maintenance,1 Informative,2 Normal,3 Warning,4 Crit,5 Minor, 6 Major)
 
:*&lt;id_agent_module&gt;(numeric)
 
:*&lt;id_alert_am&gt;(numeric)
 
:*&lt;critical_instructions&gt;(string)
 
:*&lt;warning_instructions&gt;(string)
 
:*&lt;unknown_instructions&gt;(string)
 
:*&lt;comment&gt;(string)
 
:*&lt;owner_user&gt;(string)
 
:*&lt;source&gt;(string)
 
:*&lt;tags&gt;(string)
 
:*&lt;custom_data&gt; Los datos personalizados se introducen como un documento JSON codificado en base 64.
 
:*&lt;server_id&gt; El nodo de la consola hija (solo para metaconsola).
 
:*&lt;id_extra&gt; (alphanumeric)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_event&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora&other=Event_name|0|1|0|admin|alert_fired|4|1|||||comment|admin||tags|eyJBbnN3ZXIgdG8gdGhlIFVsdGltYXRlIFF1ZXN0aW9uIG9mIExpZmUsIHRoZSBVbml2ZXJzZSwgYW5kIEV2ZXJ5dGhpbmciOiA0Mn0=||12</nowiki>
 
 
====set add_event_comment====
 
Añade un comentario acerca del evento
 
 
{{Tip|Esta característica se encuentra tanto en nodo como en Metaconsola}}
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=add_event_comment (obligatorio)
 
*other=&lt;serialized_parameters&gt; (obligatorio) son la configuración y datos del evento, serializados en el siguiente orden:
 
:*&lt;comment&gt; (obligatorio)
 
 
{{Tip|Para poder utilizarla en Metaconsola, se debe introducir el parámetro true despues del string}}
 
 
=====Ejemplos=====
 
* Nodo:
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_event_comment&id=event_id&other=string&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
* Metaconsola:
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_event_comment&id=event_id&other=string|true&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_netflow_filter====
 
(>=5.0)
 
 
Crea un nuevo filtro de netflow.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_netflow_filter (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) son los datos del filtro, serializados en el siguiente orden:
 
:*&lt;nombre_filtro&gt; (obligatorio)
 
:*&lt;id_grupo&gt; (obligatorio)
 
:*&lt;filtro&gt; (obligatorio)
 
:*&lt;agregado_por&gt; (Valores posibles: dstip,dstport,none,proto,srcip,srcport)  (obligatorio)
 
:*&lt;formato_salida&gt; (Valores posibles: kilobytes,kilobytespersecond,megabytes,megabytespersecond) (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora/include/api.php?op=set&op2=create_netflow_filter&apipass=1234&user=admin&pass=pandora&other=Filter%20name|9|host%20192.168.50.3%20OR%20host%20192.168.50.4%20or%20HOST%20192.168.50.6|dstport|kilobytes&other_mode=url_encode_separator_|</nowiki>
 
 
====set create_custom_field====
 
>= 5.0
 
 
Crea un nuevo campo custom.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_custom_field (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) parámetros para configurar el custom field
 
:*&lt;name&gt; (obligatorio)
 
:*&lt;flag_display_front&gt; (obligatorio; 0 no se mostrará en la vista de operación, 1 si se mostrará)
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_custom_field&other=mycustomfield|0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_tag====
 
>= 5.0
 
 
Crea un nuevo tag.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_tag (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio) parámetros para configurar el tag
 
:*&lt;name&gt; Nombre del tag (obligatorio)
 
:*&lt;description&gt; Descripción del tag
 
:*&lt;eurl&gt; Url del tag
 
:*&lt;email&gt; Email del tag
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_tag&other=tag_name|tag_description|tag_url|tag_email&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set enable_disable_agent====
 
Activa un agente desactivado.
 
 
Sintaxis de la llamada:
 
 
*op=set (obligatorio)
 
*op2=enable_disable_agent (obligatorio)
 
*id=&lt;id_agente&gt; (obligatorio) debe ser un id agente.
 
 
=====Ejemplos=====
 
Example 1 (Disable agent 'example_id')
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=enable_disable_agent&id=example_id&other=0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
Example 2 (Enable agent 'example_id')
 
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=enable_disable_agent&id=example_id&other=1&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set gis_agent_only_position====
 
>= 5.0
 
 
Añade solo la posición GIS a un agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=gis_agent_only_position (obligatorio)
 
*id=<índice> (obligatorio) debe ser un índice de un agente.
 
*other=&lt;parámetros serializados&gt; (obligatorio) parámetros para configurar el Gis
 
:*&lt;latitude&gt; Latitud
 
:*&lt;longitude&gt; Longitud
 
:*&lt;altitude&gt; Altitud
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1234&user=admin&pass=pandora&op=set&op2=gis_agent_only_position&id=582&other_mode=url_encode_separator_|&other=2%7C1%7C0</nowiki>
 
 
====set gis_agent====
 
>= 5.0
 
 
Añade los datos GIS a un agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=gis_agent_only_position (obligatorio)
 
*id=<índice> (obligatorio) debe ser un índice de un agente.
 
*other=&lt;parámetros serializados&gt; (obligatorio) parámetros para configurar el gis
 
:*&lt;latitude&gt; Latitud
 
:*&lt;longitude&gt; Longitud
 
:*&lt;altitude&gt; Altitud
 
:*&lt;ignore_new_gis_data&gt; ignorar nuevos datos gis
 
:*&lt;manual_placement&gt; posicionamiento manual
 
:*&lt;start_timestamp&gt; tiempo de comienzo en esta posicion
 
:*&lt;end_timestamp&gt; tiempo de finalización de la anterior
 
:*&lt;number_of_packages&gt; numero de paquetes en esta posición
 
:*&lt;description_save_history&gt; descripción
 
:*&lt;description_update_gis&gt; descripción
 
:*&lt;description_first_insert&gt; descripción
 
 
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora5/include/api.php?apipass=1234&user=admin&pass=pandora&op=set&op2=gis_agent&id=582&other_mode=url_encode_separator_|&other=2%7C2%7C0%7C0%7C0%7C2000-01-01+01%3A01%3A01%7C0%7C666%7Caaa%7Cbbb%7Cccc</nowiki>
 
 
====set reset_agent_counts====
 
Actualiza el conteo de módulos y alertas de un agente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=reset_agent_counts (obligatorio)
 
*id=<id_agent> (obligatorio) debe ser un id de agente o "All".
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=reset_agent_counts&apipass=1234&user=admin&pass=pandora&id=All</nowiki>
 
 
====set create_special_day====
 
>= 5.1
 
 
Permite añadir un día especial.
 
 
Sintaxis:
 
 
*op=set (obligatorio)
 
*op2=create_special_day (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio)
 
:*&lt;special day&gt; Día especial
 
:*&lt;same day&gt; Mismo día
 
:*&lt;description&gt; Descripción
 
:*&lt;id_group&gt; Id Grupo
 
 
=====Example=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1111&user=admin&pass=pandora&op=set&op2=create_special_day&other_mode=url_encode_separator_|&other=2014-05-03|Sunday|desc|0</nowiki>
 
 
====set update_special_day====
 
>= 5.1
 
 
Actualizar configuración de un día especial ya definido.
 
 
Sintaxis:
 
 
*op=set (obligatorio)
 
*op2=update_special_day (obligatorio)
 
*id=&lt;id día especial&gt; (obligatorio)
 
*other=&lt;parámetros serializados&gt; (obligatorio)
 
:*&lt;special day&gt; Día especial
 
:*&lt;same day&gt; Mismo día
 
:*&lt;description&gt; Descripción
 
:*&lt;id_group&gt; Id grupo
 
 
=====Example=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1111&user=admin&pass=pandora&op=set&op2=update_special_day&id=1&other_mode=url_encode_separator_|&other=2014-05-03|Sunday|desc|0</nowiki>
 
 
====set delete_special_day====
 
>= 5.1
 
 
Permite borrar un día especial.
 
 
Sintaxis:
 
 
*op=set (obligatorio)
 
*op2=delete_special_day (obligatorio)
 
*id=&lt;id día especial&gt; (obligatorio)
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?apipass=1111&user=admin&pass=pandora&op=set&op2=delete_special_day&id=1</nowiki>
 
 
====set pagerduty_webhook====
 
>= 5.1
 
 
Conecta notificaciones de PagerDuty con alertas de Pandora FMS. Esta llamada se configurará en la opción Webhook del servicio de PagerDuty para validar las alertas de Pandora FMS previamente enlazadas a PagerDuty cuando estas sean validadas desde PagerDuty.
 
 
Sintaxis:
 
 
*op=set (obligatorio)
 
*op2=pagerduty_webhook (obligatorio)
 
*id=alert (obligatorio)
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=pagerduty_webhook&apipass=1234&user=admin&pass=pandora&id=alert</nowiki>
 
 
====set tag_user_profile====
 
>= 6
 
 
Añade un tag a un perfil de un usuario.
 
 
Sintaxis:
 
 
* op = set (obligatorio)
 
* op2 = tag_user_profile (obligatorio)
 
* id = id_usuario (obligatorio)
 
* id2 = id_etiqueta (obligatorio)
 
* other_mode = url_encode_separator_| (obligatorio)
 
* other = <id_grupo>|<id_perfil> (obligatorio)
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=tag_user_profile&apipass=1234&user=admin&pass=pandora&id=1&id2=2&other_mode=url_encode_separator_|&other=122|3</nowiki>
 
 
====set tag====
 
>= 6
 
 
Añade un tag a tu Pandora FMS.
 
 
Sintaxis:
 
 
* op = set (obligatorio)
 
* op2 = tag (obligatorio)
 
* id = nombre (obligatorio)
 
* other_mode = url_encode_separator_| (obligatorio)
 
* other = <descripción>|<url>|<email>|<teléfono>
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=tag&apipass=1234&user=admin&pass=pandora&id=test&other_mode=url_encode_separator_|&other="un test"|http://www.artica.es|[email protected]|01189998819991197253</nowiki>
 
 
====set add_tag_module====
 
>= 6
 
 
Añade un tag a un módulo.
 
 
Sintaxis:
 
 
* op = set (obligatorio)
 
* op2 = add_tag_module (obligatorio)
 
* id = id_modulo (obligatorio)
 
* id2 = id_tag (obligatorio)
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_tag_module&apipass=1234&user=admin&pass=pandora&id=1&id2=2</nowiki>
 
 
====set remove_tag_module====
 
>= 6
 
 
Quita un tag a un módulo.
 
 
Sintaxis:
 
 
* op = set (obligatorio)
 
* op2 = add_tag_module (obligatorio)
 
* id = id_modulo (obligatorio)
 
* id2 = id_tag (obligatorio)
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=remove_tag_module&apipass=1234&user=admin&pass=pandora&id=1&id2=2</nowiki>
 
 
====set planned_downtimes_created====
 
>= 5.1
 
 
Crea una parada planificada.
 
 
*op=set
 
*op2=planned_downtimes_created
 
*other=<description>;<date_from>;<date_to>;<id_group>;<monday>;
 
*  <tuesday>;<wednesday>;<thursday>;<friday>;<saturday>;<sunday>;<periodically_time_from>;<periodically_time_to>;
 
*  <periodically_day_from>;<periodically_day_to>;<type_downtime>;<type_execution>;<type_periodicity>;<id_user>;
 
 
=====Ejemplos=====
 
Once:
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=planned_downtimes_created&apipass=1234&user=admin&pass=pandora&id=testing&other=testing|11/05/2018|11/16/2018|0|1|1|1|1|1|1|1|12:06:00|19:06:00|1|31|quiet|once|weekly|admin&other_mode=url_encode_separator_|</nowiki>
 
 
Periodically:
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=planned_downtimes_created&apipass=1234&user=admin&pass=pandora&id=testing&other=testing|11/05/2018|11/16/2018|0|1|1|1|1|1|1|1|12:06:00|19:06:00|1|31|quiet|periodically|weekly|admin&other_mode=url_encode_separator_|</nowiki>
 
 
====set planned_downtimes_additem====
 
>= 5.1
 
 
Crea registros para una parada planificada.
 
*op=set
 
*op2=planned_downtimes_additem
 
*id=planned_downtime_id
 
*other= <id_agent1;id_agent2;id_agent3;....id_agentn;>;<name_module1;name_module2;name_module3;......name_modulen;>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=planned_downtimes_additem&apipass=1234&user=admin&pass=pandora&id=123&other=1;2;3;4%7CStatus;Unkown_modules%20&other_mode=url_encode_separator_|</nowiki>
 
 
====set planned_downtimes_deleted====
 
>=5.1
 
 
Elimina una parada planificada.
 
*op=set
 
*op2=planned_downtimes_deleted
 
*id=planned_downtime_id
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=planned_downtimes_deleted&apipass=1234&user=admin&pass=pandora&id=10</nowiki>
 
 
====set create_synthetic_module====
 
>=5.1SP4
 
 
Crea un módulo sintético:
 
*op=set
 
*op2=create_synthetic_module
 
*id=Nombre del agente a añadir el módulo
 
*other= <name_module><synthetic_type><AgentName;Operation;NameModule> OR <AgentName;NameModule> OR <Operation;Value>
 
 
**Datos del módulo:
 
  En las creación de tipo arithmetic el primer dato si es Agente y módulo sin operador : AgentName;NameModule. Si es un valor: <Operation;Value>. El resto de valores irían ya de la forma siguiente: <AgentName;Operation;NameModule> or <Operation;Value>
 
  average: <AgentName;Operation;NameModule> or <Operation;Value>
 
 
**Operaciones:
 
  arithmetic: ADD, SUB, MUL, DIV
 
  average: Only AVG
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_synthetic_module&apipass=1234&user=admin&pass=pandora&id=test&other=Test|arithmetic|Agent%20Name;Module%20Name|Agent%20Name2;ADD;Module%20Name2&other_mode=url_encode_separator_|</nowiki>
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_synthetic_module&apipass=1234&user=admin&pass=pandora&id=example&other=prueba|average|Agent%20Name;AVG;Name%20Module|Agent%20Name2;AVG;Name%20Module2&other_mode=url_encode_separator_|</nowiki>
 
 
====set create_service====
 
>= 7
 
 
Crea un servicio.
 
 
*op=set
 
*op2=create_service
 
*other=<name>;<description>;<id_group>;<critical>;<warning>;<id_agent>;<sla_interval>;<sla_limit>;
 
<id_warning_module_template_alert>;<id_critical_module_template_alert>;<id_critical_module_sla_template_alert>;
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_service&return_type=json&other=test1%7CDescripcion%7C12%7C1%7C0.5%7C1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_service====
 
>= 7
 
 
Modifica un servicio.
 
 
*op=set
 
*op2=update_service
 
*id=id del servicio
 
*other=<name>;<description>;<id_group>;<critical>;<warning>;<id_agent>;<sla_interval>;<sla_limit>;
 
<id_warning_module_template_alert>;<id_critical_module_template_alert>;<id_critical_module_sla_template_alert>;
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_service&return_type=json&id=1&other=test2%7CDescripcion2%7C%7C%7C0.6%7C&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_element_service====
 
>= 7
 
 
Añade uno o varios elementos al servicio.
 
 
*op=set
 
*op2=add_element_service
 
*id=id del servicio
 
*other=json con los elementos en base64
 
 
La estructura del json debe ser la siguiente:
 
 
[{"type":"agent","id":2,"description":"Test1","weight_critical":0,"weight_warning":0,"weight_unknown":0,"weight_ok":0},{"type":"module","id":1,"description":"Test2","weight_critical":0,"weight_warning":0,"weight_unknown":0,"weight_ok":0},{"type":"service","id":3,"description":"Test3","weight_critical":0,"weight_warning":0,"weight_unknown":0,"weight_ok":0}]
 
 
En cada tipo, el campo id hace referencia a cosas diferentes:
 
 
- Si es de tipo agent, es el id del agente.
 
 
- Si es de tipo module, es el id agente modulo
 
 
- Si es tipo service, es el id del servicio que queremos añadir.
 
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_element_service&return_type=json&id=6&other=W3sidHlwZSI6ImFnZW50IiwiaWQiOjIsImRlc2NyaXB0aW9uIjoiamlqaWppIiwid2VpZ2h0X2NyaXRpY2FsIjowLCJ3ZWlnaHRfd2FybmluZyI6MCwid2VpZ2h0X3Vua25vd24iOjAsIndlaWdodF9vayI6MH0seyJ0eXBlIjoibW9kdWxlIiwiaWQiOjEsImRlc2NyaXB0aW9uIjoiSG9sYSBxdWUgdGFsIiwid2VpZ2h0X2NyaXRpY2FsIjowLCJ3ZWlnaHRfd2FybmluZyI6MCwid2VpZ2h0X3Vua25vd24iOjAsIndlaWdodF9vayI6MH0seyJ0eXBlIjoic2VydmljZSIsImlkIjozLCJkZXNjcmlwdGlvbiI6ImplamVqZWplIiwid2VpZ2h0X2NyaXRpY2FsIjowLCJ3ZWlnaHRfd2FybmluZyI6MCwid2VpZ2h0X3Vua25vd24iOjAsIndlaWdodF9vayI6MH1d&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set metaconsole_synch====
 
>= 7
 
 
Añade licencia a metaconsole y sincroniza con los nodos
 
 
*op=set
 
*op2=metaconsole_synch
 
*id=Código de licencia
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/enterprise/meta/include/api.php?op=set&op2=metaconsole_synch&id=CODIGODELICENCIA&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set migrate_agent====
 
>= 7.21 ONLY METACONSOLE
 
 
Añade a la cola de migración de agentes un agente seleccionado
 
 
*op=set
 
*op2=migrate_agent
 
*id=id_agente a migrar
 
*other=nombre nodo origen| nombre nodo destino | (true|false) para no migrar base de datos de histórico
 
*other_mode=url_encode_separator_|
 
*return_type = string, json, etc
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=migrate_agent&apipass=1234&user=admin&pass=pandora&id=2&other=example|example2|0&other_mode=url_encode_separator_|&return_type=string</nowiki>
 
 
====set new_cluster====
 
>= 7.0
 
 
Crea un cluster de agentes
 
 
Crea un cluster de monitorización con agentes e items para monitorizar distintos nodos.
 
 
*op=set
 
*op2=new_cluster
 
*other=nombre_cluster| tipo_cluster| descripcion| id_grupo
 
*other_mode=url_encode_separator_
 
 
=====Ejemplo=====
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=new_cluster&other=nombre_cluster%7CAA%7Cdescripcion%7C12&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_cluster_agent====
 
>= 7.0
 
 
Añadir agente a cluster
 
 
*op=set
 
*op2=add_cluster_agent
 
*other=json con los elementos en base64
 
*other_mode=url_encode_separator_
 
 
La estructura del json debe ser la siguiente:
 
 
[{"id":5,"id_agent":2},
 
{"id":5,"id_agent":3}]
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_cluster_agent&other=W3siaWQiOjUsImlkX2FnZW50IjoyfSwKeyJpZCI6NSwiaWRfYWdlbnQiOjN9XQ==&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_cluster_item (activo/activo)====
 
>= 7.0
 
 
Añadir item activo/activo a cluster
 
 
*op=set
 
*op2=add_cluster_item
 
*other=json con los elementos en base64
 
*other_mode=url_encode_separator_
 
 
La estructura del json debe ser la siguiente:
 
 
[{"name":"Swap_Used","id_cluster":5,"type":"AA","critical_limit":80,"warning_limit":60},
 
{"name":"TCP_Connections","id_cluster":5,"type":"AA","critical_limit":80,"warning_limit":60}]
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_cluster_item&other=W3sibmFtZSI6IlN3YXBfVXNlZCIsImlkX2NsdXN0ZXIiOjUsInR5cGUiOiJBQSIsImNyaXRpY2FsX2xpbWl0Ijo4MCwid2FybmluZ19saW1pdCI6NjB9LAp7Im5hbWUiOiJUQ1BfQ29ubmVjdGlvbnMiLCJpZF9jbHVzdGVyIjo1LCJ0eXBlIjoiQUEiLCJjcml0aWNhbF9saW1pdCI6ODAsIndhcm5pbmdfbGltaXQiOjYwfV0=&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set add_cluster_item (active/passive)====
 
>= 7.0
 
 
Añadir item activo/pasivo a cluster
 
 
*op=set
 
*op2=add_cluster_item
 
*other=json con los elementos en base64
 
*other_mode=url_encode_separator_
 
 
La estructura del json debe ser la siguiente:
 
 
[{"name":"DiskUsed_/proc/kcore","id_cluster":5,"type":"AP","is_critical":1},
 
{"name":"DiskUsed_/proc/sched_debug","id_cluster":5,"type":"AP","is_critical":1}]
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=add_cluster_item&other=W3sibmFtZSI6IkRpc2tVc2VkXy9wcm9jL2tjb3JlIiwiaWRfY2x1c3RlciI6NSwidHlwZSI6IkFQIiwiaXNfY3JpdGljYWwiOjF9LAp7Im5hbWUiOiJEaXNrVXNlZF8vcHJvYy9zY2hlZF9kZWJ1ZyIsImlkX2NsdXN0ZXIiOjUsInR5cGUiOiJBUCIsImlzX2NyaXRpY2FsIjoxfV0=&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_cluster====
 
>= 7.0
 
 
Eliminar cluster
 
 
*op=set
 
*op2=delete_cluster
 
*id=id de cluster a eliminar
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_cluster&id=7&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_cluster_agents====
 
>= 7.0
 
 
Desasociar un agente de un cluster
 
 
*op=set
 
*op2=delete_cluster_agent
 
*other=json con los elementos en base64
 
*other_mode=url_encode_separator_
 
 
La estructura del json debe ser la siguiente:
 
 
[{"id":5,"id_agent":2},
 
{"id":5,"id_agent":3}]
 
 
=====Ejemplo=====
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_cluster_agent&other=W3siaWQiOjUsImlkX2FnZW50IjoyfSwKeyJpZCI6NSwiaWRfYWdlbnQiOjN9XQ==&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_cluster_item====
 
>= 7.0
 
 
Eliminar item de un cluster
 
 
*op=set
 
*op2=delete_cluster_item
 
*id=id del item a eliminar
 
 
  <nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_cluster_item&id=9&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_policy====
 
>= 7.0. 725
 
 
Crear una política.
 
Son obligatorios el nombre de la política, el cual no puede estar repetido y el id_grupo el cual debe existir en la bbdd.
 
 
*op = set
 
*op2 = create_policy
 
*other = nombre de la política (obligatorio) | id_del grupo (obligatorio) | descripción;
 
*other_mode = url_encode_separator_|
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_policy&apipass=1234&user=admin&pass=pandora&other=name%20Policy|11|this%20description&other_mode=url_encode_separator_|&return_type=json</nowiki>
 
 
====set update_policy====
 
>= 7.0. 725
 
 
Actualizar una política.
 
El nombre de la política no puede estar repetido y el id_grupo debe existir en la bbdd.
 
devuelve 0 (false) o id de la política actualizada (true).
 
 
*op = set
 
*op2 = update_policy
 
*id = id política
 
*other = nombre de la política | id_del grupo | descripción;
 
*other_mode = url_encode_separator_|
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=update_policy&apipass=1234&user=admin&pass=pandora&id=17&other=policy2|11|this%20description&other_mode=url_encode_separator_|&return_type=json</nowiki>
 
 
====set delete_policy====
 
>= 7.0. 725
 
 
Eliminar una política. es necesario introducir el id de política y que exista dicha política para poder eliminarla.
 
devuelve 0 (false) o 1 (true).
 
 
*op = set
 
*op2 = delete_policy
 
*id = id política
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_policy&apipass=1234&user=admin&pass=pandora&id=10&return_type=json</nowiki>
 
 
====set add_collections_policy====
 
>= 7.0. 725
 
 
Añadir una colección a una política. Es necesario introducir el id de política y que exista dicha política, como un id, nombre o nombre corto de la colección que se quiera añadir la cual debe existir. Ambos campos son obligatorios.
 
devuelve 0 (false) o el id de la colección añadida a una politica (true).
 
 
*op = set
 
*op2 = add_collections_policy
 
*id = id política
 
*id2 = id, nombre o nombre corto
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=add_collections_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=4&id2=apache_plugin</nowiki>
 
 
====set remove_collections_policy====
 
>= 7.0. 725
 
 
Para marcar una colección de una política que esta pendiente de ser borrada es necesario:
 
* Un id de política y que exista dicha política. Obligatorio
 
* Un id, nombre o nombre corto de la colección que se quiera eliminar la cual debe existir. Obligatorio
 
* Y 0 ó 1:  siendo 1 marcar como pendiente de ser borrada y si es 0 quita la marca de pendiente de ser borrada por defecto si no se añade este campo intentará marcar para que se pueda borrar.
 
 
devuelve 0 (false) o 1 (true).
 
 
*op = set
 
*op2 = remove_collections_policy
 
*id = id política
 
*id2 = id, nombre o nombre corto
 
*other = (bool) 0 ó 1
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=remove_collections_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=4&id2=2&other=1.</nowiki>
 
 
====set create_plugins_policy====
 
>= 7.0. 725
 
 
Para añadir un plugin a una política es necesario:
 
* Un id de política y que exista dicha política. Obligatorio
 
* La cadena del plugin a ejecutar. Obligatorio
 
 
Devuelve 0 (false) o el id del plugin que ha sido añadido a una política (true).
 
 
*op = set
 
*op2 = create_plugins_policy
 
*id = id política
 
*id2 = cadena de texto
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_plugins_policy&apipass=1234&user=admin&pass=pandora&return_type=json&id=2&id2=echo%201</nowiki>
 
 
====set delete_plugins_policy====
 
>= 7.0. 725
 
 
Para eliminar un plugin de una política es necesario:
 
* Un id de política y que exista dicha política. Obligatorio
 
* Un id de plugin que se quiera eliminar. Obligatorio
 
* 0 ó 1: siendo 1 marcar como pendiente de ser borrado el plugin y si es 0 quita la marca de pendiente de ser borrado por defecto si no se añade, este campo se marca como pendiente de ser borrado.
 
devuelve 0 (false) o 1 (true).
 
 
*op = set
 
*op2 = delete_plugins_policy
 
*id = id política
 
*id2 = id plugin
 
*other = 0 ó 1
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_plugins_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=2&id2=1&other=1</nowiki>
 
 
====set linking_policy====
 
>= 7.0. 725
 
 
Para enlazar un módulo desenlazado de una política es necesario:
 
* Un id de agente modulo que este desenlazado.
 
 
devuelve 0 (false) o 1 (true).
 
 
*op = set
 
*op2 = linking_policy
 
*id = id agente modulo
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=linking_policy&apipass=1234&user=admin&pass=pandora&return_type=json&id=28</nowiki>
 
 
====set create_alerts_policy====
 
>= 7.0. 725
 
 
Para crear alertas de una política es necesario:
 
* Un id de política que debe existir (obligatorio).
 
* Un id módulo de política si es de tipo normal es obligatorio
 
* Una id plantilla que debe existir (obligatorio).
 
* Si es o no external 0 (normal), 1 (external). Por defecto es 0 normal
 
* Es obligatorio en caso de ser de tipo external (1) nombre de módulo con el que coincidir.
 
devuelve 0 (false) o el id de la alerta añadida en la política (true).
 
 
*op = set
 
*op2 = create_alerts_policy
 
*id = id política
 
*id2 = id modulo política
 
*other = id modulo política|id template|0 ó 1|nombre de modulo.
 
*other_mode = url_encode_separator_|
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_alerts_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=2&other=0|2|1|cpu%20load&other_mode=url_encode_separator_|</nowiki>
 
 
====set update_alerts_policy====
 
>= 7.0. 725
 
 
Para actualizar alertas de una política es necesario:
 
* Un id de política que debe existir (obligatorio).
 
* Activo 0 | En espera 1
 
* habilitar 0 | deshabilitar 1
 
devuelve 0 (false) o el id de la alerta actualizada en la política (true).
 
 
*op = set
 
*op2 = update_alerts_policy
 
*id = id política
 
*other = 0 ó 1 (activar/desactivar) | 0 ó 1 (habilitar/deshabilitar).
 
*other_mode = url_encode_separator_|
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=update_alerts_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=7&other=1|1&other_mode=url_encode_separator_|</nowiki>
 
 
====set delete_alerts_policy====
 
>= 7.0. 725
 
 
Para eliminar una alerta de una política es necesario:
 
* Un id de alerta de política que debe existir (obligatorio).
 
* 0 | 1 marcar pendiente de eliminación o no por defecto si no se añade este campo se queda a 1
 
* Activo 0 | En espera 1
 
devuelve 0 (false) o 1 (true).
 
 
*op = set
 
*op2 = delete_alerts_policy
 
*id = id política
 
*id2 = 0 ó 1.
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_alerts_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=7&id2=1</nowiki>
 
 
====set create_alerts_actions_policy====
 
>= 7.0. 725
 
 
Para añadir una acción a una alerta de una política es necesario:
 
* Un id de alerta de política que debe existir (obligatorio).
 
* Un id de acción de política que debe existir (obligatorio).
 
* Se le puede añadir número mínimo de disparos o número máximo de disparos por defecto: 0
 
devuelve 0 (false) o el id de la acción añadida a la alerta de una política (true).
 
 
*op = set
 
*op2 = create_alerts_action_policy
 
*id = id política
 
*id2 = id acción
 
*other = min fires | max fires
 
*other_mode=url_encode_separator_|
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://172.16.0.2/pandora_console/include/api.php?op=set&op2=create_alerts_actions_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=1&id2=4&other=5|2&other_mode=url_encode_separator_|</nowiki>
 
 
====set delete_alerts_actions_policy====
 
>= 7.0. 725
 
 
Para eliminar una acción de una alerta de una política es necesario:
 
* Un id de alerta de política que debe existir (obligatorio).
 
* Un id de acción de política que debe existir (obligatorio).
 
 
*op = set
 
*op2 = delete_alerts_action_policy
 
*id = id política
 
*id2 = id acción
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_alerts_actions_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=1&id2=4</nowiki>
 
 
====set remove_agents_policy====
 
>= 7.0. 725
 
 
Para eliminar un agente de una política es necesario:
 
* Un id de política que debe existir (obligatorio).
 
* Un id de agente que debe existir (obligatorio).
 
 
*op = set
 
*op2 = remove_agents_policy
 
*id = id política
 
*id2 = id grupo
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=remove_agents_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=5&id2=2</nowiki>
 
 
====set add_groups_policy====
 
>= 7.0. 725
 
 
Para agregar un grupo de una política es necesario:
 
* Un id de política que debe existir (obligatorio).
 
* Un id de grupo que debe existir (obligatorio).
 
 
*op = set
 
*op2 = add_groups_policy
 
*id = id política
 
*id2 = id grupo
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=add_groups_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=7&id2=12</nowiki>
 
 
====set remove_groups_policy====
 
>= 7.0. 725
 
 
Para eliminar un agente de una política es necesario:
 
* Un id de política que debe existir (obligatorio).
 
* Un id de grupo que debe existir (obligatorio).
 
 
*op = set
 
*op2 = add_groups_policy
 
*id = id política
 
*id2 = id grupo
 
*return_type = (string, csv, json).
 
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=remove_groups_policy&apipass=1234&user=admin&pass=pandora&return_type=string&id=5&id2=2</nowiki>
 
 
====set create_os====
 
>= 7.0. 727
 
 
Crea un nuevo sistema operativo con los datos pasados como parámetros.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_os (obligatorio)
 
*other=<parámetros serializados> (obligatorio) son los datos del sistema operativo, serializados en el siguiente orden:
 
:*&lt;nombre&gt;
 
:*&lt;descripcion&gt;
 
:*&lt;icono&gt;
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_os&other=os_name%7Cos_description%7Cos_icon.png&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_os====
 
>= 7.0. 727
 
 
Actualiza el sistema operativo con los datos pasados como parámetros.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_os (obligatorio)
 
*id=<id de sistema operativo> (obligatorio)
 
*other=<parámetros serializados> (obligatorio) son los datos del sistema operativo, serializados en el siguiente orden:
 
:*&lt;nombre&gt;
 
:*&lt;descripcion&gt;
 
:*&lt;icono&gt;
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?id=107&op=set&op2=update_os&other=os_name_to_update%7Cos_description_to_update%7Cos_icon_to_update.png&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set disabled_and_standby====
 
>= 7.0. 728
 
 
Deshabilita un agente y, si tiene configuración remota, lo pone en modo standby.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=disabled_and_standby (obligatorio)
 
*id=<id del agente> (obligatorio). En la metaconsola es el id de tagente, es decir, el id del nodo.
 
*id2=<id del nodo> (obligatorio en la metaconsola, innecesario en el nodo)
 
*other=<valor> (opcional) Valor (0 para habilitar y 1 para deshabilitar) del nuevo estado. Si no se especifica ningún valor, deshabilita el agente.
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?id=2&op=set&op2=disabled_and_standby&other=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?id=2&id2=1&op=set&op2=disabled_and_standby&other=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set validate_traps====
 
>= 7.0. 728
 
 
Permite validar traps.
 
 
*op = set
 
*op2 = validate_traps
 
*id = id del trap
 
 
=====Ejemplo=====
 
<nowiki>https://127.0.0.1/pandora_console/include/api.php?op=set&op2=validate_traps&id=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_traps====
 
>= 7.0. 728
 
 
Permite eliminar un trap:
 
 
*op = set
 
*op2 = delete_traps
 
*id = id del trap
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?id=2&op=set&op2=delete_traps&id=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set access_process====
 
>= 7.0NG. 728
 
 
Esta función permite gestionar el acceso a una tercera aplicación a partir de registros en el system audit log de pandorafms. Utiliza diferentes parámetros para procesar una de estas acciones de registro en nuestra aplicación y evita el acceso concurrente de usuarios administradores. Opcionalmente puede prohibir el acceso a usuarios no administradores.
 
 
Sintaxis de la llamada:
 
 
* op = set
 
* op2 = access_process
 
* other=<parámetros obligatorios>:
 
:* <id_usuario>
 
 
El id del usuario que intenta acceder a la aplicación, este dato queda registrado y se comprueba en la auditoría para filtrar el acceso, salida, explusión o navegación del usuario a través de la aplicación.
 
 
:* <acción> - (login,logout,exclude,browse)
 
 
login: Se usa para solicitar el acceso a la aplicación. Delvuelve la cadena de texto "free" y registra nuestro acceso en la auditoría de pandorafms o devuelve la cadena de texto "denied" si en los registros de la auditoría hay otro usuario que haya accedido anteriormente al sistema y no haya salido aún. También devolverá "denied" si el parámetro de acceso solo para administradores está activado y el usuario no lo es.
 
 
logout: Registra la salida de un usuario de la aplicación para que vuelva a estar permitido el acceso a otros usuarios.
 
 
browse: Se debe de utilizar en todas las páginas de la aplicación externa, ya que comprueba si éste usuario sigue siendo el último que ha accedido o ha sido expulsado de la aplicación.
 
 
exclude: Expulsa al usuario registrado actualmente y registra el acceso de otro que hayamos enviado en el parámetro de id_usuario.
 
 
:* <dirección_ip_aplicación>
 
 
IP de la aplicación desde la que se está accediendo. Se registro y se comprueba en la auditoría de pandorafms para comprobar el estado de acceso de los usuarios en la aplicación.
 
 
:* <nombre_aplicación>
 
 
Nombre de la aplicación desde la que se está accediendo. Se registro y se comprueba en la auditoría de Pandora FMS para comprobar el estado de acceso de los usuarios en la aplicación.
 
 
:* <acceso_solo_administradores>
 
 
Prohibe el acceso de usuarios no administradores.
 
 
=====Ejemplo (requiere entorno adaptado)=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=access_process&other=1%7Clogin%7C192.168.50.25%7Cexternal_app%7C0&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_event_response====
 
Crea una nueva respuesta de evento.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_event_response (obligatorio)
 
*return_type=csv|json (obligatorio)
 
*other=<parámetros serializados> (todos obligatorios). Por este orden
 
:*<nombre>
 
:*<descripción>
 
:*<target> Si el cuarto parámetro (<tipo>) es ''command'', aquí hay que indicar el comando que se quiere que ejecute la respuesta al evento. En cambio, si es ''url'', se debe indicar la URL a la que se desea acceder como respuesta al evento.
 
:*<tipo> ''command'' o ''url''.
 
:*<id del grupo> El usuario deberá tener permisos sobre el grupo indicado.
 
:*<ancho de la ventana modal> En píxeles.
 
:*<alto de la ventana modal> En píxeles.
 
:*<nueva ventana> 1 o 0. Indica si la URL se muestra en una ventana nueva (1) o sobre una ventana modal (0).
 
:*<parámetros> Parámetros que complementan la ejecución del comando.
 
:*<servidor> Id del servidor donde se desea que se ejecute el comando. Para la consola local el valor es 0.
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_event_response&other=response%7Cdescription%20response%7Ctouch%7Ccommand%7C0%7C650%7C400%7C0%7Cresponse%7C0&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_event_response====
 
Edita una respuesta de evento existente. El usuario debe de tener permisos sobre el grupo al que pertenece la respuesta para poder editarla.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_event_response (obligatorio)
 
*return_type=csv|json (obligatorio)
 
*id=<id de la respuesta de eventos> (obligatorio)
 
*other=<parámetros serializados> (opcionales). Por este orden
 
:*<nombre>
 
:*<descripción>
 
:*<target> Si el cuarto parámetro (<tipo>) es ''command'', aquí hay que indicar el comando que se quiere que ejecute la respuesta al evento. En cambio, si es ''url'', se debe indicar la URL a la que se desea acceder como respuesta al evento.
 
:*<tipo> ''command'' o ''url''.
 
:*<id del grupo> El usuario deberá tener permisos sobre el grupo indicado.
 
:*<ancho de la ventana modal> En píxeles.
 
:*<alto de la ventana modal> En píxeles.
 
:*<nueva ventana> 1 o 0. Indica si la URL se muestra en una ventana nueva (1) o sobre una ventana modal (0).
 
:*<parámetros> Parámetros que complementan la ejecución del comando.
 
:*<servidor> Id del servidor donde se desea que se ejecute el comando. Para la consola local el valor es 0.
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=update_event_response&id=7&other=response%7Cdescription%20response%7Ctouch%7Ccommand%7C0%7C650%7C400%7C0%7Cresponse%7C0&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_event_response====
 
Borra una respuesta de evento. El usuario debe de tener permisos sobre el grupo al que pertenece la respuesta para poder borrarla.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_event_reponse (obligatorio)
 
*return_type=csv|json
 
*id=<id de la respuesta de eventos> (obligatorio)
 
=====Ejemplo=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_event_response&id=7&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_user_profile_info====
 
Crea un nuevo perfil de usuario.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_user_profile_info (obligatorio)
 
*return_type=csv|json (obligatorio)
 
*other=<parámetros serializados> Por este orden
 
:*<nombre> (obligatorio)
 
:*<bits de acceso>: 1 si se quiere activar el bit y 0 en caso contrario. No son obligatorios pero si no se especifica ningún valor se marcará el bit como no activo. Por este orden: '''IR|IW|IM|AR|AW|AD|LW|LM|UM|DM|ER|EW|EM|RR|RW|RM|MR|MW|MM|VR|VW|VM|PM'''.
 
 
{{Tip|Para saber que permisos debemos activar, visite el siguiente [[Pandora:Documentation_es:Gestion_y_Administracion#Perfiles_en_Pandora_FMS | enlace.]]}}
 
 
=====Ejemplos=====
 
Este ejemplo crea un perfil que da un acceso de solo lectura a Pandora FMS, es decir, es igual que el perfil predefinido ''Operator (read)''.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_user_profile_info&return_type=json&other=API_profile%7C1%7C0%7C0%7C1%7C0%7C0%7C0%7C0%7C0%7C0%7C1%7C0%7C0%7C1%7C0%7C0%7C1%7C0%7C0%7C1%7C0%7C0%7C0&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_user_profile_info====
 
Actualiza nuevo perfil de usuario existente.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_user_profile_info (obligatorio)
 
*other=<parámetros serializados> (todos opcionales) Por este orden
 
:*<nombre>
 
:*<bits de acceso>: 1 si se quiere activar el bit y 0 si se quiere deshabilitar. Si no se especifica ningún valor, no cambiará. Por este orden: '''IR|IW|IM|AR|AW|AD|LW|LM|UM|DM|ER|EW|EM|RR|RW|RM|MR|MW|MM|VR|VW|VM|PM'''.
 
 
 
{{Tip|Para saber que permisos debemos activar, visite el siguiente [[Pandora:Documentation_es:Gestion_y_Administracion#Perfiles_en_Pandora_FMS | enlace.]]}}
 
 
=====Ejemplos=====
 
En este ejemplo se cambia el nombre del perfil con ID 6 a ''API_profile_updated'' y se le dan todos los permisos (lectura, escritura y gestión) en lo relacionado a agentes y se elimina el permiso de lectura de eventos.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=update_user_profile_info&return_type=json&id=6&other=API_profile_updated%7C%7C%7C%7C1%7C1%7C1%7C%7C%7C%7C%7C0%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_user_profile_info====
 
Borra un perfil de usuario. También elimina todas las asignaciones de ese perfil a cualquier usuario.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_user_profile_info (obligatorio)
 
*return_type=csv|json
 
*id=<id del perfil> (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_user_profile_info&return_type=json&id=8&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_event_filter====
 
Crea un filtro de evento.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_event_filter (obligatorio)
 
*other=<parámetros serializados>. Por este orden:
 
:*<id_group_filter>
 
:*<id_group>
 
:*<event_type [new_agent|alert_recovered|alert_ceased|alert_fired|configuration_change|error|alert_manual_valdation|critical|normal|warning|not_normal|recon_host_detected|system|unknown|going_unknown]>
 
:*<severity [0|1|2|3|4|5|6|20|21|34]> (0: Mantenimiento, 1: Informativo, 2: Normal, 3: Advertencia, 4: Crítico, 5: Menor, 6: Principal, 20: No normal, 21: Crítico/Normal, 34: Advertencia/Crítico)
 
:*<event_status [2|3|0|1]> (0: Solo nuevos, 1: Solo validados, 2: Solo en proceso, 3: Solo no validados)
 
:*<free_search>
 
:*<agent_id>
 
:*<pagination_size [25|50|100|200|500]>
 
:*<max_hours_old>
 
:*<id_user_ack>
 
:*<duplicate [0|1]> (0: Todos los eventos, 1: Eventos agrupados)
 
:*<date_from> (formato: AAAA/MM/DD)
 
:*<date_to> (formato: AAAA/MM/DD)
 
:*<events_with_tags> (formato: ["id_etiqueta_1", "id_etiqueta_2", id_etiqueta3", "..."])
 
:*<events_without_tags> (formato: ["id_etiqueta_1", "id_etiqueta_2", "id_etiqueta3", "..."])
 
:*<alert_events [0|1]> (0: filtrar por eventos de alertas, 1: Solo eventos de alertas)
 
:*<module_id>
 
:*<source>
 
:*<id_extra>
 
:*<user_comment>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=create_event_filter&id=test&other=%7C%7Cerror%7C4%7C%7C%7C1%7C%7C12%7C%7C%7C2018-12-09%7C2018-12-13%7C[%226%22]%7C[%2210%22,%226%22,%223%22]%7C1%7C10%7C%7C%7C&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_event_filter====
 
Actualiza un filtro de evento.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_event_filter (obligatorio)
 
*id=<event_filter_id> (obligatorio) debe ser un id de filtro de evento existente.
 
*other=<parámetros serializados> (opcionales). Por este orden
 
:*<id_group_filter>
 
:*<id_group>
 
:*<event_type [new_agent|alert_recovered|alert_ceased|alert_fired|configuration_change|error|alert_manual_valdation|critical|normal|warning|not_normal|recon_host_detected|system|unknown|going_unknown]>
 
:*<severity [0|1|2|3|4|5|6|20|21|34]> (0: Mantenimiento, 1: Informativo, 2: Normal, 3: Advertencia, 4: Crítico, 5: Menor, 6: Principal, 20: No normal, 21: Crítico/Normal, 34: Advertencia/Crítico)
 
:*<event_status [2|3|0|1]> (0: Solo nuevos, 1: Solo validados, 2: Solo en proceso, 3: Solo no validados)
 
:*<free_search>
 
:*<agent_id>
 
:*<pagination_size [25|50|100|200|500]>
 
:*<max_hours_old>
 
:*<id_user_ack>
 
:*<duplicate [0|1]> (0: Todos los eventos, 1: Eventos agrupados)
 
:*<date_from> (formato: AAAA/MM/DD)
 
:*<date_to> (formato: AAAA/MM/DD)
 
:*<events_with_tags> (formato: ["id_etiqueta_1", "id_etiqueta_2", "id_etiqueta3", "..."])
 
:*<events_without_tags> (formato: ["id_etiqueta_1", "id_etiqueta_2", "id_etiqueta3", "..."])
 
:*<alert_events [0|1]> (0: filtrar por eventos de alertas, 1: Solo eventos de alertas)
 
:*<module_id>
 
:*<source>
 
:*<id_extra>
 
:*<user_comment>
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=update_event_filter&id=195&other=new_name%7C%7C%7Calert_recovered%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_event_filter====
 
Borra un filtro de evento.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_event_filter (obligatorio)
 
*id=<event_filter_id> (obligatorio) debe ser un id de filtro de evento existente.
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=set&op2=delete_event_filter&id=38&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====get all_event_filters====
 
Devuelve la lista de filtros de eventos existentes.
 
 
Sintaxis de la llamada:
 
 
*op=get (obligatorio)
 
*op2=all_event_filters (obligatorio)
 
*other=cvs_separator (opcional)
 
 
=====Ejemplos=====
 
<nowiki>http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_event_filters&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_inventory_module====
 
Crea un nuevo módulo de inventario.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_inventory_module (obligatorio)
 
*return_type=csv|json
 
*other=<parámetros serializados> Por este orden
 
:*<nombre> (obligatorio)
 
:*<descripcción>: (obligatorio pero puede ser vacío)
 
:*<id sistema operation>: (obligatorio). Id numérico de la tabla ''tconfig_os''
 
:*<intérprete>: (obligatorio aunque puede ser vacío). Si el intérprete es vacío se interpreta que solo es un módulo de inventario local.
 
:*<código>: (obligatorio pero puede ser vacío) ''Script'' que tiene que ejecutarse para obtener los datos de inventario. Debe pasarse en '''base64'''.
 
:*<formato de los datos>: (obligatorio) Cabecera de los datos extraídos (separados por '';'').
 
:*<modo block>: (obligatorio) 1 o 0.
 
 
=====Ejemplo=====
 
Este ejemplo crea módulo llamado '''OS''' de inventario que recoge los datos ''kernel-name'' y ''nodename'' de un sistema Linux.
 
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_inventory_module&return_type=json&other=OS%7COS_name_description%7C1%7C/bin/bash%7CIyEvYmluL2Jhc2gKZWNobyB1bmFtZSAtbiAtcw==%7Ckernelname;nodename%7C0&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set update_inventory_module====
 
Actualiza un módulo de inventario.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=update_inventory_module (obligatorio)
 
*id= ID del módulo de inventario (obligatorio)
 
*return_type=csv|json
 
*other=<parámetros serializados> Por este orden
 
:*<nombre> (obligatorio)
 
:*<descripcción>: (obligatorio pero puede ser vacío)
 
:*<id sistema operation>: (obligatorio). Id numérico de la tabla ''tconfig_os''
 
:*<intérprete>: (obligatorio aunque puede ser vacío). Si el intérprete es vacío se interpreta que solo es un módulo de inventario local.
 
:*<código>: (obligatorio pero puede ser vacío) ''Script'' que tiene que ejecutarse para obtener los datos de inventario. Debe pasarse en '''base64'''.
 
:*<formato de los datos>: (obligatorio) Cabecera de los datos extraídos (separados por '';'').
 
:*<modo block>: (obligatorio) 1 o 0.
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=update_inventory_module&return_type=json&id=42&other=OS_easy%7COS_name_description%7C1%7C/bin/bash%7CIyEvYmluL2Jhc2gKZWNobyB1bmFtZSAtbiAtcw==%7Ckernelname;nodename%7C0&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_inventory_module====
 
Borra un perfil de usuario. También elimina todas las asignaciones de ese perfil a cualquier usuario.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_inventory_module (obligatorio)
 
*return_type=csv|json
 
*id=<id del módulo de inventario> (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_inventory_module&return_type=json&id=42&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set create_collection====
 
Crea una colección.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=create_collection (obligatorio)
 
*other=&lt;valores serializados&gt; (obligatorio) Valores serializados para crear la colección:
 
:*&lt;name&gt;
 
:*&lt;short_name&gt;
 
:*&lt;id_group&gt;
 
:*&lt;description&gt;
 
Es necesario acompañarlo con 'other_mode' de la siguiente manera: other_mode=url_encode_separator_&lt;separador&gt; para pasar el separador de los valores serializados de other.
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=create_collection&other=test_plugin|test_p|0|test&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
====set delete_collection====
 
Elimina una colección.
 
 
Sintaxis de la llamada:
 
*op=set (obligatorio)
 
*op2=delete_collection (obligatorio)
 
*id= id_collection (obligatorio)
 
 
=====Ejemplos=====
 
<nowiki>http://localhost/pandora_console/include/api.php?op=set&op2=delete_collection&id=15&apipass=1234&user=admin&pass=pandora</nowiki>
 
 
== Ejemplos ==
 
Distintos ejemplos simples de llamada al API en distintos lenguajes.
 
 
=====Ejemplo=====
 
<nowiki>http://127.0.0.1/pandora5/include/api.php?apipass=1234&user=admin&pass=pandora&op=set&op2=gis_agent&id=582&other_mode=url_encode_separator_|&other=2%7C2%7C0%7C0%7C0%7C2000-01-01+01%3A01%3A01%7C0%7C666%7Caaa%7Cbbb%7Cccc</nowiki>
 
 
=== PHP ===
 
<pre>
 
<?php
 
$ip = '192.168.70.110';
 
$pandora_url = '/pandora5';
 
$apipass = '1234';
 
$user = 'admin';
 
$password = 'pandora';
 
$op = 'get';
 
$op2 = 'all_agents';
 
$return_type = 'csv';
 
$other = '';
 
$other_mode = '';
 
 
$url = "http://" . $ip . $pandora_url . "/include/api.php";
 
 
$url .= "?";
 
$url .= "apipass=" . $apipass;
 
$url .= "&user=" . $user;
 
$url .= "&pass=" . $password;
 
$url .= "&op=" . $op;
 
$url .= "&op2=" . $op2;
 
if ($id !== '') {
 
$url .= "&id=" . $id;
 
}
 
if ($id2 !== '') {
 
$url .= "&id2=" . $id2;
 
}
 
if ($return_type !== '') {
 
$url .= "&return_type=" . $return_type;
 
}
 
if ($other !== '') {
 
$url .= "&other_mode=" . $other_mode;
 
$url .= "&other=" . $other;
 
}
 
 
$curlObj = curl_init();
 
curl_setopt($curlObj, CURLOPT_URL, $url);
 
curl_setopt($curlObj, CURLOPT_RETURNTRANSFER, 1);
 
$result = curl_exec($curlObj);
 
curl_close($curlObj);
 
 
$agents = array();
 
if (!empty($result)) {
 
$lines = explode("\n", $result);
 
foreach ($lines as $line) {
 
$fields = explode(";", $line);
 
 
$agent = array();
 
$agent['id_agent'] = $fields[0];
 
$agent['name'] = $fields[1];
 
$agent['ip'] = $fields[2];
 
$agent['description'] = $fields[3];
 
$agent['os_name'] = $fields[4];
 
$agent['url_address'] = $fields[5];
 
 
$agents[] = $agent;
 
}
 
}
 
 
print_list_agents($agents);
 
 
function print_list_agents($agents) {
 
echo "<table border='1' style='empty-cells: show;'>";
 
 
echo "<thead>";
 
echo "<tr>";
 
echo "<th>" . "ID" . "</th>";
 
echo "<th>" . "Name" . "</th>";
 
echo "<th>" . "IP" . "</th>";
 
echo "<th>" . "Description" . "</th>";
 
echo "<th>" . "OS" . "</th>";
 
echo "<th>" . "URL" . "</th>";
 
echo "</tr>";
 
echo "</thead>";
 
 
foreach ($agents as $agent) {
 
echo "<tr>";
 
echo "<td>" . $agent['id_agent'] . "</td>";
 
echo "<td>" . $agent['name'] . "</td>";
 
echo "<td>" . $agent['ip'] . "</td>";
 
echo "<td>" . $agent['description'] . "</td>";
 
echo "<td>" . $agent['os_name'] . "</td>";
 
echo "<td>" . $agent['url_address'] . "</td>";
 
echo "</tr>";
 
}
 
echo "</table>";
 
}
 
?>
 
</pre>
 
 
=== Python ===
 
<pre>
 
import pycurl
 
import cStringIO
 
import pprint
 
 
def main():
 
ip = '192.168.70.110'
 
pandora_url = '/pandora5'
 
apipass = '1234'
 
user = 'admin'
 
password = 'pandora'
 
op = 'get'
 
op2 = 'all_agents'
 
return_type = 'csv'
 
other = ''
 
other_mode = ''
 
 
url = "http://" + ip  + pandora_url + "/include/api.php"
 
 
url += "?"
 
url += "apipass=" + apipass
 
url += "&user="  + user
 
url += "&pass=" + password
 
url += "&op=" + op
 
url += "&op2=" + op2
 
 
buf = cStringIO.StringIO()
 
 
c = pycurl.Curl()
 
c.setopt(c.URL, url)
 
c.setopt(c.WRITEFUNCTION, buf.write)
 
c.perform()
 
 
output = buf.getvalue()
 
buf.close()
 
 
lines = output.split("\n")
 
agents = []
 
for line in lines:
 
if not line:
 
continue
 
 
fields = line.split(";")
 
agent = {}
 
agent['id_agent'] = fields[0]
 
agent['name'] = fields[1]
 
agent['ip'] = fields[2]
 
agent['description'] = fields[3]
 
agent['os_name'] = fields[4]
 
agent['url_address'] = fields[5]
 
 
agents.append(agent)
 
 
for agent in agents:
 
print("---- Agent #" + agent['id_agent'] + " ----")
 
print("Name: " + agent['name'])
 
print("IP: " + agent['ip'])
 
print("Description: " + agent['description'])
 
print("OS: " + agent['os_name'])
 
print("URL: " + agent['url_address'])
 
print("")
 
 
if __name__ == "__main__":
 
    main()
 
</pre>
 
 
 
=== Perl ===
 
<pre>
 
use strict;
 
use warnings;
 
use WWW::Curl::Easy;
 
 
sub write_callback {
 
my ($chunk,$variable) = @_;
 
 
push @{$variable}, $chunk;
 
return length($chunk);
 
}
 
 
my $ip = '192.168.70.110';
 
my $pandora_url = '/pandora5';
 
my $apipass = '1234';
 
my $user = 'admin';
 
my $password = 'pandora';
 
my $op = 'get';
 
my $op2 = 'all_agents';
 
my $return_type = 'csv';
 
my $other = '';
 
my $other_mode = '';
 
 
my $url = "http://" . $ip  . $pandora_url . "/include/api.php";
 
$url .= "?";
 
$url .= "apipass=" . $apipass;
 
$url .= "&user=" . $user;
 
$url .= "&pass=" . $password;
 
$url .= "&op=" . $op;
 
$url .= "&op2=" . $op2;
 
 
my @body;
 
 
my $curl = WWW::Curl::Easy->new;
 
$curl->setopt(CURLOPT_URL, $url);
 
$curl->setopt(CURLOPT_WRITEFUNCTION, \&write_callback);
 
$curl->setopt(CURLOPT_FILE, \@body);
 
$curl->perform();
 
 
my $body=join("",@body);
 
my @lines = split("\n", $body);
 
 
foreach my $line (@lines) {
 
my @fields = split(';', $line);
 
 
print("\n---- Agent #" . $fields[0] . " ----");
 
print("\nName: " .  $fields[1]);
 
print("\nIP: " .  $fields[2]);
 
print("\nDescription: " . $fields[3]);
 
print("\nOS: "  . $fields[4]);
 
print("\n");
 
}
 
</pre>
 
 
=== Ruby ===
 
<pre>
 
require 'open-uri'
 
 
ip = '192.168.70.110'
 
pandora_url = '/pandora5'
 
apipass = '1234'
 
user = 'admin'
 
password = 'pandora'
 
op = 'get'
 
op2 = 'all_agents'
 
return_type = 'csv'
 
other = ''
 
other_mode = ''
 
 
url = "http://" + ip  + pandora_url + "/include/api.php"
 
 
url += "?"
 
url += "apipass=" + apipass
 
url += "&user="  + user
 
url += "&pass=" + password
 
url += "&op=" + op
 
url += "&op2=" + op2
 
 
agents = []
 
 
open(url) do |content|
 
 
content.each do |line|
 
agent = {}
 
 
tokens = line.split(";")
 
 
agent[:id_agent] = tokens[0]
 
agent[:name] = tokens[1]
 
agent[:ip] = tokens[2]
 
agent[:description] = tokens[3]
 
agent[:os_name] = tokens[4]
 
agent[:url_address] = tokens[5]
 
 
agents.push agent
 
end
 
end
 
 
 
agents.each do |agent|
 
print("---- Agent #" + (agent[:id_agent] || "") + " ----\n")
 
print("Name: " + (agent[:name] || "") + "\n")
 
print("IP: " + (agent[:ip] || "") + "\n")
 
print("Description: " + (agent[:description] || "") + "\n")
 
print("OS: " + (agent[:os_name] || "") + "\n")
 
print("URL: " + (agent[:url_address] || "") + "\n")
 
print("\n")
 
end
 
</pre>
 
 
=== Lua ===
 
<pre>
 
require("curl")
 
 
local content = ""
 
 
function WriteMemoryCallback(s)
 
content = content .. s
 
 
return string.len(s)
 
end
 
 
ip = '192.168.70.110'
 
pandora_url = '/pandora5'
 
apipass = '1234'
 
user = 'admin'
 
password = 'pandora'
 
op = 'get'
 
op2 = 'all_agents'
 
return_type = 'csv'
 
other = ''
 
other_mode = ''
 
 
url = "http://" .. ip  .. pandora_url .. "/include/api.php"
 
 
url = url .. "?"
 
url = url .. "apipass=" .. apipass
 
url = url .. "&user=" .. user
 
url = url .. "&pass=" .. password
 
url = url .. "&op=" .. op
 
url = url .. "&op2=" .. op2
 
 
if curl.new then c = curl.new() else c = curl.easy_init() end
 
 
c:setopt(curl.OPT_URL, url)
 
c:setopt(curl.OPT_WRITEFUNCTION, WriteMemoryCallback)
 
 
c:perform()
 
 
for line in string.gmatch(content, "[^\n]+") do
 
line = string.gsub(line, "\n", "")
 
 
count = 0
 
for field in string.gmatch(line, "[^\;]+") do
 
if count == 0 then
 
print("---- Agent #" .. field .. " ----")
 
end
 
if count == 1 then
 
print("Name: " .. field)
 
end
 
if count == 2 then
 
print("IP: " .. field)
 
end
 
if count == 3 then
 
print("Description: " .. field)
 
end
 
if count == 4 then
 
print("OS: " .. field)
 
end
 
if count == 5 then
 
print("URL: " .. field)
 
end
 
 
count = count + 1
 
end
 
print("")
 
end
 
</pre>
 
 
=== Brainfuck ===
 
<pre>
 
[-]>[-]<
 
>+++++++++[<+++++++++>-]<-.
 
>+++++[<+++++>-]<----.
 
>++++[<++++>-]<---.
 
>++++[<---->-]<++.
 
>+++[<+++>-]<++.
 
-.
 
>++++++++[<-------->-]<--.
 
>+++[<--->-]<---.
 
>++++++++[<++++++++>-]<++++.
 
+.
 
>++++++++[<-------->-]<-----.
 
>+++++++++[<+++++++++>-]<----.
 
++.
 
--.
 
>+++[<--->-]<+.
 
>+++[<+++>-]<.
 
>++[<++>-]<++.
 
>++[<-->-]<-.
 
>+++++++++[<--------->-]<++.
 
>+++++++++[<+++++++++>-]<---.
 
+.
 
>+++++++++[<--------->-]<++.
 
>+++++++++[<+++++++++>-]<+++.
 
>++++[<---->-]<+.
 
>+++[<+++>-]<.
 
>+++[<--->-]<++.
 
>+++[<+++>-]<-.
 
>+++++++++[<--------->-]<++.
 
>+++++++++[<+++++++++>-]<+++.
 
>+++[<--->-]<--.
 
----.
 
>+++[<+++>-]<-.
 
+++.
 
-.
 
>+++++++++[<--------->-]<++.
 
>+++++++++[<+++++++++>-]<-.
 
>++++[<---->-]<+.
 
>++++[<++++>-]<+.
 
>++++[<---->-]<-.
 
>++++++++[<-------->-]<-.
 
>++++++++[<++++++++>-]<++++++++.
 
>+++[<--->-]<++.
 
++.
 
++.
 
>++++[<++++>-]<---.
 
>++[<-->-]<--.
 
+++.
 
>++++++++[<-------->-]<---.
 
>+++[<--->-]<---.
 
>+++++++++[<+++++++++>-]<-.
 
>+++[<--->-]<--.
 
>++++[<++++>-]<---.
 
---.
 
>+++++++++[<--------->-]<++.
 
>+++++++++[<+++++++++>-]<+++++.
 
>+++++[<----->-]<++++.
 
>+++[<+++>-]<++.
 
>+++[<--->-]<++.
 
>++++++++[<-------->-]<-----.
 
>+++++++++[<+++++++++>-]<----.
 
>+++[<+++>-]<-.
 
>++++[<---->-]<--.
 
>++[<++>-]<+.
 
>+++[<+++>-]<--.
 
++++.
 
>+++++++++[<--------->-]<--.
 
>++++++++[<++++++++>-]<++++++.
 
>+++[<+++>-]<+++.
 
>+++[<--->-]<.
 
++.
 
--.
 
>+++[<+++>-]<--.
 
>++[<++>-]<+.
 
>+++[<--->-]<++.
 
>++[<++>-]<++.
 
>++[<-->-]<-.
 
++++.
 
>++++++++[<-------->-]<-----.
 
</pre>
 
 
=== Java (Android) ===
 
Puedes ver nuestro proyecto (Pandroid Event Viewer) en [https://github.com/pandorafms/pandorafms/tree/develop/extras/android-event-viewer Repositorio SVN de Pandroid Event Viewer source code en GitHub] pero aquí esta el trozo de código más importante que realiza la llamada al API para sacar los eventos.
 
 
<pre>
 
/**
 
* Performs an http get petition.
 
*
 
* @param context
 
*            Application context.
 
* @param additionalParameters
 
*            Petition additional parameters
 
* @return Petition result.
 
* @throws IOException
 
*            If there is any problem with the connection.
 
*/
 
public static String httpGet(Context context,
 
List<NameValuePair> additionalParameters) throws IOException {
 
SharedPreferences preferences = context.getSharedPreferences(
 
context.getString(R.string.const_string_preferences),
 
Activity.MODE_PRIVATE);
 
 
String url = preferences.getString("url", "") + "/include/api.php";
 
String user = preferences.getString("user", "");
 
String password = preferences.getString("password", "");
 
String apiPassword = preferences.getString("api_password", "");
 
if (url.length() == 0 || user.length() == 0) {
 
return "";
 
}
 
ArrayList<NameValuePair> parameters = new ArrayList<NameValuePair>();
 
parameters.add(new BasicNameValuePair("user", user));
 
parameters.add(new BasicNameValuePair("pass", password));
 
if (apiPassword.length() > 0) {
 
parameters.add(new BasicNameValuePair("apipass", apiPassword));
 
}
 
parameters.addAll(additionalParameters);
 
Log.i(TAG, "sent: " + url);
 
if (url.toLowerCase().contains("https")) {
 
// Secure connection
 
return Core.httpsGet(url, parameters);
 
} else {
 
HttpParams params = new BasicHttpParams();
 
HttpConnectionParams.setConnectionTimeout(params,
 
CONNECTION_TIMEOUT);
 
HttpConnectionParams.setSoTimeout(params, CONNECTION_TIMEOUT);
 
DefaultHttpClient httpClient = new DefaultHttpClient(params);
 
UrlEncodedFormEntity entity;
 
HttpPost httpPost;
 
HttpResponse response;
 
HttpEntity entityResponse;
 
String return_api;
 
httpPost = new HttpPost(url);
 
entity = new UrlEncodedFormEntity(parameters);
 
httpPost.setEntity(entity);
 
response = httpClient.execute(httpPost);
 
entityResponse = response.getEntity();
 
return_api = Core
 
.convertStreamToString(entityResponse.getContent());
 
Log.i(TAG, "received: " + return_api);
 
return return_api;
 
}
 
}
 
</pre>
 
 
==Futuro del API.php==
 
Algunas ideas para el futuro del api.php son:
 
 
* Ampliar el conjunto de llamadas del API.
 
* Devolver y recoger valores en xml, json...
 
* Aumentar las securización de las llamadas para entornos inseguros.
 
* Integrar con estándares de terceras herramientas.
 
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
 
 
[[Category: Pandora FMS]]
 

Revision as of 03:41, 11 September 2019

Volver a Indice de Documentacion Pandora FMS

Contents

1 API Externa de Pandora FMS

La API externa de Pandora FMS se utiliza haciendo llamadas remotas (via HTTP) sobre el fichero /include/api.php. Este es el método que se ha definido en Pandora FMS para integrar aplicaciones de terceros con Pandora FMS. Básicamente consiste en un llamada con los parámetros formateados para recibir un valor o una lista de valores que después su aplicación usará para realizar operaciones.

Una llamada al API.php es tan fácil como:

http://<instalación Pandora Console>/include/api.php<parametros>

El API sólo puede recibir los siguientes parámetros:

  • op (obligatorio): es el primer parámetro. Especifica la naturaleza de la operación que puede ser "get" o "set" o "help:
  • get: devuelve un valor o valores
  • set: envía un valor o valores
  • help: devuelve una pequeña ayuda de las llamadas
  • op2 (obligatorio): la llamada en sí con un nombre explicativo de sobre que actua.
  • id (opcional): primer parámetro de la llamada.
  • id2 (opcional): segundo parámetro de la llamada.
  • other (opcional): tercer parámetro de la llamada, algunas veces puede ser un lista de valores serializados.
  • other_mode (opcional): formato de la serialización. Lista de valores posibles:
  • url_encode: el valor de other es un alfanumérico formateado como UrlEncode.
  • url_encode_separator_<separador>: el valor sera una lista de valores serializados con el carácter separador por ejemplo
...other=peras|melones|sandias&other_mode=url_encode_separator_|
  • returnType (opcional): formato de retorno del valor o valores. Los valores disponibles actuales son:
  • string: devuelve el valor tal cual como un alfanumérico.
  • csv: devuelve los valores como un CSV separado por defecto con el carácter ";" los campos, y separados con retornos de carro las filas.
  • csv_head: devuelve, igual que con "csv", salvo que añade una primera fila con los nombres de los campos a retornar.

1.1 Seguridad

Actualmente, la seguridad se basa en una lista de IPs que tendrán acceso a la herramienta. Y se podrá configurar como se ve en la imagen, en las opciones de configuración de Pandora Console.

Si se introduce en la caja de texto el carácter * se omite la comprobación de ACL relegando la seguridad al protocolo y al entorno.



Screnshot of api acl list setup.png



También se puede establecer una password para realizar las acciones del API.

Para establecer la password hay que seguir los siguientes pasos:

  • apipass: Password del API que se configura desde la consola. Desde la siguiente vista de configuración (Administration>Setup>):


Api password.png



Nota: Antes de la versión 4.0.2, este parámetro era pass

Para acceder a las acciones de la API, también es necesario proporcionar un usuario y password válidos en el sistema Pandora FMS.

  • user: Usuario de Pandora FMS válido
  • pass: La contraseña del usuario proporcionado

Nota: Las llamadas a la API llevan las contraseñas sin codificar. Por lo que se debería tener cuidado y emplear conexiones SSL para evitar que se puedan ver en la red. La API admite peticiones via POST para poder cifrarlas cuando se usa SSL/HTTPS.

1.1.1 Retorno

Cuando la API denega el acceso, será devuelta una simple cadena de texto "auth error".

1.1.2 Ejemplos

En este caso, se está utilizando la password del API 1234 y se está accediendo con el usuario admin y la password pandora.

http://127.0.0.1/pandora_console/include/api.php?op=get&op2=plugins&return_type=csv&other=;&apipass=1234&user=admin&pass=pandora

Condiciones de acceso:

  • La IP de origen está en la lista de ACLs
  • La password de la API no está establecida o es 1234
  • El usuario admin existe y su password es pandora

1.1.3 Workflow del sistema de seguridad

A partir de la versión 4.0.2, la API tiene algunas mejoras en el manejo de la seguridad. Esto se implementa ahora gracias a tres elementos:

  • Filtrado IP. Sólo las IP's listadas podrán acceder a la API.
  • Password global para la API, si se define, es obligatorio usarla en todas las llamadas.
  • Usuario y password válido en la consola. Se utilizarán sus permisos para cada operación solicitada.

Esto se explica en el siguiente workflow:



API access.svg



1.2 Extensión de nuevas llamadas en el API

Para desarrollar nuevas llamadas para el API tiene que tener en cuenta que:

  • La llamada tiene que estar inscrita como una función en el fichero <instalación Pandora Console>/include/functions_api.php .
  • La función tendrá la siguiente estructura: El prefijo "api", el tipo de llamada "get", "set" o "help" (según si se leen datos, se escriben datos o se obtiene ayuda) y el nombre de la llamada, intentando ser coherente con la operación, por ejemplo: function api_get_[nombre_llamada](parametros) .
  • La función puede no tener parámetros, pero si los tiene, los parámetros recibidos serán los siguientes y en el mismo orden:
  • id: primer operador o parámetro, contiene un string.
  • id2: segundo operador o parámetro, contiene un string.
  • other: resto de operadores o parámetros, contenido como un array de dos posiciones:
  • $other['type']: que puede ser string o array.
  • $other['data']: que será un string con el parámetro o un array de índices numéricos con los parámetros pasados.
  • returnType: string que especifica el tipo de retorno que tendrá la llamada. En principio es transparente para usted, pero puede usarlo o modificarlo si fuese necesario.

1.2.1 Nuevas llamadas en el API desde las extensiones de Pandora FMS

Es posible crear nuevas llamadas del API sin utilizar /include/functions_api.php. La forma de hacerlo es añadiendo en el directorio de una extensión de Pandora FMS un fichero con el siguiente nombre: <nombre_de_la_extension>.api.php y dentro de este fichero crear las funciones deseadas con las mismas consideraciones de la API estándar pero con el prefijo "apiextension" en lugar de "api".


Por ejemplo, teniendo una extensión llamada "module_groups" con la ruta <instalación de Pandora>/extensions/module_groups debemos crear un fichero llamado module_groups.api.php en este directorio.


En este fichero estarán las funciones deseadas, por ejemplo una función para obtener el número de módulos de un grupo. Esta función debe tener un nombre parecido a: "apiextension_get_groupmodules".

1.2.1.1 Ejemplo de función

En esta función se han usado funciones imaginarias.

function apiextension_get_groupmodules($group_name) {
    $group_id = group_id_from_name($group_name);
    if($group_id == false) {
       echo 'Group doesnt exist';
       return;
    }

    $number_of_modules = group_modules($group_id);
    echo $number_of_modules;
}

1.2.1.2 Ejemplo de llamada

En esta llamada se obtiene el número de módulos del grupo "Servers"

http://127.0.0.1/pandora_console/include/api.php?op=get&op2=extension&ext_name=module_groups&ext_function=groupmodules&id=Servers&apipass=1234&user=admin&pass=pandora

1.2.2 Funciones API

Las siguientes funciones las puede usar en el código de la función de su llamada :

  • returnError(typeError, returnType): devuelve un error de manera uniforme para todas las llamadas.
  • typeError: de momento 'id_not_found' o null.
  • returnType: de momento 'string' o mensaje de error.
  • returnData(returnType, data, separator): es la función que retorna los datos de la llamada del API.
  • returnType: que puede ser 'string', 'csv', 'csv_head'
  • data: es un array que contiene los datos asi como su formato, tiene los siguientes campos:
  • 'type' (obligatorio): que puede ser 'string' y 'array'.
  • 'list_index' (opcional): contiene un array de índices numéricos conteniendo los índices alfanuméricos que se desean sacar por salida.
  • 'data' (obligatorio): contiene o un string con el dato o un array de índice alfanuméricos o numéricos con los datos.

1.2.3 Ejemplo

function api_get_module_last_value($idAgentModule, $trash1, $other = ';', $returnType)
{
	$sql = sprintf('SELECT datos FROM tagente_estado WHERE id_agente_modulo = %d', $idAgentModule);
	$value = get_db_value_sql($sql);
	if ($value === false) {
		switch ($other['type']) {
			case 'string':
				switch ($other['data']) {
					case 'error_message':
					default:
						returnError('id_not_found', $returnType);
					break;
				}
				break;
			case 'array':
				switch ($other['data'][0]) {
					case 'error_value':
						returnData($returnType, array('type' => 'string', 'data' => $other['data'][1]));
						break;
				}
				break;
		}
	}
	else {
		$data = array('type' => 'string', 'data' => $value);
		returnData($returnType, $data);
	}
}

1.3 Llamadas al API

Se dividen en dos grupos según si devuelven o escriben datos en Pandora FMS.

Existe una excepción: La llamada de retorno de información.

1.3.1 RETORNO DE INFORMACIÓN

Devuelve la versión de Pandora Console, de un modo parecido a la función get test pero sin chequear la conexión al API.

Esta llamada es útil para verificar que en esta ruta se encuentra una instalación de Pandora FMS y para obtener la versión antes de la autenticación.

La información que devuelve se puede obtener de la pantalla de login, por lo que no se considera que se vulnere la seguridad.

http://127.0.0.1/pandora_console/include/api.php?info=version

Un ejemplo de respuesta podría ser: Pandora FMS v5.0 - PC131015

1.3.2 GET

Devuelve los datos solicitados.

1.3.2.1 get test

Chequea la conexión al API y devuelve la versión del Pandora Console.


Esta característica está en Metaconsola.


Sintaxis de la llamada: Sin parámetros

1.3.2.1.1 Ejemplos

Este ejemplo devolverá OK,[version],[build]

http://127.0.0.1/pandora_console/include/api.php?op=get&op2=test&apipass=1234&user=admin&pass=pandora

Un ejemplo de respuesta podría ser: OK,v4.0.2,PC120614

1.3.2.2 get all_agents

Devuelve la lista de agentes filtrados por los filtros seteados en other.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=all_agents (obligatorio)
  • return_type= csv o json (obligatorio)
  • other=<parámetros serializados> (opcional) parámetros para filtrar la búsqueda de agentes, serializados:
  • <filter_so>
  • <filter_group>
  • <filter_module_states>
  • <filter_alias>
  • <filter_policy>
  • <csv_separator>
1.3.2.2.1 Ejemplos

Este ejemplo devolverá todos los agentes cuyo id_so sea igual a 1, id_group igual a 2, estado de warning, su alias contenga 'j', y su política asociada tenga id igual a 2.

Ejemplo para CSV: http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_agents&return_type=csv&other=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora
Ejemplo para JSON: http://127.0.0.1/pandora_console/include/api.php?op=get&op2=all_agents&return_type=json&other=1&other_mode=url_encode_separator_%7C&apipass=1234&user=admin&pass=pandora

1.3.2.3 get module_last_value

Devuelve el último valor de un módulo, el cual se selecciona por el ID pasado por el parámetro id. Con el parámetro other puede añadir el código de error para que tu aplicación detecte este valor fuera del rango de valores del módulo.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=module_last_value (obligatorio)
  • id=<índice> (obligatorio) debe ser un índice de un módulo agente.
  • other=<retorno error> (opcional) que quieres que te devuelva si hay un error (no encontrado en DB el módulo normalmente).
  • Códigos de retorno de error son:
  • 'error_message' devuelve error en un mensaje de texto.
  • 'error_value'<separador><código o valor&gt devuelve ese código o valor de error. Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_<separador> para pasar el separador en other.
1.3.2.3.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_last_value&id=63&other=error_value|0&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_last_value&id=62&apipass=1234&user=admin&pass=pandora

1.3.2.4 get agent_module_name_last_value

Devuelve el último valor de un módulo, el cual se selecciona por nombre del agente pasado por el parámetro id y nombre del módulo pasado por el id2. Con el parámetro other puede añadir el código de error para que tu aplicación detecte este valor fuera del rango de valores que puede ser el módulo.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=agent_module_name_last_value (obligatorio)
  • id=<alfanumerico> (obligatorio) contiene el nombre del agente.
  • id2=<alfanumerico> (obligatorio) contiene el nombre del módulo.
  • other=<retorno error> (opcional) que quieres que te devuelva si hay un error (no encontrado en DB el modulo normalmente).
  • Códigos de retorno de error son:
  • 'error_message' devuelve error en un mensaje de texto.
  • 'error_value'<separador><código o valor&gt devuelve ese código o valor de error. Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_<separador> para pasar el separador en other.
1.3.2.4.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agent_module_name_last_value&id=user&id2=cpu_user&apipass=1234&user=admin&pass=pandora

1.3.2.5 get agent_module_name_last_value_alias

>= 7.0NG

Devuelve el último valor de un módulo, el cual se selecciona por alias del agente pasado por el parámetro id y nombre del módulo pasado por el id2. Con el parámetro other puede añadir el código de error para que tu aplicación detecte este valor fuera del rango de valores que puede ser el módulo.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=agent_module_name_last_value_alias (obligatorio)
  • id=<alfanumerico> (obligatorio) contiene el alias del agente.
  • id2=<alfanumerico> (obligatorio) contiene el nombre del modulo.
  • other=<retorno error> (opcional) que quieres que te devuelva si hay un error (no encontrado en DB el módulo normalmente).
  • Códigos de retorno de error son:
  • 'error_message' devuelve error en un mensaje de texto.
  • 'error_value'<separador><código o valor&gt devuelve ese código o valor de error. Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_<separador> para pasar el separador en other.
1.3.2.5.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agent_module_name_last_value_alias&id=pandorafms&id2=Memory_Used&apipass=1234&user=admin&pass=pandora

1.3.2.6 get module_value_all_agents

Devuelve una lista de agentes y el valor para el módulo, este módulo lo tienen todos los agentes y es pasado el nombre como parámetro id.


Síntaxis de la llamada:

  • op=get (obligatorio)
  • op2=module_value_all_agents (obligatorio)
  • id=<name of the module> (obligatorio) contiene el nombre del módulo.
1.3.2.6.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_value_all_agents&id=example_module_name&apipass=1234&user=admin&pass=pandora

1.3.2.7 get agent_modules

Devuelve la lista de módulos de un agente filtrado por el id del agente pasado como parámetro id.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=agent_modules (obligatorio)
  • return_type=<csv> (obligatorio) Formato de salida.
  • other=<valores serializados> (obligatorio) Valores serializados para filtrar la búsqueda de módulos por agente:
  • <id_agent>

Pero es necesario acompañarlo de 'other_mode' tal que así other_mode=url_encode_separator_<separador> para pasar el separador en other.

1.3.2.7.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=agent_modules&return_type=csv&other=14&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora

1.3.2.8 get module_id

Devuelve la id de un módulo concreto de un agente.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=module_id (obligatorio)
  • id= id del agente (obligatorio)
  • other=nombre del modulo (obligatorio)
1.3.2.8.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=module_id&id=5&other=Host%20Alive&apipass=1234&user=admin&pass=pandora

1.3.2.9 get locate_agent

Obtiene el id del servidor donde se encuentra el agente, e imprime todo el resultado como un archivo csv.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=locate_agent (obligatorio)
  • return_type=<csv> (obligatorio) Formato de salida.
  • id=id_agent (obligatorio)
  • other_mode= other_mode=url_encode_separator_<separador&gt (obligatorio)
1.3.2.9.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=locate_agent&return_type=csv&apipass=1234&user=admin&pass=pandora&id=Pepito&other_mode=url_encode_separator_%7C

1.3.2.10 get policies

Devuelve la lista políticas de un agente pasado su id dentro del parámetro other.

Síntaxis de llamada:

  • op=get (obligatorio)
  • op2=policies (obligatorio)
  • return_type=<csv> (obligatorio)
  • other=<valores serializados> (opcional) Parámetros serializados para filtrar la búsqueda de políticas por agente:
  • <id_agent>
1.3.2.10.1 Ejemplos
http://127.0.0.1/pandora_console/include/api.php?op=get&op2=policies&return_type=csv&other=&other_mode=url_encode_separator_|&apipass=1234&user=admin&pass=pandora

1.3.2.11 get tree_agents

Devuelve una completa lista organizada por grupos en el primer nivel, agentes el segundo nivel y módulos el tercer nivel. Esta lista se filtra por el parámetro other.

Sintaxis de la llamada:

  • op=get (obligatorio)
  • op2=tree_agents (obligatorio)
  • return_type=<tipo retorno> (obligatorio) que puede ser 'csv' o 'csv_head'.
  • other=<string o parámetros serializados> (opcional) en este caso puede ser simplemente el separador o una lista de parámetros en orden y separados con el caracter separador, vemos los dos casos:
  • <separador> el separador si del 'csv'
  • <separador csv>|<carácter sustitución de retorno de carro>|<campos 1>,<campos 2>,<campos N> se compondrá de los siguientes parámetros en orden (el carácter '|' de separación se puede especificar en "other_mode"):
  • <separador csv>: separador de los campos en el CSV.
  • <caracter sustitución de retorno de carro>: carácter que sustituirá si encuentra en algún valor devuelto el carácter retorno de carro para evitar la ambigüedad con el uso estándar de retorno de carro para especificar registros/filas en el CSV. Si se pasa un string en other, el carácter sustituto es el espacio en blanco.
  • <campos 1>,<campos 2>,<campos N&gt : los campos a mostrar en el CSV y el orden en que mostrarlos, los posibles campos son:
  • type_row
  • group_id
  • group_name
  • group_parent
  • disabled
  • custom_id
  • group_description
  • group_contact
  • group_other
  • agent_id
  • alias
  • agent_direction
  • agent_comentary
  • agent_id_group
  • agent_last_contant
  • agent_mode
  • agent_interval
  • agent_id_os
  • agent_os_version
  • agent_version
  • agent_last_remote_contact
  • agent_disabled
  • agent_id_parent
  • agent_custom_id
  • agent_server_name
  • agent_cascade_protection
  • agent_name
  • module_id_agent_modulo
  • module_id_agent
  • module_id_module_type
  • module_description
  • module_name
  • module_max
  • module_min
  • module_interval
  • module_tcp_port
  • module_tcp_send
  • module_tcp_rcv
  • module_snmp_community
  • module_snmp_oid
  • module_ip_target
  • module_id_module_group
  • module_flag
  • module_id_module
  • module_disabled
  • module_id_export
  • module_plugin_user
  • module_plugin_pass
  • module_plugin_parameter
  • module_id_plugin
  • module_post_process
  • module_prediction_module
  • module_max_timeout
  • module_custom_id
  • module_history_data
  • module_min_warning
  • module_max_warning
  • module_min_critical
  • module_max_critical
  • module_min_ff_event
  • module_delete_pending
  • module_id_agent_state
  • module_dat