值映射 object

以下objects与valuemapAPI直接相关。

值映射

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

Property Type Description
valuemapid ID 值映射的 ID。

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

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

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

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

属性行为:
- 当值映射属于模板时支持

值映射

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

Property Type Description
type integer 映射匹配类型。

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

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

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

Property behavior：
- required 如果 type 设置为 "1"、"2"、"3"、"4"
- supported 如果 type 设置为 "5"
newvalue string 原始值映射到的值。

Property behavior：
- required

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