文档首页/ Astro轻应用 AstroZero/ API参考/ API/ 数据模块/ 按条件更新数据
更新时间：2024-11-21 GMT+08:00
查看PDF
分享

按条件更新数据

功能介绍

按条件更新数据，该接口为同步接口（同步接口是指调用后，会等待函数执行结束后，才返回结果）。

在此之前需要先创建对象以及待更新的数据记录。

URI

PUT AstroZero域名/u-route/baas/data/v1.0/bobject/{objectName}

表1 路径参数

参数

是否必选

参数类型

描述

objectName

是

String

参数解释：

数据对象的名称，请参考登录应用设计器中操作，进入应用设计器，在“数据 > 对象”列表中查看。

约束限制：

不涉及。

取值范围：

1~80个字符。

默认取值：

不涉及。

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

setValue

是

Object

参数解释：

修改对象的字段和值，可参考下操作查看对象中包含的字段和值：

  1. 参考登录应用设计器中操作，进入应用设计器。
  2. 在“数据 > 对象”列表中，将鼠标放在对象上，单击，选择“详情”。
  3. 在对象详情页面的“字段”页签中，查看对象包含的字段及字段的值。

约束限制：

不涉及。

condition

是

Object

参数解释：

更新记录的条件，类似于SQL的where条件。

约束限制：

不涉及。

响应参数

表3 响应参数

参数

参数类型

描述

resCode

String

参数解释：

返回码。

取值范围：

如果返回“0”代表请求成功，其他错误码说明请参考错误码。

resMsg

String

参数解释：

返回消息。

取值范围：

如果成功状态，通常会返回“Success”，其他情况会返回具体的错误信息。

result

Number

参数解释：

更新记录的个数，成功时携带。

取值范围：

不涉及。

请求示例

更新“TestProject__testForObject__CST”对象中，满足name字段值为“newName”的记录，更新name字段值为“name3”。 
PUT https://AstroZero域名/u-route/baas/data/v1.0/bobject/TestProject__testForObject__CST
 
{
    "setValue": {
        "name": "name3"
    },
    "condition": {
        "conjunction": "AND",
        "conditions": [
            {
                "field": "name",
                "operator": "eq",
                "value": "newName"
            }
        ]
    }
}

响应示例

{
    "resCode": "0",
    "resMsg": "成功",
    "result": 1
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据模块

相关文档