[comment]: # translation:outdated

[comment]: # ({31d5554a-31d5554a})
# hostprototype.get

[comment]: # ({/31d5554a-31d5554a})

[comment]: # ({d1534f8a-d1534f8a})
### Descripción

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

El método permite recuperar prototipos de host de acuerdo con los parámetros
dados.

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Permisos
para activar el método se puede revocar en los ajustes de roles de usuario. Ver [User
roles](/manual/web_interface/frontend_sections/administration/user_roles)
para más información.
:::

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

[comment]: # ({a3e88680-0d6ab1f2})
### 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#tipos_de_datos)|Descripción|
|--|--|------|
|hostids|cadena/matriz|Devuelve sólo prototipos de host con los ID proporcionados.|
|discoveryids|cadena/matriz|Devuelve solo el prototipo de host que pertenece a las reglas LLD dadas.|
|heredado|booleano|Si se establece en "verdadero", devuelve solo los elementos heredados de una template.|
|selectDiscoveryRule|consulta|Devuelve una propiedad [discoveryRule](/manual/api/reference/discoveryrule/object#regla_lld) con la regla LLD a la que pertenece el prototipo de host.|
|selectInterfaces|consulta|Devuelve una propiedad [interfaces](/manual/api/reference/hostprototype/object#interfaz_personalizada) con interfaces personalizadas de prototipo de host.|
|selectGroupLinks|consulta|Devuelve una propiedad [groupLinks](/manual/api/reference/hostprototype/object#enlace_de_grupo) con los enlaces de grupo del prototipo de host.|
|selectGroupPrototypes|consulta|Devuelve una propiedad [groupPrototypes](/manual/api/reference/hostprototype/object#prototipo_de_grupo) con los prototipos de grupo del prototipo de host.|
|selectMacros|consulta|Devuelve una propiedad [macros](/manual/api/reference/usermacro/object) con macros de prototipo de host.|
|selectParentHost|consulta|Devuelve una propiedad [parentHost](/manual/api/reference/host/object) con el host al que pertenece el prototipo de host.|
|selectTags|consulta|Devuelve una propiedad [tags](/manual/api/reference/hostprototype/object#etiqueta_de_prototipo_de_host) con etiquetas de prototipo de host.|
|selectTemplates|consulta|Devuelve una propiedad [templates](/manual/api/reference/template/object) con las templates vinculadas al prototipo del host.<br><br>Admite `count`.|
|sortfield|cadena/matriz|Ordena el resultado por las propiedades dadas.<br><br>Los valores posibles son: `hostid`, `host`, `name` y `status`.|
|countOutput|booleano|Estos parámetros, que son comunes para todos los métodos `get`, se describen en detalle en el [reference commentary](/manual/api/reference_commentary#parametros_comunes_demetodo_get).|
|editable|booleano|^|
|excluirBuscar|booleano|^|
|filtro|objeto|^|
|límite|entero|^|
|salida|consulta|^|
|preservekeys|booleano|^|
|buscar|objeto|^|
|searchByAny|booleano|^|
|searchWildcardsEnabled|booleano|^|
|clasificación|cadena/matriz|^|
|iniciarBuscar|booleano|^|

[comment]: # ({/a3e88680-0d6ab1f2})

[comment]: # ({7223bab1-7223bab1})
### Valores de devueltos

`(integer/array)` Devuelve:

-   una matriz de objetos;
-   la suma de los objetos devueltos, si el parámetros `countOutput` está 
    siendo usado

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

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

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

[comment]: # ({bebba1b3-a91c8b17})
#### Recuperando prototipos de host de una regla LLD  

Retcupere todos los prototipos de host, sus enlaces de grupo, prototipos de grupos y 
etiquetas de una regla LLD.

Solicitud:

```json
{
"jsonrpc": "2.0",
"method": "hostprototype.get",
"params": {
"output": "extend",
"selectInterfaces": "extend",
"selectGroupLinks": "extend",
"selectGroupPrototypes": "extend",
"selectTags": "extend",
"discoveryids": "23554"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```

Respuesta:

```json
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10092",
"host": "{#HV.UUID}",
"name": "{#HV.UUID}",
"status": "0",
"templateid": "0",
"discover": "0",
"custom_interfaces": "1",
"inventory_mode": "-1",
"groupLinks": [
{
"group_prototypeid": "4",
"hostid": "10092",
"groupid": "7",
"templateid": "0"
}
],
"groupPrototypes": [
{
"group_prototypeid": "7",
"hostid": "10092",
"name": "{#CLUSTER.NAME}",
"templateid": "0"
}
],
"tags": [
{
"tag": "Datacenter",
"value": "{#DATACENTER.NAME}"
},
{
"tag": "Instance type",
"value": "{#INSTANCE_TYPE}"
}
],
"interfaces": [
{
"main": "1",
"type": "2",
"useip": "1",
"ip": "127.0.0.1",
"dns": "",
"port": "161",
"details": {
"version": "2",
"bulk": "1",
"community": "{$SNMP_COMMUNITY}"
}
}
]
}
],
"id": 1
}
```

[comment]: # ({/bebba1b3-a91c8b17})

[comment]: # ({749ec170-749ec170})
### Ver también

- [Group link](object#enlace_de_grupo)
- [Group prototype](object#prototipo_de_grupo)
- [User
macro](/manual/api/reference/usermacro/object#template_de_host_nivel_macro)

[comment]: # ({/749ec170-749ec170})

[comment]: # ({437ab274-437ab274})
### Fuente


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

[comment]: # ({/437ab274-437ab274})