[comment]: # translation:outdated

[comment]: # ({41154bde-41154bde})
# 值映射 object

以下objects与`valuemap`API直接相关。

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

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

值映射object具有以下属性。

| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| valuemapid | string | *(只读)* 值映射的ID。 |
| **hostid**<br>(required) | id | 值映射主机或模板ID。 |
| **name**<br>(required) | string | 值映射的名称。 |
| **mappings**<br>(required) | array | 当前值映射的值映射关系。映射object是[值映射](object#值映射)。 |
| uuid | string | 全局唯一标识符，用于将导入的值映射与已存在的值映射关联。仅用于模板上的值映射。如果未提供，则自动生成。 |

请注意，对于某些方法(update, delete)，必需/可选参数的组合是不同的。

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

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

值映射object定义了值映射表的映射关系。它具有以下属性。

| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| type | integer | 映射匹配类型。对于类型0,1,2,3,4，`value`字段不能为空；对于类型5，`value`字段应为空。<br><br>可能取值：<br>0 - (默认)精确匹配；<br>1 - 当值大于或等于时应用映射^1^；<br>2 - 当值小于或等于时应用映射^1^；<br>3 - 当值在范围内时应用映射(范围包含边界)，可定义多个以逗号分隔的范围^1^；<br>4 - 当值匹配正则表达式时应用映射^2^；<br>5 - 默认值，当没有其他匹配时应用此映射。 |
| **value**<br>(required) | string | 原始值。<br><br>对于"default"类型的映射不是必填项。 |
| **newvalue**<br>(required) | string | 原始值映射到的目标值。 |

^1^ 仅支持值类型为"numeric unsigned"、"numeric float"的监控项。\
^2^ 仅支持值类型为"character"的监控项。\

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