[comment]: # ({2587902b-2587902b})
# service.get

[comment]: # ({/2587902b-2587902b})

[comment]: # ({8223dd96-bfd5de7f})
### Descripció

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

El mètode permet recuperar serveis 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]: # ({/8223dd96-bfd5de7f})

[comment]: # ({916c982e-e7637a1d})
### Paràmetres

`(objecte)` 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ó|
|--|--|------|
|serviceids|ID/array|Retorna només serveis amb els ID donats.|
|parentids|ID/array|Retorna només els serveis que són enllaçats als serveis pare donats.|
|deep\_parentids|flag|Retorna tots els serveis secundaris directes i indirectes. S'empra juntament amb `parentids`.|
|childids|ID/array|Retorna només els serveis que són enllaçats als serveis secundaris donats.|
|evaltype|enter|Etiqueta del [mètode d'avaluació](/manual/web_interface/frontend_sections/services/service#using-filter).<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.|
|tags|matriu|Retorna només els esdeveniments amb les etiquetes donades. Coincidència exacta per etiqueta i cerca que distingeix entre majúscules i minúscules o no per valor d'etiqueta segons el valor de l'operador.<br>Format: `[{"etiqueta": "<etiqueta>", "valor": "<valor>", "operador": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els esdeveniments.<br><br>Tipus d'operador possibles:<br>0 - (per defecte) Conté (coincidència de subcadena, distingeix entre majúscules i minúscules);<br>1 - Igual a (distingeix entre majúscules i minúscules);<br>2 - No conté (coincidència de subcadena, distingeix entre majúscules i minúscules);<br>3 - No és igual a (distingeix entre majúscules i minúscules);<br>4 - Existeix;<br>5 - No existeix.|
|problem\_tags|objecte/matriu d'objectes|Retorn només serveis amb etiquetes de problema donades. Concordança exacta per etiqueta i cerca que distingeix entre majúscules i majúscules o minúscules per valor de l'etiqueta en funció del valor de l'operador.<br>Format: `[{"tag": "<etiqueta>", "valor": "<valor>", " operator": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els serveis.<br><br>Possibles valors d'operador:<br>0 - *(per defecte)* Conté;<br >1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.|
|without\_problem\_tags|bandera|Retorn només serveis sense etiquetes de problema.|
|slaids|ID/array|Retorna només els serveis que són enllaçats amb els SLA específics.|
|selectChildren|query|Retorna una propietat `fills` amb els serveis secundaris.<br><br>Admet `count`.|
|selectParents|query|Retorna una propietat `parents` amb els serveis parentals.<br><br>Admet `count`.|
|selectTags|query|Retorna una propietat [`tags`](/manual/api/reference/service/object#service-tag) amb etiquetes de servei.<br><br>Admet `count`.|
|selectProblemEvents|query|Retorna una propietat `problem_events` amb una matriu d'objectes d'esdeveniment problema.<br><br>L'objecte d'esdeveniment problema té les propietats següents:<br>`eventid` - `(cadena)` Identificador d'esdeveniment;< br>`gravetat` - `(cadena)` Gravetat de l'esdeveniment actual;<br>`nom` - `(cadena)` Nom de l'esdeveniment resolt.<br><br>Admet `count`.|
|selectProblemTags|query|Retorna una propietat [`problem_tags`](/manual/api/reference/service/object#problem-tag) amb etiquetes de problema.<br><br>Admet `count`.|
|selectStatusRules|query|Retorna una propietat [`status_rules`](/manual/api/reference/service/object#status-rule) amb regles d'estat.<br><br>Admet `count`.|
|selectStatusTimeline|objecte/matriu d'objectes|Retorna una propietat `status_timeline` que conté canvis d'estat del servei per a períodes determinats.<br><br>Format `[{"period_from": "<period_from>", "period_to": "<period_to >"}, ...]` - `period_from` és una data d'inici (inclosa; marca de temps entera) i `period_to` és una data de finalització (exclusiu; marca de temps enter) per al període que t'interessa.<br>< br>Retorna una matriu d'entrades que contenen una propietat `start_value` i una matriu [alarmes](/manual/api/reference/service/object#service-alarm) per als canvis d'estat dins dels períodes especificats.|
|sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Valors possibles: `serviceid`, `name`, `status`, `sortorder`, `created_at`.|
|countOutput|boolean|Aquests paràmetres es descriuen en detall al [comentari de referència](/manual/api/reference_commentary#common-get-method-parameters).|
|editable|booleà|^|
|excludeSearch|booleà|^|
|filter|objecte|^|
|limit|enter|^|
|output|consulta|^|
|preservekeys|boolean|^|
|search|objecte|^|
|searchByAny|booleà|^|
|searchWildcardsEnabled|booleà|^|
|sortorder|cadena/matriu|^|
|startSearch|booleà|^|

[comment]: # ({/916c982e-e7637a1d})

[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]: # ({61781c0a-cd4e4011})
#### Recuperar tots els serveis

Recupera tota la informació de tots els serveis i les seves dependències.

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

```json
{
    "jsonrpc": "2.0",
    "method": "service.get",
    "params": {
        "output": "extend",
        "selectChildren": "extend",
        "selectParents": "extend"
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "serviceid": "1",
            "name": "El meu servei - 0001",
            "status": "-1",
            "algorithm": "2",
            "sortorder": "0",
            "weight": "0",
            "propagation_rule": "0",
            "propagation_value": "0",
            "description": "Descripció del meu servei 0001.",
            "uuid": "dfa4daeaea754e3a95c04d6029182681",
            "created_at": "946684800",
            "readonly": false,
            "parents": [],
            "children": []
        },
        {
            "serviceid": "2",
            "name": "El meu servei - 0002",
            "status": "-1",
            "algorithm": "2",
            "sortorder": "0",
            "weight": "0",
            "propagation_rule": "0",
            "propagation_value": "0",
            "description": "Descripció del meu servei 0002.",
            "uuid": "20ea0d85212841219130abeaca28c065",
            "created_at": "946684800",
            "readonly": false,
            "parents": [],
            "children": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/61781c0a-cd4e4011})

[comment]: # ({05e3cf18-05e3cf18})
### Font

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

[comment]: # ({/05e3cf18-05e3cf18})