correlation.create

Descripción

object correlation.create(object/array correlations)

Este método permite crear nuevas correlaciones.

Este método solo está disponible para el tipo de usuario Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver User roles para más información.

Parámetros

(objeto/matriz) Correlaciones a crear.

Además de las propiedades estándar de correlación, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
operations
(obligatoria)
matriz Operaciones de correlación para crear para la correlación.
filter
(obligatorio)
objeto Objeto de filtro de correlación para la correlación.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de las correlaciones creadas bajo la propiedad correlationids. El orden de los ID devueltos coinciden con el orden de las correlaciones pasadas.

Ejemplos

Crear una nueva correlación de etiqueta de evento

Cree una correlación utilizando el método de evaluación "Y/O" con una condición y una operación. De forma predeterminada, la correlación estará habilitada.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "correlation.create",
           "params": {
               "name": "new event tag correlation",
               "filter": {
                   "evaltype": 0,
                   "conditions": [
                       {
                           "type": 1,
                           "tag": "ok"
                       }
                   ]
               },
               "operations": [
                   {
                       "type": 0
                   }
               ]
           },
           "auth": "343baad4f88b4106b9b5961e77437688",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "correlationids": [
                   "1"
               ]
           },
           "id": 1
       }

Usando un filtro de expresión personalizado

Cree una correlación que utilizará una condición de filtro personalizada. Los ID de fórmula "A" o "B" se han elegido arbitrariamente. El tipo de condición será "Grupo de equipos" con el operador "<>".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "correlation.create",
           "params": {
               "name": "new host group correlation",
               "description": "a custom description",
               "status": 0,
               "filter": {
                   "evaltype": 3,
                   "formula": "A or B",
                   "conditions": [
                       {
                           "type": 2,
                           "operator": 1,
                           "formulaid": "A"
                       },
                       {
                           "type": 2,
                           "operator": 1,
                           "formulaid": "B"
                       }
                   ]
               },
               "operations": [
                   {
                       "type": 1
                   }
               ]
           },
           "auth": "343baad4f88b4106b9b5961e77437688",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "correlationids": [
                   "2"
               ]
           },
           "id": 1
       }

Ver también

Fuente

CCorrelation::create() en ui/include/classes/api/services/CCorrelation.php.