获取

描述

integer/array map.get(object parameters)

此方法允许根据给定参数检索符合条件的拓扑图。

此方法适用于任何类型的用户。调用该方法的权限可以在用户角色设置中撤销。 请参阅用户角色了解更多信息。

参数

(object) 定义所需输出的参数。

该方法支持以下参数。

参数类型说明
sysmapidsID/array仅返回具有给定 ID 的地图。
useridsID/array仅返回属于给定用户 ID 的地图。
expandUrlsflag将全局地图 URL 添加到相应的地图元素,并扩展所有地图元素 URL 中的宏。
selectIconMapquery返回带有地图上使用的图标地图的 iconmap 属性。
selectLinksquery返回带有元素之间地图链接的 links 属性。
selectSelementsquery返回带有地图元素的 selements 属性。
selectUrlsquery返回带有地图 URL 的 urls 属性。
selectUsersquery返回带有共享地图的用户的 users 属性。
selectUserGroupsquery返回带有共享地图的用户组的 userGroups 属性。
selectShapesquery返回带有地图形状的 shapes 属性。
selectLinesquery返回带有地图线的 lines 属性。
sortfieldstring/array根据给定的属性对结果进行排序。

可能的值:namewidthheight
countOutputboolean这些参数是所有 get 方法的通用参数,在 参考注释 中有详细描述。
editableboolean
excludeSearchboolean
filterobject
limitinteger
outputquery
preservekeysboolean
searchobject
searchByAnyboolean
searchWildcardsEnabledboolean
sortorder字符串/数组
startSearch布尔值

返回值

(整型/数组) 返回其中之一:

  • 一个对象数组;
  • 如果使用countOutput参数,查询对象的数量.

案例

查询拓扑图

查询有关拓扑图”3”的所有数据。

请求

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "map.get",
  4. "params": {
  5. "output": "extend",
  6. "selectSelements": "extend",
  7. "selectLinks": "extend",
  8. "selectUsers": "extend",
  9. "selectUserGroups": "extend",
  10. "selectShapes": "extend",
  11. "selectLines": "extend",
  12. "sysmapids": "3"
  13. },
  14. "id": 1
  15. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": [
  4. {
  5. "selements": [
  6. {
  7. "selementid": "10",
  8. "sysmapid": "3",
  9. "elementtype": "4",
  10. "evaltype": "0",
  11. "iconid_off": "1",
  12. "iconid_on": "0",
  13. "label": "Zabbix server",
  14. "label_location": "3",
  15. "x": "11",
  16. "y": "141",
  17. "iconid_disabled": "0",
  18. "iconid_maintenance": "0",
  19. "elementsubtype": "0",
  20. "areatype": "0",
  21. "width": "200",
  22. "height": "200",
  23. "tags": [
  24. {
  25. "tag": "service",
  26. "value": "mysqld",
  27. "operator": "0"
  28. }
  29. ],
  30. "viewtype": "0",
  31. "use_iconmap": "1",
  32. "urls": [],
  33. "elements": []
  34. },
  35. {
  36. "selementid": "11",
  37. "sysmapid": "3",
  38. "elementtype": "4",
  39. "evaltype": "0",
  40. "iconid_off": "1",
  41. "iconid_on": "0",
  42. "label": "Web server",
  43. "label_location": "3",
  44. "x": "211",
  45. "y": "191",
  46. "iconid_disabled": "0",
  47. "iconid_maintenance": "0",
  48. "elementsubtype": "0",
  49. "areatype": "0",
  50. "width": "200",
  51. "height": "200",
  52. "viewtype": "0",
  53. "use_iconmap": "1",
  54. "tags": [],
  55. "urls": [],
  56. "elements": []
  57. },
  58. {
  59. "selementid": "12",
  60. "sysmapid": "3",
  61. "elementtype": "0",
  62. "evaltype": "0",
  63. "iconid_off": "185",
  64. "iconid_on": "0",
  65. "label": "{HOST.NAME}\r\n{HOST.CONN}",
  66. "label_location": "0",
  67. "x": "111",
  68. "y": "61",
  69. "iconid_disabled": "0",
  70. "iconid_maintenance": "0",
  71. "elementsubtype": "0",
  72. "areatype": "0",
  73. "width": "200",
  74. "height": "200",
  75. "viewtype": "0",
  76. "use_iconmap": "0",
  77. "tags": [],
  78. "urls": [],
  79. "elements": [
  80. {
  81. "hostid": "10084"
  82. }
  83. ]
  84. }
  85. ],
  86. "links": [
  87. {
  88. "linkid": "23",
  89. "sysmapid": "3",
  90. "selementid1": "10",
  91. "selementid2": "11",
  92. "drawtype": "0",
  93. "color": "00CC00",
  94. "label": "",
  95. "linktriggers": []
  96. }
  97. ],
  98. "users": [
  99. {
  100. "sysmapuserid": "1",
  101. "userid": "2",
  102. "permission": "2"
  103. }
  104. ],
  105. "userGroups": [
  106. {
  107. "sysmapusrgrpid": "1",
  108. "usrgrpid": "7",
  109. "permission": "2"
  110. }
  111. ],
  112. "shapes":[
  113. {
  114. "sysmap_shapeid":"1",
  115. "type":"0",
  116. "x":"0",
  117. "y":"0",
  118. "width":"680",
  119. "height":"15",
  120. "text":"{MAP.NAME}",
  121. "font":"9",
  122. "font_size":"11",
  123. "font_color":"000000",
  124. "text_halign":"0",
  125. "text_valign":"0",
  126. "border_type":"0",
  127. "border_width":"0",
  128. "border_color":"000000",
  129. "background_color":"",
  130. "zindex":"0"
  131. }
  132. ],
  133. "lines":[
  134. {
  135. "sysmap_shapeid":"2",
  136. "x1": 30,
  137. "y1": 10,
  138. "x2": 100,
  139. "y2": 50,
  140. "line_type": 1,
  141. "line_width": 10,
  142. "line_color": "009900",
  143. "zindex":"1"
  144. }
  145. ],
  146. "sysmapid": "3",
  147. "name": "Local network",
  148. "width": "400",
  149. "height": "400",
  150. "backgroundid": "0",
  151. "label_type": "2",
  152. "label_location": "3",
  153. "highlight": "1",
  154. "expandproblem": "1",
  155. "markelements": "0",
  156. "show_unack": "0",
  157. "grid_size": "50",
  158. "grid_show": "1",
  159. "grid_align": "1",
  160. "label_format": "0",
  161. "label_type_host": "2",
  162. "label_type_hostgroup": "2",
  163. "label_type_trigger": "2",
  164. "label_type_map": "2",
  165. "label_type_image": "2",
  166. "label_string_host": "",
  167. "label_string_hostgroup": "",
  168. "label_string_trigger": "",
  169. "label_string_map": "",
  170. "label_string_image": "",
  171. "iconmapid": "0",
  172. "expand_macros": "0",
  173. "severity_min": "0",
  174. "userid": "1",
  175. "private": "1",
  176. "show_suppressed": "1"
  177. }
  178. ],
  179. "id": 1
  180. }

查看相关

来源

CMap::get() in ui/include/classes/api/services/CMap.php.