Documentation

Table of Contents

iconmap.create
- 描述
- 参数
- 返回值
- 示例
  - 创建一个图标映射
- 参阅
- 来源

iconmap.create

描述

object iconmap.create(object/array iconMaps)

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

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

参数

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

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

参数	类型	描述
mappings （必需）	数组	为图标映射创建的多个图标映射关系（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
       }

参阅

图标映射关系（Icon mapping）

来源

来自 ui/include/classes/api/services/CIconMap.php 的 CIconMap::create() 。