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 Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para más información.

Parámetros

(objeto/array) 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 array Operaciones de correlación a crear para la correlación.

Comportamiento del parámetro:
- obligatorio
filter object Objeto filtro de correlación para la correlación.

Comportamiento del parámetro:
- obligatorio

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de las correlaciones creadas bajo la propiedad correlationids. El orden de los IDs devueltos coincide con el orden de las correlaciones enviadas.

Ejemplos

Crear una nueva correlación de etiquetas de evento

Cree una correlación utilizando el método de evaluación AND/OR con una condición y una operación. Por defecto, 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
            }
        ]
    },
    "id": 1
}

Respuesta:

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

Usar un filtro de expresión personalizada

Cree una correlación que utilice una condición de filtro personalizada. Los IDs 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": "nueva correlación de grupo de equipos",
        "description": "una descripción personalizada",
        "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
            }
        ]
    },
    "id": 1
}

Respuesta:

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

Véase también

Fuente

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