[comment]: # ({6a93039d-6a93039d})
# graphprototype.get

[comment]: # ({/6a93039d-6a93039d})

[comment]: # ({aeecab61-27b69e53})
### Descripció

`integer/array graphprototype.get(object parameters)`

El mètode permet recuperar prototipus de gràfics segons els paràmetres proveïts.

::: noteclassic
Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/aeecab61-27b69e53})

[comment]: # ({f8d53c8c-de0f74af})
### Paràmetres

`(object)` Paràmetres que defineixen la sortida esperada.

El mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|discoveryids|ID/array|Retorna només prototips de gràfics que pertanyen a les regles de descobriment donades.|
|graphids|ID/array|Retorna només prototips de gràfics amb identificadors donats.|
|groupids|ID/array|Retorna només prototips de gràfics que pertanyen als equips dels grups d'equips donats.|
|hostids|ID/array|Retorna només prototips de gràfics que pertanyen als equips donats.|
|inherited|boolean|Si es defineix com a `true`, només retorna els prototips de gràfics heretats d'un model.|
|itemids|string/array|Retorna només prototips de gràfics que contenen els prototips d'elements donats.|
|templated|boolean|Si s'estableix en `true`, només retorna prototips de gràfics que pertanyen a plantilles.|
|templateids|ID/array|Retorna només prototips de gràfics que pertanyen a les plantilles donades.|
|selectDiscoveryRule|query|Retorna una propietat [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) amb la regla LLD a la qual pertany el prototip de gràfic.|
|selectGraphItems|query|Retorna una propietat [gitems](/manual/api/reference/graphitem/object) amb els elements de gràfic emprats al prototip de gràfic.|
|selectGroups|query|Retorna una propietat [groups](/manual/api/reference/hostgroup/object) amb els grups d'equips als quals pertany el prototip de gràfic.|
|selectHosts|query|Retorna una propietat [hosts](/manual/api/reference/host/object) amb els equips als quals pertany el prototip de gràfic.|
|selectItems|query|Retorna una propietat `items` amb els [elements](/manual/api/reference/item/object) i [prototipus d'elements](/manual/api/reference/itemprototype/object) emprats al gràfic del prototip .|
|selectTemplateGroups|query|Retorna una propietat [templategroups](/manual/api/reference/templategroup/object) amb els grups de plantilles a les quals pertany el prototip de gràfic.|
|selectTemplates|query|Retorna una propietat [plantilles](/manual/api/reference/template/object) amb les plantilles a les quals pertany el prototip de gràfic.|
|filter|object|Retorna només resultats que coincideixen exactament amb el filtre donat.<br><br>Accepta una matriu, on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar. <br><br>Admet filtres addicionals:<br>`host` - nom tècnic de l'equip al qual pertany el prototip de gràfic;<br>`hostid` - ID de l'equip al qual pertany el prototip de gràfic.|
|sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `graphid`, `name`, `graphtype` i `discovered`.|
|countOutput|boolean|Aquests paràmetres es descriuen en detall a [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|limit|entier|^|
|output|requête|^|
|preservekeys|boolean|^|
|search|objet|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|
|selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; empreu en el seu lloc `selectHostGroups` o `selectTemplateGroups`.<br>Retorna la propietat `grups` amb els grups d'equips i grups de plantilles on el gràfic pertany.|

[comment]: # ({/f8d53c8c-de0f74af})

[comment]: # ({7223bab1-7223bab1})
### Valors de retorn

`(integer/array)` Retorna un d'entre:

-   una taula d'objectes;
-   el recompte d'objectes recuperats, si s'empra el paràmetre `countOutput`.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({9b08fedb-62edff03})
#### Recuperar prototips de gràfics d'una regla LLD

Recuperar tots els prototips de gràfics d'una regla de descoberta.

[Petició](/manual/api#performing-requests):

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

Resposta:

```json
{
"jsonrpc": "2.0",
"result": [
{
"graphid": "1017",
"parent_itemid": "27426",
"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",
"discover": "0"
}
],
"id": 1
}
```

[comment]: # ({/9b08fedb-62edff03})

[comment]: # ({e4f07557-e4f96e80})
### Veieu també

-   [Regla de descoberta](/manual/api/reference/discoveryrule/object#discovery_rule)
-   [Element de gràfic](/manual/api/reference/graphitem/object#graph_item)
-   [Element](/manual/api/reference/item/object#item)
-   [Equip](/manual/api/reference/host/object#host)
-   [Grup d'equips](/manual/api/reference/hostgroup/object#host_group)
-   [Plantilla](/manual/api/reference/template/object#template)
-   [Grup de plantilles](/manual/api/reference/templategroup/object#template_group)

[comment]: # ({/e4f07557-e4f96e80})

[comment]: # ({fc80fda8-fc80fda8})
### Font

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

[comment]: # ({/fc80fda8-fc80fda8})