[comment]: # ({f5d7e62f-f5d7e62f})
# service.create

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

[comment]: # ({c44d5a50-c44d5a50})
### 描述

`object service.create(object/array services)`

此方法允许create新服务.

::: noteclassic
该方法对所有类型用户开放. 调用该方法的权限可通过用户角色设置进行撤销. 更多信息请参阅[User
roles](/manual/web_interface/frontend_sections/administration/user_roles).

:::

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

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

`(object/array)` 服务以 create.

除了 [服务](object#服务) 之外，
该方法还接受以下参数。

| 参数 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------|
| children | array | 要链接到服务的子服务。<br><br>子服务必须定义 `serviceid` 属性。 |
| parents | array | 要链接到服务的父服务。<br><br>父服务必须定义 `serviceid` 属性。 |
| tags | array | 要为服务创建的 [服务标签](/manual/api/reference/service/object#服务标签)。 |
| problem\_tags | array | 要为服务创建的 [问题标签](/manual/api/reference/service/object#问题标签)。 |
| status\_rules | array | 要为服务创建的 [状态规则](/manual/api/reference/service/object#状态规则)。 |

[comment]: # ({/1ec946f5-1ec946f5})

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

`(object)` 返回一个包含所创建服务ID的object，这些ID存储在`serviceids`属性下。返回的ID顺序与传入的服务顺序保持一致。

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

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

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

[comment]: # ({9e6c40ac-1607e64a})
#### 创建服务

创建一个服务，当至少一个子项出现问题时，该服务将切换至问题状态。

请求:

```json
{
    "jsonrpc": "2.0",
    "method": "service.create",
    "params": {
        "name": "Server 1",
        "algorithm": 1,
        "sortorder": 1
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```
响应:

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

[comment]: # ({/9e6c40ac-1607e64a})

[comment]: # ({fda6729e-fda6729e})
### 来源

CService::create() 位于 *ui/include/classes/api/services/CService.php* 文件中。

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