# iconmap.create

### Описание

`объект iconmap.create(объект/массив СоответвияИконок)`

Этот метод позволяет создавать новые соответствия иконок.

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

`(объект/массив)` Создаваемые соответствия иконок.

В дополнение к [стандартным свойствам соответствий
иконок](object#соответствие_иконок), этот метод принимает следующие
параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|**mappings**<br>(требуется)|массив|Создаваемые карты иконок для соответствия иконок.|

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

`(объект)` Возвращает объект, который содержит ID созданных соответствий
иконок под свойством `iconmapids`. Порядок возвращаемых ID совпадает с
порядком переданных соответствий иконок.

### Примеры

#### Создание соответствия иконок

Создание соответствия иконок для отображения разных типов узлов сети.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "iconmap.create",
    "params": {
        "name": "Type icons",
        "default_iconid": "2",
        "mappings": [
            {
                "inventory_link": 1,
                "expression": "server",
                "iconid": "3"
            },
            {
                "inventory_link": 1,
                "expression": "switch",
                "iconid": "4"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "iconmapids": [
            "2"
        ]
    },
    "id": 1
}
```

### Смотрите также

-   [Карта иконок](object#карта_иконок)

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

CIconMap::create() в
*frontends/php/include/classes/api/services/CIconMap.php*.