更新时间:2024-11-21 GMT+08:00
分享

按条件删除对象数据

功能介绍

按条件删除对象数据。

URI

POST AstroZero域名/u-route/baas/data/v1.0/delete/{objectName}

表1 参数说明

参数

是否必选

参数类型

描述

objectName

String

参数解释

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

约束限制

不涉及。

取值范围

1~80个字符。

默认取值

不涉及。

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

condition

Object

参数解释

表示删除的条件。其中包含以下三个元素,为空则表示删除所有对象数据。

  • conjunction:表示需要满足的条件个数。
    • AND:表示条件都要满足。
    • OR:表示至少要满足一个条件。
  • conditions:筛选条件的数组。如果参数为空,代表查询所有对象数据,若不为空,其中的每一个元素对象都包含如下三个字段。
    • field:类型string,字段名称。
    • operator:类型string,操作符。
    • value:类型string,对比值。
  • relation:数组中包含parents(向上查询)和children(向下查询)两个元素,两者分别对应相应的数组。

    其中,parents包含condition数组和relatedField(关联字段名称)。children包含condition数组和relationName(关联字段名称)。

    condition数组包含:

    • conjunction:取值为AND或OR。
    • conditions:同上conditions参数。
    • relation:同上relation参数。

约束限制

不涉及。

响应参数

表3 响应参数

参数

参数类型

描述

resCode

String

参数解释

返回码。

取值范围

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

resMsg

String

参数解释

返回消息。

取值范围

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

result

Number

参数解释

删除记录数。

取值范围

不涉及。

请求示例

删除“TestProject__testForObject1__CST”对象中,name为“test”的记录数。
POST https://AstroZero域名/u-route/baas/data/v1.0/delete/TestProject__testForObject1__CST
 {
    "condition": {
        "conjunction": "AND",
        "conditions": [
            {
                "field": "NAME",
                "operator": "eq",
                "value": "test"
            }
        ]
    }
}

响应示例

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

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档