以下objects与map
API直接相关。
地图 object 具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
sysmapid | string | (只读) 地图的ID。 |
height (required) |
integer | 地图的高度(像素)。 |
name (required) |
string | 地图的名称。 |
width (required) |
integer | 地图的宽度(像素)。 |
backgroundid | string | 用作地图背景的图片ID。 |
expand_macros | integer | 配置地图时是否在标签中展开宏。 可选值: 0 - (默认) 不展开宏; 1 - 展开宏。 |
expandproblem | integer | 是否对只有一个问题的元素显示问题触发器。 可选值: 0 - 始终显示问题数量; 1 - (默认) 仅当有一个问题时显示问题触发器。 |
grid_align | integer | 是否启用网格对齐。 可选值: 0 - 禁用网格对齐; 1 - (默认) 启用网格对齐。 |
grid_show | integer | 是否在地图上显示网格。 可选值: 0 - 不显示网格; 1 - (默认) 显示网格。 |
grid_size | integer | 地图网格的大小(像素)。 支持的值:20、40、50、75 和 100。 默认值:50。 |
highlight | integer | 是否启用图标高亮。 可选值: 0 - 禁用高亮; 1 - (默认) 启用高亮。 |
iconmapid | string | 地图上使用的图标映射ID。 |
label_format | integer | 是否启用高级标签。 可选值: 0 - (默认) 禁用高级标签; 1 - 启用高级标签。 |
label_location | integer | 地图元素标签的位置。 可选值: 0 - (默认) 底部; 1 - 左侧; 2 - 右侧; 3 - Top。 |
label_string_host | string | 主机 元素的自定义标签。 自定义 主机 标签类型的地图必需。 |
label_string_hostgroup | string | 主机 组元素的自定义标签。 自定义 主机 组标签类型的地图必需。 |
label_string_image | string | 图片元素的自定义标签。 自定义图片标签类型的地图必需。 |
label_string_map | string | 地图元素的自定义标签。 自定义地图标签类型的地图必需。 |
label_string_trigger | string | 触发器元素的自定义标签。 自定义触发器标签类型的地图必需。 |
label_type | integer | 地图元素标签类型。 可选值: 0 - 标签; 1 - IP地址; 2 - (默认) 元素名称; 3 - 仅状态; 4 - 无。 |
label_type_host | integer | 主机 元素的标签类型。 可选值: 0 - 标签; 1 - IP地址; 2 - (默认) 元素名称; 3 - 仅状态; 4 - 无; 5 - 自定义。 |
label_type_hostgroup | integer | 主机 组元素的标签类型。 可选值: 0 - 标签; 2 - (默认) 元素名称; 3 - 仅状态; 4 - 无; 5 - 自定义。 |
label_type_image | integer | 主机 组元素的标签类型。 可选值: 0 - 标签; 2 - (默认) 元素名称; 4 - 无; 5 - 自定义。 |
label_type_map | integer | 地图元素的标签类型。 可选值: 0 - 标签; 2 - (默认) 元素名称; 3 - 仅状态; 4 - 无; 5 - 自定义。 |
label_type_trigger | integer | 触发器元素的标签类型。 可选值: 0 - 标签; 2 - (默认) 元素名称; 3 - 仅状态; 4 - 无; 5 - 自定义。 |
markelements | integer | 是否高亮显示最近状态发生变化的元素。 可选值: 0 - (默认) 不高亮元素; 1 - 高亮元素。 |
severity_min | integer | 将在地图上显示的触发器的最低严重性。 支持的触发器严重性列表请参考 触发器。 |
show_unack | integer | 问题的显示方式。 可选值: 0 - (默认) 显示所有问题的计数; 1 - 仅显示未确认问题的计数; 2 - 分别显示已确认和未确认问题的计数。 |
userid | string | 地图所有者用户ID。 |
private | integer | 地图共享类型。 可选值: 0 - 公共地图; 1 - (默认) 私有地图。 |
show_suppressed | integer | 是否显示被抑制的问题。 可选值: 0 - (默认) 隐藏被抑制的问题; 1 - 显示被抑制的问题。 |
注意:对于某些方法(更新、删除),必需/可选参数的组合有所不同。
地图元素object定义了在地图上显示的object,具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
selementid | string | (只读) 地图元素的ID。 |
elements (required) |
array | 元素数据object。对于主机、主机组、触发器和地图类型元素是必需的。 |
elementtype (required) |
integer | 地图元素的类型。 可能的值: 0 - 主机; 1 - 地图; 2 - 触发器; 3 - 主机组; 4 - 图像。 |
iconid_off (required) |
string | 用于在默认状态下显示元素的图像ID。 |
areatype | integer | 如何显示独立的主机组主机。 可能的值: 0 - (默认) 主机组元素将占据整个地图; 1 - 主机组元素将具有固定大小。 |
elementsubtype | integer | 如何在地图上显示主机组元素。 可能的值: 0 - (默认) 将主机组显示为单个元素; 1 - 分别显示组中的每个主机。 |
evaltype | integer | 地图元素标签过滤条件评估方法。 可能的值: 0 - (默认) AND / OR; 2 - OR。 |
height | integer | 固定大小的主机组元素的高度(像素)。 默认值:200。 |
iconid_disabled | string | 用于显示禁用地图元素的图像ID。不适用于图像元素。 |
iconid_maintenance | string | 用于显示处于维护状态的地图元素的图像ID。不适用于图像元素。 |
iconid_on | string | 用于显示有问题地图元素的图像ID。不适用于图像元素。 |
label | string | 元素的标签。 |
label_location | integer | 地图元素标签的位置。 可能的值: -1 - (默认) 默认位置; 0 - 底部; 1 - 左侧; 2 - 右侧; 3 - Top。 |
permission | integer | 权限级别类型。 可能的值: -1 - 无; 2 - 只读; 3 - 读写。 |
sysmapid | string | (只读) 元素所属地图的ID。 |
urls | array | 地图元素URL。 地图元素URL object是地图元素-url。 |
use_iconmap | integer | 是否必须对主机元素使用图标映射。 可能的值: 0 - 不使用图标映射; 1 - (默认) 使用图标映射。 |
viewtype | integer | 主机组元素放置算法。 可能的值: 0 - (默认) 网格。 |
width | integer | 固定大小的主机组元素的宽度(像素)。 默认值:200。 |
x | integer | 元素的X坐标(像素)。 默认值:0。 |
y | integer | 元素的Y坐标(像素)。 默认值:0。 |
地图元素 主机 object 用于定义一个 主机 元素。
属性 | 数据类型 | 描述 |
---|---|---|
hostid | string | 主机 标识符 |
地图元素主机组object定义一个主机组元素。
属性 | 数据类型 | 描述 |
---|---|---|
groupid | string | 主机组ID |
地图元素 地图 object 定义一个地图元素。
属性 | 数据类型 | 描述 |
---|---|---|
sysmapid | string | 地图ID |
地图元素触发器object定义一个或多个触发器元素。
属性 | 数据类型 | 描述 |
---|---|---|
triggerid | string | 触发器ID |
地图元素标签object具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
tag (required) |
string | 地图元素标签名称。 |
operator | integer | 地图元素标签条件运算符。 可选值: 0 - (默认) 包含; 1 - 等于; 2 - 不包含; 3 - 不等于; 4 - 存在; 5 - 不存在。 |
value | string | 地图元素标签值。 |
地图元素URL object定义了可用于特定地图元素的可点击链接,具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
sysmapelementurlid | string | (只读) 地图元素URL的ID。 |
name (required) |
string | 链接标题。 |
url (required) |
string | 链接URL。 |
selementid | string | URL所属地图元素的ID。 |
地图链接object用于定义两个地图元素之间的连接关系,具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
linkid | string | (只读) 地图链接的唯一标识符。 |
selementid1 (required) |
string | 连接一端的地图元素ID。 |
selementid2 (required) |
string | 连接另一端的地图元素ID。 |
color | string | 线条颜色的十六进制代码。 默认值: 000000 。 |
drawtype | integer | 链接线条绘制样式。 可选值: 0 - (默认) 实线; 2 - 粗线; 3 - 点线; 4 - 虚线。 |
label | string | 链接标签文本。 |
linktriggers | array | 用作链接状态指示器的地图链接触发器。 地图链接触发器object的配置详见地图链接触发器。 |
permission | integer | 权限级别类型。 可选值: -1 - 无权限; 2 - 只读; 3 - 读写。 |
sysmapid | string | 链接所属地图的ID。 |
地图链接触发器object基于触发器状态定义地图链接状态指示器,具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
linktriggerid | string | (只读) 地图链接触发器ID。 |
triggerid (required) |
string | 用作链接指示器的触发器ID。 |
color | string | 指示器颜色(十六进制颜色代码)。 默认值: DD0000 。 |
drawtype | integer | 指示器绘制样式。 可选值: 0 - (默认) 实线; 2 - 粗线; 3 - 点线; 4 - 虚线。 |
linkid | string | 链接触发器所属的地图链接ID。 |
地图URL object定义了可点击链接,该链接将在地图上特定类型的所有元素中可用。它具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
sysmapurlid | string | (只读) 地图URL的ID。 |
name (required) |
string | 链接标题。 |
url (required) |
string | 链接URL。 |
elementtype | integer | 链接可用的地图元素类型。 支持的类型的列表请参考地图元素。 默认值:0。 |
sysmapid | string | URL所属的地图ID。 |
基于用户的地图权限列表。该列表包含以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
sysmapuserid | string | (只读) 地图用户的ID。 |
userid (required) |
string | 用户ID。 |
permission (required) |
integer | 权限级别类型。 可能的值: 2 - 只读; 3 - 读写; |
基于用户组的地图权限列表。具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
sysmapusrgrpid | string | (只读) 地图用户组的ID。 |
usrgrpid (required) |
string | 用户组ID。 |
permission (required) |
integer | 权限级别类型。 可能的值: 2 - 只读; 3 - 读写; |
地图形状object定义了在地图上显示的几何形状(可带或不带文字)。它具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
sysmap_shapeid | string | (只读) 地图形状元素的ID。 |
type (required) | integer | 地图形状元素的类型。 可选值: 0 - 矩形; 1 - 椭圆。 创建新形状时此属性为必填项。 |
x | integer | 形状的X坐标(像素单位)。 默认值:0。 |
y | integer | 形状的Y坐标(像素单位)。 默认值:0。 |
width | integer | 形状的宽度(像素单位)。 默认值:200。 |
height | integer | 形状的高度(像素单位)。 默认值:200。 |
text | string | 形状内的文字内容。 |
font | integer | 形状内文字的字体。 可选值: 0 - Georgia, serif 1 - "Palatino Linotype", "Book Antiqua", Palatino, serif 2 - "Times New Roman", Times, serif 3 - Arial, Helvetica, sans-serif 4 - "Arial Black", Gadget, sans-serif 5 - "Comic Sans MS", cursive, sans-serif 6 - Impact, Charcoal, sans-serif 7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif 8 - Tahoma, Geneva, sans-serif 9 - "Trebuchet MS", Helvetica, sans-serif 10 - Verdana, Geneva, sans-serif 11 - "Courier New", Courier, monospace 12 - "Lucida Console", Monaco, monospace 默认值:9。 |
font_size | integer | 字体大小(像素单位)。 默认值:11。 |
font_color | string | 字体颜色。 默认值:'000000'。 |
text_halign | integer | 文字水平对齐方式。 可选值: 0 - 居中; 1 - 左对齐; 2 - 右对齐。 默认值:0。 |
text_valign | integer | 文字垂直对齐方式。 可选值: 0 - 垂直居中; 1 - Top; 2 - 底部对齐。 默认值:0。 |
border_type | integer | 边框类型。 可选值: 0 - 无边框; 1 - ————— ;2 - ····· ;3 - - - - 。默认值:0。 |
border_width | integer | 边框宽度(像素单位)。 默认值:0。 |
border_color | string | 边框颜色。 默认值:'000000'。 |
background_color | string | 背景色(填充色)。 默认值: (empty) 。 |
zindex | integer | 用于排序所有形状和线条的层级值(z-index)。 默认值:0。 |
地图线条object定义了在地图上显示的线条,具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
sysmap_shapeid | string | (只读) 地图图形元素的ID。 |
x1 | integer | 线条点1的X坐标(像素单位)。 默认值:0。 |
y1 | integer | 线条点1的Y坐标(像素单位)。 默认值:0。 |
x2 | integer | 线条点2的X坐标(像素单位)。 默认值:200。 |
y2 | integer | 线条点2的Y坐标(像素单位)。 默认值:200。 |
line_type | integer | 线条类型。 可选值: 0 - 无; 1 - ————— ;2 - ····· ;3 - - - - 。默认值:0。 |
line_width | integer | 线条宽度(像素单位)。 默认值:0。 |
line_color | string | 线条颜色。 默认值:'000000'。 |
zindex | integer | 用于排序所有图形和线条的数值(z-index)。 默认值:0。 |