[comment]: # translation:outdated

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

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

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

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

Deze methode maakt het mogelijk om services op te halen volgens de opgegeven parameters.

::: noteclassic
Deze methode is beschikbaar voor gebruikers van elk type. Rechten om
de methode op te roepen kunnen worden ingetrokken in de instellingen
van gebruikersrollen. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles)
voor meer informatie.
:::

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

[comment]: # ({cccc9cb9-e7637a1d})
### Parameters

`(object)` Parameters die de gewenste output definiëren.

De methode ondersteunt de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|serviceids|string/array|Geef alleen services terug met de opgegeven ID's.|
|parentids|string/array|Geef alleen services terug die gekoppeld zijn aan de opgegeven ouder services.|
|deep\_parentids|flag|Geef alle directe en indirecte kind services terug. Samen met `parentids` gebruikt.|
|childids|string/array|Geef alleen services terug die gekoppeld zijn aan de opgegeven kind services.|
|evaltype|integer|Regels voor tag-zoeken.<br><br>Mogelijke waarden:<br>0 - *(standaard)* And/Or;<br>2 - Or.|
|tags|object/array|Geef alleen services terug met gegeven tags. Exacte match op tag en hoofdlettergevoelige of niet-hoofdlettergevoelige zoekopdracht op tag-waarde afhankelijk van de operatorwaarde.<br>Formaat: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Een lege array geeft alle services terug.<br><br>Mogelijke operatorwaarden:<br>0 - *(standaard)* Bevat;<br>1 - Is gelijk aan;<br>2 - Bevat niet;<br>3 - Is niet gelijk aan;<br>4 - Bestaat;<br>5 - Bestaat niet.|
|problem\_tags|object/array|Geef alleen services terug met gegeven probleemtags. Exacte match op tag en hoofdlettergevoelige of niet-hoofdlettergevoelige zoekopdracht op tag-waarde afhankelijk van de operatorwaarde.<br>Formaat: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Een lege array geeft alle services terug.<br><br>Mogelijke operatorwaarden:<br>0 - *(standaard)* Bevat;<br>1 - Is gelijk aan;<br>2 - Bevat niet;<br>3 - Is niet gelijk aan;<br>4 - Bestaat;<br>5 - Bestaat niet.|
|without\_problem\_tags|flag|Geef alleen services terug zonder probleemtags.|
|slaids|string/array|Geef alleen services terug die gekoppeld zijn aan specifieke SLA('s).|
|selectChildren|query|Geef een eigenschap `children` terug met de kind services.<br><br>Ondersteunt `count`.|
|selectParents|query|Geef een eigenschap `parents` terug met de ouder services.<br><br>Ondersteunt `count`.|
|selectTags|query|Geef een [`tags`](/manual/api/reference/service/object#service_tag) eigenschap terug met service tags.<br><br>Ondersteunt `count`.|
|selectProblemEvents|query|Geef een eigenschap `problem_events` terug met een array van probleemgebeurtenisobjecten.<br><br>Het probleemgebeurtenisobject heeft de volgende eigenschappen:<br>`eventid` - `(string)` Gebeurtenis-ID;<br>`severity` - `(string)` Huidige ernst van de gebeurtenis;<br>`name` - `(string)` Naam van opgeloste gebeurtenis.<br><br>Ondersteunt `count`.|
|selectProblemTags|query|Geef een [`problem_tags`](/manual/api/reference/service/object#problem_tag) eigenschap terug met probleemtags.<br><br>Ondersteunt `count`.|
|selectStatusRules|query|Geef een [`status_rules`](/manual/api/reference/service/object#status_rule) eigenschap terug met statusregels.<br><br>Ondersteunt `count`.|
|selectStatusTimeline|object/array|Geef een `status_timeline` eigenschap terug met service-statuswijzigingen voor opgegeven periodes.<br><br>Formaat `[{"period_from": "<period_from>", "period_to": "<period_to>"}, ...]` - `period_from` is een startdatum (inclusief; integer timestamp) en `period_to` is een einddatum (exclusief; integer timestamp) voor de periode waarin je geïnteresseerd bent.<br><br>Geeft een array van items terug met een `start_value` eigenschap en een [alarms](/manual/api/reference/service/object#service-alarm) array voor de statuswijzigingen binnen opgegeven periodes.|
|sortfield|string/array|Sorteer het resultaat op de opgegeven eigenschappen.<br><br>Mogelijke waarden: `serviceid`, `name`, `status`, `sortorder`, `created_at`.|
|countOutput|boolean|Deze parameters die gemeenschappelijk zijn voor alle `get` methoden worden in detail beschreven in het [referentiecommentaar](/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]: # ({/cccc9cb9-e7637a1d})

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

`(integer/array)` Retourneert ofwel:

- een reeks objecten;
- het aantal opgehaalde objecten, als de `countOutput` parameter heeft
    gebruikt.

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

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

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

[comment]: # ({70117b93-cd4e4011})
#### Alle services ophalen

Haal alle gegevens op over alle services en hun afhankelijkheden.

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

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

Reactie:

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

[comment]: # ({/70117b93-cd4e4011})

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

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

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