Sidebar

zh:manual:api:reference:valuemap:create

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) 要创建的值映射。

该方法接受有 标准值映射属性的值映射。

Parameters

(object/array) Value maps to create.

The method accepts value maps with the standard value map properties.

返回值

(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:

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

Response:

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

来源

Source

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