值映射对象
以下对象与 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" 的监控项。