[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({ee2c7113-41154bde})
# 值映射对象

以下对象与 `valuemap` API 直接相关。

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

[comment]: # ({562fa6e6-65471f47})
### 值映射

值映射对象具有以下属性。

|属性|[类型](/manual/api/reference_commentary#data_types)|说明|
|--|--|------|
|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]: # ({/562fa6e6-65471f47})

[comment]: # ({46223286-145a9918})
### 值映射

值映射对象定义值映射的值映射。具有以下属性。

|属性|[类型](/manual/api/reference_commentary#data_types)|说明|
|--|--|------|
|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^ 仅支持值类型为“无符号数字”、“浮点数字”的项目。\

^2^ 仅支持值类型为“字符”的项目。\

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