[comment]: # aside: 1

[comment]: # ({ee2c7113-41154bde})
# Объект карты значений

Следующие объекты напрямую связаны с API `valuemap`.

[comment]: # ({/ee2c7113-41154bde})

[comment]: # ({aec7b0d0-65471f47})
### Карта значений

Объект карты значений имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|valuemapid|ID|ID карты значений.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*<br>- *обязательно* для операций обновления|
|hostid|ID|ID узла сети или шаблона, которому принадлежит карта значений.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *константа*<br>- *обязательно* для операций создания|
|name|string|Имя карты значений.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|mappings|array|Сопоставления значений для текущей карты значений. Объект сопоставления [подробно описан ниже](object#value-mappings).<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|uuid|string|Универсальный уникальный идентификатор, используемый для связывания импортированных карт значений с уже существующими. Если не указан, генерируется автоматически.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *поддерживается*, если карта значений принадлежит шаблону|

[comment]: # ({/aec7b0d0-65471f47})

[comment]: # ({5ff6d41b-145a9918})
#### Сопоставления значений

Объект сопоставлений значений определяет сопоставления значений карты значений. Он
имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Тип сопоставления совпадения.<br><br>Возможные значения:<br>0 - *(по умолчанию)* сопоставление будет применено, если значение равно;<br>1 - сопоставление будет применено, если значение больше или равно^1^;<br>2 - сопоставление будет применено, если значение меньше или равно^1^;<br>3 - сопоставление будет применено, если значение находится в диапазоне (диапазоны включительны; можно задать несколько диапазонов, разделенных символом запятой)^1^;<br>4 - сопоставление будет применено, если значение соответствует регулярному выражению^2^;<br>5 - если совпадения не найдены, сопоставление не будет применено, и будет использовано значение по умолчанию.<br><br>Если `type` установлено в "0", "1", "2", "3", "4", то `value` не может быть пустым.<br><br>Если `type` установлено в "5", то `value` должно быть пустым.|
|value|string|Исходное значение.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* если `type` установлено в "1", "2", "3", "4"<br>- *поддерживается* если `type` установлено в "5"|
|newvalue|string|Значение, на которое сопоставляется исходное значение.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*|

^1^ поддерживается только для элементов данных с типом значения "numeric unsigned", "numeric float".<br>
^2^ поддерживается только для элементов данных с типом значения "character".<br>

[comment]: # ({/5ff6d41b-145a9918})