创建

描述

object iconmap.create(object/array iconMaps)

此方法允许创建新的图标映射。

此方法仅允许超级管理员类型的用户使用。调用此方法的权限可以在用户角色设置里撤销。更多信息请参见用户角色

参数

(object/array) 要创建的图标映射。

除了标准的图标映射属性之外,此方法还接受以下参数。

参数 类型 描述
mappings
(必需)
array 为图标映射创建的多个图标映射关系(icon mappings)

参数行为:
-必需

返回值

(object) 返回一个如下对象:在 iconmapids 属性下包含所创建图标映射的 ID。返回的多个 ID 的顺序与传参里多个图标映射的顺序相匹配。

示例

创建一个图标映射

创建一个图标映射以展现不同类型的主机。

请求:

{
           "jsonrpc": "2.0",
           "method": "iconmap.create",
           "params": {
               "name": "Type icons",
               "default_iconid": "2",
               "mappings": [
                   {
                       "inventory_link": 1,
                       "expression": "server",
                       "iconid": "3"
                   },
                   {
                       "inventory_link": 1,
                       "expression": "switch",
                       "iconid": "4"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "iconmapids": [
                   "2"
               ]
           },
           "id": 1
       }

参阅

来源

CIconMap::create() in ui/include/classes/api/services/CIconMap.php.