[comment]: # translation:outdated [comment]: # ({14e441a9-14e441a9}) # map.get [comment]: # ({/14e441a9-14e441a9}) [comment]: # ({72489b9c-480bee08}) ### 描述 `integer/array map.get(object parameters)` 该方法允许根据给定参数检索地图。 ::: noteclassic 此方法可供任何类型的用户使用。调用该方法的权限可以在用户角色设置中撤销。更多信息请参阅[User roles](/manual/web_interface/frontend_sections/users/user_roles)。 ::: [comment]: # ({/72489b9c-480bee08}) [comment]: # ({06309d5b-c0fdc6dd}) ### 参数 `(object)` 定义所需输出的参数. 该方法支持以下参数. | 参数 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 | |--|--|------| | sysmapids | ID/array | 仅返回具有指定ID的地图. | | userids | ID/array | 仅返回属于指定用户ID的地图. | | expandUrls | flag | 为对应的地图元素添加全局地图URL并在所有地图元素URL中展开宏. | | selectIconMap | query | 返回包含地图所用图标映射的[`iconmap`](/manual/api/reference/iconmap/object)属性. | | selectLinks | query | 返回包含地图元素间链接的[`links`](/manual/api/reference/map/object#map-link)属性. | | selectSelements | query | 返回包含地图元素的[`selements`](/manual/api/reference/map/object#map-element)属性. | | selectUrls | query | 返回包含地图URL的[`urls`](/manual/api/reference/map/object#map-url)属性. | | selectUsers | query | 返回包含地图共享用户的[`users`](/manual/api/reference/map/object#map-user)属性. | | selectUserGroups | query | 返回包含地图共享用户组的[`userGroups`](/manual/api/reference/map/object#map-user-group)属性. | | selectShapes | query | 返回包含地图形状的[`shapes`](/manual/api/reference/map/object#map-shapes)属性. | | selectLines | query | 返回包含地图线条的[`lines`](/manual/api/reference/map/object#map-lines)属性. | | sortfield | string/array | 按给定属性排序结果.

可能值: `name`, `width`, `height`. | | countOutput | boolean | 这些参数在[通用get方法参数](/manual/api/reference_commentary#通用get方法参数)中有描述. | | editable | boolean | ^ | | excludeSearch | boolean | ^ | | filter | object | ^ | | limit | integer | ^ | | output | query | ^ | | preservekeys | boolean | ^ | | search | object | ^ | | searchByAny | boolean | ^ | | searchWildcardsEnabled | boolean | ^ | | sortorder | string/array | ^ | | startSearch | boolean | ^ | [comment]: # ({/06309d5b-c0fdc6dd}) [comment]: # ({7223bab1-7223bab1}) ### 返回值 `(integer/array)` 返回以下两种结果之一: - 一个包含array的objects数组 - 检索到的objects数量（当使用了`countOutput`参数时） [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### 示例 [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({645c26fb-cb769d11}) #### 检索地图 获取地图"3"的所有数据 [执行请求](/manual/api#执行请求): ```json { "jsonrpc": "2.0", "method": "map.get", "params": { "output": "extend", "selectSelements": "extend", "selectLinks": "extend", "selectUsers": "extend", "selectUserGroups": "extend", "selectShapes": "extend", "selectLines": "extend", "sysmapids": "3" }, "id": 1 } ``` 响应: ```json { "jsonrpc": "2.0", "result": [ { "selements": [ { "selementid": "10", "sysmapid": "3", "elementtype": "4", "evaltype": "0", "iconid_off": "1", "iconid_on": "0", "label": "Zabbix server", "label_location": "3", "x": "11", "y": "141", "iconid_disabled": "0", "iconid_maintenance": "0", "elementsubtype": "0", "areatype": "0", "width": "200", "height": "200", "viewtype": "0", "use_iconmap": "1", "show_label": "-1", "zindex":"0", "elements": [], "urls": [], "tags": [ { "tag": "service", "value": "mysqld", "operator": "0" } ] }, { "selementid": "11", "sysmapid": "3", "elementtype": "4", "evaltype": "0", "iconid_off": "1", "iconid_on": "0", "label": "Web server", "label_location": "3", "x": "211", "y": "191", "iconid_disabled": "0", "iconid_maintenance": "0", "elementsubtype": "0", "areatype": "0", "width": "200", "height": "200", "viewtype": "0", "use_iconmap": "1", "show_label": "0", "zindex":"0", "elements": [], "urls": [], "tags": [] }, { "selementid": "12", "sysmapid": "3", "elementtype": "0", "evaltype": "0", "iconid_off": "185", "iconid_on": "0", "label": "{HOST.NAME}\r\n{HOST.CONN}", "label_location": "0", "x": "111", "y": "61", "iconid_disabled": "0", "iconid_maintenance": "0", "elementsubtype": "0", "areatype": "0", "width": "200", "height": "200", "viewtype": "0", "use_iconmap": "0", "show_label": "1", "zindex":"0", "elements": [ { "hostid": "10084" } ], "urls": [], "tags": [] } ], "links": [ { "linkid": "23", "sysmapid": "3", "selementid1": "10", "selementid2": "11", "drawtype": "0", "color": "00CC00", "label": "", "show_label": "1", "indicator_type": "0", "itemid": "0", "linktriggers": [], "thresholds": [], "highlights": [] } ], "users": [ { "sysmapuserid": "1", "userid": "2", "permission": "2" } ], "userGroups": [ { "sysmapusrgrpid": "1", "usrgrpid": "7", "permission": "2" } ], "shapes":[ { "sysmap_shapeid":"1", "type":"0", "x":"0", "y":"0", "width":"680", "height":"15", "text":"{MAP.NAME}", "font":"9", "font_size":"11", "font_color":"000000", "text_halign":"0", "text_valign":"0", "border_type":"0", "border_width":"0", "border_color":"000000", "background_color":"", "zindex":"0" } ], "lines":[ { "sysmap_shapeid":"2", "x1": 30, "y1": 10, "x2": 100, "y2": 50, "line_type": 1, "line_width": 10, "line_color": "009900", "zindex":"1" } ], "sysmapid": "3", "name": "Local network", "width": "400", "height": "400", "backgroundid": "0", "background_scale": "1", "label_type": "2", "label_location": "3", "show_element_label": "0", "show_link_label": "1", "highlight": "1", "expandproblem": "1", "markelements": "0", "show_unack": "0", "grid_size": "50", "grid_show": "1", "grid_align": "1", "label_format": "0", "label_type_host": "2", "label_type_hostgroup": "2", "label_type_trigger": "2", "label_type_map": "2", "label_type_image": "2", "label_string_host": "", "label_string_hostgroup": "", "label_string_trigger": "", "label_string_map": "", "label_string_image": "", "iconmapid": "0", "expand_macros": "0", "severity_min": "0", "userid": "1", "private": "1", "show_suppressed": "1" } ], "id": 1 } ``` [comment]: # ({/645c26fb-cb769d11}) [comment]: # ({4be4cd90-4be4cd90}) ### 另请参阅 - [图标映射](/manual/api/reference/iconmap/object#图标映射) - [地图元素](object#地图元素) - [地图链接](object#地图链接) - [地图-url](object#地图-url) - [地图用户](object#地图用户) - [映射用户组](object#映射用户组) - [地图形状](object#地图形状) - [地图连线](object#地图连线) [comment]: # ({/4be4cd90-4be4cd90}) [comment]: # ({d61644e7-d61644e7}) ### 来源 CMap::get() 位于 *ui/include/classes/api/services/CMap.php* 文件中。 [comment]: # ({/d61644e7-d61644e7})