Sidebar

zh:manual:api:reference:service:update

更新

说明

object service.update(object/array services)

此方法允许更新现有服务。

参数

(object/array)需要更新的服务属性。 必须为每个服务定义serviceid属性,所有其他属性为可选项。只有通过的属性会被更新,所有其他属性将保持不变。 除标准服务属性之外,该方法接受以下参数。

参数 类型 说明
dependencies 数组 用来替换当前内容的服务依赖关系。

每个服务依赖项具有以下参数:
- dependsOnServiceid - (字符串) 依赖服务的服务,即子服务的ID。
- soft - (整数型) 服务依赖类型;有关依赖关系类型的更多信息,请参阅服务依赖页面
parentid 字符串 硬链接的父服务ID。
times 数组 用来替换当前内容的服务时间。

返回值

(object)返回一个对象,该对象包含在serviceids属性中已更新服务的ID。

示例

设置父服务

使服务“3”硬链接于父服务“5”。

请求:

{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "serviceid": "5",
        "parentid": "3"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

响应:

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

参考

Source 源码

CService::update() in frontends/php/include/classes/api/services/CService.php. CService::update()方法可在frontends/php/include/classes/api/services/CService.php中参考。