[comment]: # translation:outdated

[comment]: # ({6698fb90-6698fb90})
# 创建

[comment]: # ({/6698fb90-6698fb90})

[comment]: # ({34b10afc-37547a16})
### 描述

`object valuemap.create(object/array valuemaps)`

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

::: noteclassic
此方法只有 *Super admin(超级管理员)* 用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看 [用户角色](/manual/web_interface/frontend_sections/administration/user_roles)。
:::

[comment]: # ({/34b10afc-37547a16})

[comment]: # ({efa9b6ec-efa9b6ec})
### 参数

`(object/array)` 要创建的值映射。

该方法接受具有 [标准值映射
属性](object#value_map) 的值映射。

[comment]: # ({/efa9b6ec-efa9b6ec})

[comment]: # ({6809040a-6809040a})
### 返回值

`(object)` 返回一个对象，其中包含`valuemapids` 属性所创建值映射的 ID。返回 ID 的顺序与传递的值映射的顺序相匹配。

[comment]: # ({/6809040a-6809040a})

[comment]: # ({b41637d2-b41637d2})
### 示例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({07a2014d-ace763eb})
#### 创建一个值映射

创建一个包含两个映射的值映射。

[请求](/manual/api#执行请求):

```json
{
    "jsonrpc": "2.0",
    "method": "valuemap.create",
    "params": {
        "hostid": "50009",
        "name": "Service state",
        "mappings": [
            {
                "type": "1",
                "value": "1",
                "newvalue": "Up"
            },
            {
                "type": "5",
                "newvalue": "Down"
            }
        ]
    },
    "auth": "57562fd409b3b3b9a4d916d45207bbcb",
    "id": 1
}
```

响应：

```json
{
    "jsonrpc": "2.0",
    "result": {
        "valuemapids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/07a2014d-ace763eb})

[comment]: # ({58f99a13-58f99a13})
### 源码

*ui/include/classes/api/services/CValueMap.php* 中的 CValueMap::create()。

[comment]: # ({/58f99a13-58f99a13})