# service.get

### Описание

`целое число/массив service.get(объект параметры)`

Этот метод позволяет получать услуги IT в соответствии с заданными
параметрами.

### Параметры

`(объект)` Параметры задают желаемый вывод.

Этот метод поддерживает следующие параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|serviceids|строка/массив|Возврат услуг IT только с заданными ID.|
|parentids|строка/массив|Возврат только тех услуг IT, которые имеют заданные жёстко-зависимые родительские услуги IT.|
|childids|строка/массив|Возврат только тех услуг IT, которые имеют заданные жёстко-зависимые дочерние услуги IT.|
|selectParent|запрос|Возврат свойства [parent](/ru/manual/api/reference/service/object#зависимость_услуги) с жёстко связанными родительскими услугами.|
|selectDependencies|запрос|Возврат свойства [dependencies](/ru/manual/api/reference/service/object#зависимость_услуги) с зависимыми дочерними услугами.|
|selectParentDependencies|запрос|Возврат свойства [parentDependencies](/ru/manual/api/reference/service/object#зависимость_услуги) с зависимостями родительских услуг.|
|selectTimes|запрос|Возврат свойства [times](/ru/manual/api/reference/service/object#время_услуги) с временем услуг.|
|selectAlarms|запрос|Возврат свойства [alarms](/ru/manual/api/reference/service/object#тревога_услуги) с тревогами услуг.|
|selectTrigger|запрос|Возврат свойства [trigger](/ru/manual/api/reference/trigger/object) со связанными триггерами.|
|sortfield|строка/массив|Сортировка результата в соответствии с заданными свойствами.<br><br>Возможные значения: `name` и `sortorder`.|
|countOutput|флаг|Эти параметры являются общими для всех методов `get` и они описаны в [справочных комментариях](/ru/manual/api/reference_commentary#общие_параметры_get_метода).|
|editable|логический|^|
|excludeSearch|флаг|^|
|filter|объект|^|
|limit|целое число|^|
|output|запрос|^|
|preservekeys|флаг|^|
|search|объект|^|
|searchByAny|логический|^|
|searchWildcardsEnabled|логический|^|
|sortorder|строка/массив|^|
|startSearch|флаг|^|

### Возвращаемые значения

`(целое число/массив)` Возвращает либо:

-   массив объектов;
-   количество найденных объектов, если используется параметр
    `countOutput`.

### Примеры

#### Получение всех услуг IT

Получение всех данных о всех услугах IT и их зависимостях.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "service.get",
    "params": {
        "output": "extend",
        "selectDependencies": "extend"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": [
        {
            "serviceid": "2",
            "name": "Server 1",
            "status": "0",
            "algorithm": "1",
            "triggerid": "0",
            "showsla": "1",
            "goodsla": "99.9000",
            "sortorder": "0",
            "dependencies": []
        },
        {
            "serviceid": "3",
            "name": "Data center 1",
            "status": "0",
            "algorithm": "1",
            "triggerid": "0",
            "showsla": "1",
            "goodsla": "99.9000",
            "sortorder": "0",
            "dependencies": [
                {
                    "linkid": "11",
                    "serviceupid": "3",
                    "servicedownid": "2",
                    "soft": "0",
                    "sortorder": "0",
                    "serviceid": "2"
                },
                {
                    "linkid": "10",
                    "serviceupid": "3",
                    "servicedownid": "5",
                    "soft": "0",
                    "sortorder": "1",
                    "serviceid": "5"
                }
            ]
        },
        {
            "serviceid": "5",
            "name": "Server 2",
            "status": "0",
            "algorithm": "1",
            "triggerid": "0",
            "showsla": "1",
            "goodsla": "99.9900",
            "sortorder": "1",
            "dependencies": []
        }
    ],
    "id": 1
}
```

### Исходный код

CService::get() в
*frontends/php/include/classes/api/services/CService.php*.