# valuemap.create

### Описание

`объект valuemap.create(объект/массив преобразованиязначений)`

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

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

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

Этот метод принимает преобразования значений со [стандартными свойствами
преобразования значений](object#преобразование_значений).

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

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

### Примеры

#### Создание преобразования значений

Создание одного преобразования значений с двумя соответствиями.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "valuemap.create",
    "params": {
        "name": "Service state",
        "mappings": [
            {
                "value": "0",
                "newvalue": "Down"
            },
            {
                "value": "1",
                "newvalue": "Up"
            }
        ]
    },
    "auth": "57562fd409b3b3b9a4d916d45207bbcb",
    "id": 1
}
```

Ответ:

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

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

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