[comment]: # ({30b4a228-30b4a228})
# dservice.get

[comment]: # ({/30b4a228-30b4a228})

[comment]: # ({93275110-84c200be})
### Descripció

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

El mètode permet recuperar serveis descoberts 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]: # ({/93275110-84c200be})

[comment]: # ({bc4bd8fa-cdd07a5d})
### Paràmetres

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

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

|Paràmatre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció|
|--|--|------|
|dserviceids|ID/array|Retorna només els serveis descoberts amb els IDs donats.|
|dhostids|ID/array|Retorna només els serveis descoberts que pertanyen als equips descoberts demanats.|
|dcheckids|ID/array|Retorna només els serveis descoberts que han estat detectats pels tests de descoberta donats.|
|druleids|ID/array|Retorna només els serveis descoberts creats per les regles de descoberta donats.|
|selectDRules|query|Retorna una propietat [`drules`](/manual/api/reference/drule/object) amb una taula de les regles de descoberta que han detectat el servei.|
|selectDHosts|query|Retorna una propietat [`dhosts`](/manual/api/reference/dhost/object) amb una taula dels equips descoberts als qui pertany el servei.|
|selectHosts|query|Retorna una propietat [`hosts`](/manual/api/reference/host/object) amb els equips que tenen la mateixa adreça IP i el mateix proxy que el servei.<br><br>Admet `count`.|
|limitSelects|integer|Limita el nombre d'enregistraments retornats per les sub-seleccions.<br><br>Aplica a les sub-seleccions següents:<br>`selectHosts` - el resultat s'endreçarà per `hostid`.|
|sortfield|string/array|Ordena el resultat per les propietats proporcionades.<br><br>Els valors possibles són:`dserviceid`, `dhostid` i `ip`.|
|countOutput|boolean|Aquests paràmetres són descrits als [comentaris de referència](/manual/api/reference_commentary#common-get-method-parameters).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/bc4bd8fa-cdd07a5d})

[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]: # ({b65bc2ec-09e9b2a3})
#### Recuperar els serveis descoberts d'un equip

Recuperar tots els serveis descoberts de l'equip "11".

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

```json
{
    "jsonrpc": "2.0",
    "method": "dservice.get",
    "params": {
        "output": "extend",
        "dhostids": "11"
    },
    "id": 1
}
```

Resposta:

```json
{
"jsonrpc": "2.0",
"result": [
{
"dserviceid": "12",
"dhostid": "11",
"value": "",
"port": "80",
"status": "1",
"lastup": "0",
"lastdown": "1348650607",
"dcheckid": "5",
"ip": "192.168.1.134",
"dns": "john.local"
},
{
"dserviceid": "13",
"dhostid": "11",
"value": "",
"port": "21",
"status": "1",
"lastup": "0",
"lastdown": "1348650610",
"dcheckid": "6",
"ip": "192.168.1.134",
"dns": "john.local"
}
],
"id": 1
}
```

[comment]: # ({/b65bc2ec-09e9b2a3})

[comment]: # ({6c01021b-2647a177})
### Veieu també

-   [Equip trobat](/manual/api/reference/dhost/object#discovered-host)
-   [Test de descoberta](/manual/api/reference/dcheck/object#discovery-check)
-   [Equip](/manual/api/reference/host/object#host)

[comment]: # ({/6c01021b-2647a177})

[comment]: # ({76ef9e21-76ef9e21})
### Font

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

[comment]: # ({/76ef9e21-76ef9e21})