graphprototype.get

Descripción

integer/array graphprototype.get(object parameters)

El método permite recuperar prototipos de gráficos según los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener 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 dadas.
graphids ID/array Devolver solo los prototipos de gráficos con los IDs dados.
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 dados.
hostids ID/array Devolver solo los prototipos de gráficos que pertenecen a los hosts dados.
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 dados.
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 dados.
selectDiscoveryData query Devolver 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 del que 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 Devolver una propiedad discoveryRule con la regla LLD a la que pertenece el prototipo de gráfico.
selectDiscoveryRulePrototype query Devolver una propiedad discoveryRulePrototype con el prototipo de regla LLD principal al que pertenece el prototipo de gráfico.
selectGraphItems query Devolver una propiedad gitems con los items de gráfico utilizados en el prototipo de gráfico.
selectHostGroups query Devolver una propiedad hostgroups con los grupos de hosts a los que pertenece el prototipo de gráfico.
selectHosts query Devolver una propiedad hosts con los hosts a los que pertenece el prototipo de gráfico.
selectItems query Devolver una propiedad items con los items y prototipos de item utilizados en el prototipo de gráfico.
selectTemplateGroups query Devolver una propiedad templategroups con los grupos de templates a los que pertenece el prototipo de gráfico.
selectTemplates query Devolver una propiedad templates con los templates a los que pertenece el prototipo de gráfico.
filter object Devolver 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 Ordenar el resultado por las propiedades dadas.

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/array) Devuelve:

  • un array de objetos;
  • el número de objetos recuperados, si se ha utilizado el parámetro countOutput.

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": "Disk space usage {#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",
            "flags": "2"
            "discover": "0"
        }
    ],
    "id": 1
}

Ver también

Fuente

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