值映射 object

以下objects与valuemapAPI直接相关。

值映射

值映射 object 具有以下属性。

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

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

属性行为:
- constant
- 用于 create 操作时为必填
name string 值映射的名称。

属性行为:
- 对于 create 操作是必填
mappings array 当前值映射的值映射。映射 object 为 值映射

属性行为:
- 对于 create 操作为 必填
uuid string 通用唯一标识符,用于将导入的值映射链接到已存在的值映射。若未提供则自动生成。

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

值映射

值映射 object 用于定义值映射的映射规则。它具有以下属性。

属性 数据类型 说明
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" 的情况。