graphprototype.get

Descripción

integer/array graphprototype.get(object parameters)

El método permite recuperar prototipos de gráficos de acuerdo con los parámetros suministrados.

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

Parámetros

(object) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
discoveryids ID/array Devolver solo los prototipos de gráficos que pertenecen a las reglas de descubrimiento indicadas.
graphids ID/array Devolver solo los prototipos de gráficos con los IDs indicados.
groupids ID/array Devolver solo los prototipos de gráficos que pertenecen a hosts o templates en los grupos de hosts o grupos de templates indicados.
hostids ID/array Devolver solo los prototipos de gráficos que pertenecen a los hosts indicados.
inherited boolean Si se establece en true, devolver solo los prototipos de gráficos heredados de un template.
itemids ID/array Devolver solo los prototipos de gráficos que contienen los prototipos de item indicados.
templated boolean Si se establece en true, devolver solo los prototipos de gráficos que pertenecen a templates.
templateids ID/array Devolver solo los prototipos de gráficos que pertenecen a los templates indicados.
selectDiscoveryData query Devuelve una propiedad discoveryData con los datos del objeto de descubrimiento del prototipo de gráfico. El objeto de descubrimiento del prototipo de gráfico vincula un prototipo de gráfico descubierto con un prototipo de gráfico del que se descubrió.

Tiene las siguientes propiedades:
parent_graphid - (ID) ID del prototipo de gráfico a partir del cual se ha creado el gráfico;
status - (int) estado de descubrimiento del gráfico:
0 - (por defecto) el prototipo de gráfico está descubierto,
1 - el prototipo de gráfico ya no está descubierto;
ts_delete - (timestamp) hora en la que se eliminará un prototipo de gráfico que ya no se descubre.
selectDiscoveryRule query Devuelve una propiedad discoveryRule con la regla LLD a la que pertenece el prototipo de gráfico.
selectDiscoveryRulePrototype query Devuelve una propiedad discoveryRulePrototype con el prototipo de regla LLD principal al que pertenece el prototipo de gráfico.
selectGraphItems query Devuelve una propiedad gitems con los items de gráfico utilizados en el prototipo de gráfico.
selectHostGroups query Devuelve una propiedad hostgroups con los grupos de hosts a los que pertenece el prototipo de gráfico.
selectHosts query Devuelve una propiedad hosts con los hosts a los que pertenece el prototipo de gráfico.
selectItems query Devuelve una propiedad items con los items y prototipos de item utilizados en el prototipo de gráfico.
selectTemplateGroups query Devuelve una propiedad templategroups con los grupos de templates a los que pertenece el prototipo de gráfico.
selectTemplates query Devuelve una propiedad templates con los templates a los que pertenece el prototipo de gráfico.
filter object Devuelve solo aquellos resultados que coincidan exactamente con el filtro dado.

Acepta un objeto, donde las claves son nombres de propiedades y los valores son un único valor o un array de valores con los que comparar.

No admite propiedades del tipo de dato text data type.

Admite propiedades adicionales:
host - nombre técnico del host al que pertenece el prototipo de gráfico;
hostid - ID del host al que pertenece el prototipo de gráfico.
sortfield string/array Ordena el resultado por las propiedades indicadas.

Valores posibles: graphid, name, graphtype, discovered.
countOutput boolean Estos parámetros se describen en el comentario de referencia.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valores de retorno

(entero/matriz) Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperar prototipos de gráficos de una regla LLD

Recuperar todos los prototipos de gráficos de una regla LLD.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "graphprototype.get",
    "params": {
        "output": "extend",
        "discoveryids": "27426"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "graphid": "1017",
            "name": "Uso de espacio en disco {#FSNAME}",
            "width": "600",
            "height": "340",
            "yaxismin": "0.0000",
            "yaxismax": "0.0000",
            "templateid": "442",
            "show_work_period": "0",
            "show_triggers": "0",
            "graphtype": "2",
            "show_legend": "1",
            "show_3d": "1",
            "percent_left": "0.0000",
            "percent_right": "0.0000",
            "ymin_type": "0",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "discover": "0"
        }
    ],
    "id": 1
}

Ver también

Fuente

CGraphPrototype::get() en ui/include/classes/api/services/CGraphPrototype.php.