# valuemap.create

### 说明

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

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

### Description

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

This method allows to create new value maps.

### 参数

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

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

### Parameters

`(object/array)` Value maps to create.

The method accepts value maps with the [standard value map
properties](object#value_map).

### 返回值

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

### Return values

`(object)` Returns an object containing the IDs of the created value
maps the `valuemapids` property. The order of the returned IDs matches
the order of the passed value maps.

### 示例

### Examples

#### 创建一个值映射

使用两个映射创建一个值映射。

#### Creating a value map

Create one value map with two mappings.

Request:

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

Response:

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

### 来源

### Source

CValueMap::create() in
*frontends/php/include/classes/api/services/CValueMap.php*.