更新时间：2025-10-11 GMT+08:00

按条件更新数据 - UpdateData

功能介绍

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

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

URI

PUT 华为云Astro轻应用域名/u-route/baas/data/v1.0/bobject/{objectName}

表1 路径参数
参数	是否必选	参数类型	描述
objectName	是	String	参数解释：数据对象的名称，请参考登录应用设计器中操作，进入应用设计器，在“数据 > 对象”列表中查看。约束限制：不涉及。取值范围： 1~80个字符。默认取值：不涉及。

请求参数

表2 请求参数
参数	是否必选	参数类型	描述
setValue	是	Object	参数解释：修改对象的字段和值，可参考下操作查看对象中包含的字段和值：参考登录应用设计器中操作，进入应用设计器。在“数据 > 对象”列表中，将鼠标放在对象上，单击，选择“详情”。在对象详情页面的“字段”页签中，查看对象包含的字段及字段的值。约束限制：不涉及。
condition	是	Object	参数解释：更新记录的条件，类似于SQL的where条件。约束限制：不涉及。

响应参数

表3 响应参数
参数	参数类型	描述
resCode	String	参数解释：返回码。取值范围：如果返回“0”代表请求成功，其他错误码说明请参考错误码。
resMsg	String	参数解释：返回消息。取值范围：成功返回“成功”，其他情况会返回具体的错误信息。
result	Number	参数解释：更新记录的个数，成功时携带。取值范围：不涉及。

请求示例

更新“TestProject__testForObject__CST”对象中，满足name字段值为“newName”的记录，更新name字段值为“name3”。

PUT https://华为云Astro轻应用域名/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
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据模块