[comment]: # ({6a93039d-6a93039d}) # graphprototype.get [comment]: # ({/6a93039d-6a93039d}) [comment]: # ({aeecab61-27b69e53}) ### Descripción `integer/array graphprototype.get(object parameters)` El método permite recuperar prototipos de gráficos de acuerdo con los parámetros suministrados. ::: noteclassic 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](/manual/web_interface/frontend_sections/users/user_roles) para más información. ::: [comment]: # ({/aeecab61-27b69e53}) [comment]: # ({20b09c9f-de0f74af}) ### Parámetros `(object)` Parámetros que definen la salida deseada. El método admite los siguientes parámetros. |Parámetro|[Tipo](/manual/api/reference_commentary#data-types)|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`](/manual/api/reference/discoveryrule/object#lld-rule) con la regla LLD a la que pertenece el prototipo de gráfico.| |selectDiscoveryRulePrototype|query|Devuelve una propiedad [`discoveryRulePrototype`](/manual/api/reference/discoveryruleprototype/object) con el prototipo de regla LLD principal al que pertenece el prototipo de gráfico.| |selectGraphItems|query|Devuelve una propiedad [`gitems`](/manual/api/reference/graphitem/object) con los items de gráfico utilizados en el prototipo de gráfico.| |selectHostGroups|query|Devuelve una propiedad [`hostgroups`](/manual/api/reference/hostgroup/object) con los grupos de hosts a los que pertenece el prototipo de gráfico.| |selectHosts|query|Devuelve una propiedad [`hosts`](/manual/api/reference/host/object) con los hosts a los que pertenece el prototipo de gráfico.| |selectItems|query|Devuelve una propiedad `items` con los [items](/manual/api/reference/item/object) y [prototipos de item](/manual/api/reference/itemprototype/object) utilizados en el prototipo de gráfico.| |selectTemplateGroups|query|Devuelve una propiedad [`templategroups`](/manual/api/reference/templategroup/object) con los grupos de templates a los que pertenece el prototipo de gráfico.| |selectTemplates|query|Devuelve una propiedad [`templates`](/manual/api/reference/template/object) 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](/manual/api/reference_commentary#data-types).

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](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/20b09c9f-de0f74af}) [comment]: # ({7223bab1-7223bab1}) ### Valores de retorno `(entero/matriz)` Devuelve: - una matriz de objetos; - el recuento de objetos recuperados, si el parámetro `countOutput` ha sido usado. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Ejemplos [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({117a4fa9-62edff03}) #### Recuperar prototipos de gráficos de una regla LLD Recuperar todos los prototipos de gráficos de una regla LLD. [Solicitud](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graphprototype.get", "params": { "output": "extend", "discoveryids": "27426" }, "id": 1 } ``` Respuesta: ```json { "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 } ``` [comment]: # ({/117a4fa9-62edff03}) [comment]: # ({7b8d40e8-e4f96e80}) ### Ver también - [Regla de descubrimiento](/manual/api/reference/discoveryrule/object#discovery-rule) - [Item de gráfico](/manual/api/reference/graphitem/object#graph-item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Grupo de hosts](/manual/api/reference/hostgroup/object#host-group) - [Template](/manual/api/reference/template/object#template) - [Grupo de templates](/manual/api/reference/templategroup/object#template-group) [comment]: # ({/7b8d40e8-e4f96e80}) [comment]: # ({fc80fda8-fc80fda8}) ### Fuente CGraphPrototype::get() en *ui/include/classes/api/services/CGraphPrototype.php*. [comment]: # ({/fc80fda8-fc80fda8})