值映射对象

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

值映射

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

属性 类型 描述
valuemapid ID 值映射的 ID。

属性行为
- 只读
- 更新操作时为必填
hostid ID 值映射所属主机或模板的 ID。

属性行为
- 常量
- 创建操作时为必填
name string 值映射的名称。

属性行为
- 创建操作时为必填
mappings array 当前值映射的值映射关系。映射对象的详细说明见下文

属性行为
- 创建操作时为必填
uuid string 通用唯一标识符,用于将导入的值映射关联到已存在的值映射。如果未提供,则自动生成。

属性行为
- 如果值映射属于模板,则支持

值映射

值映射对象定义了值映射中的值映射规则。它具有以下属性。

属性 类型 说明
type integer 映射匹配类型。

可能的值:
0 - (默认) 当值相等时应用映射;
1 - 当值大于或等于时应用映射1
2 - 当值小于或等于时应用映射1
3 - 当值在范围内时应用映射(范围包含边界;可定义多个范围,范围之间用逗号分隔)1
4 - 当值匹配正则表达式时应用映射2
5 - 如果未找到匹配项,则不应用映射,并使用默认值。

如果将 type 设置为 "0"、"1"、"2"、"3"、"4",则 value 不能为空。

如果将 type 设置为 "5",则 value 必须为空。
value string 原始值。

属性行为
- 当 type 设置为 "1"、"2"、"3"、"4" 时,必需
- 当 type 设置为 "5" 时,支持
newvalue string 原始值将被映射为的值。

属性行为
- 必需

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