
# 批量插入对象数据 - AddObjectData
#### 功能介绍
批量插入或修改对象数据，若数据包含id进行更新，若数据不含id进行插入。
#### URI
POST *华为云Astro轻应用域名*/u-route/baas/data/v1.0/upsert/{objectName}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| objectName | 是    | String | **参数解释**： 数据对象的名称，请参考[登录应用设计器](https://support.huaweicloud.com/api-astrozero/astrozero_api_0094.html)中操作，进入应用设计器，在"数据 \> 对象"列表中查看。 **约束限制**： 不涉及。 **取值范围**： 1\~80个字符。 **默认取值**： 不涉及。 |
   
#### 请求参数
表2请求参数 
| 参数      | 是否必选 | 参数类型  | 描述                                                                                                                                                                           |
|:---|:---|:---|:---|
| records | 是    | Array | **参数解释**： 需要插入或者更新的数据组成的数组。 **约束限制**： 若数据中包含id则视为更新，否则视为插入新数据。 |
   
#### 响应参数
表3响应参数 
| 参数      | 参数类型   | 描述                                                                                                                                                                                                                                                |
|:---|:---|:---|
| resCode | String | **参数解释**： 返回码。 **取值范围**： 如果返回"0"代表请求成功，其他错误码说明请参考[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。 |
| resMsg  | String | **参数解释**： 返回消息。 **取值范围**： 成功返回"成功"，其他情况会返回具体的错误信息。                                                                                |
| result  | Array  | **参数解释**： 插入或者更新成功，返回相应记录id组成的数组。                                                                                                                                                                           |
   
#### 请求示例
向对象"TestProject__testForObject1__CST"中插入三条数据，body体中含有要插入的records参数。
```
POST https://华为云Astro轻应用域名/u-route/baas/data/v1.0/upsert/TestProject__testForObject1__CST
  
 {
    "records":[
     {
         "name":"zhang",
         "TestProject__length__CST":"17"
     },
     {
         "name":"li",
         "TestProject__length__CST":"30"
     },
     {
         "name":"wang",
         "TestProject__length__CST":"20"
     }
     ]
}
```
#### 响应示例
```
{
    "resCode": "0",
    "resMsg": "成功",
    "result": [
        {
            "id": "cglE000000aMFjB9ipAu"
        },
        {
            "id": "cglE000000aMFjB9ipAv"
        },
        {
            "id": "cglE000000aMFjB9ipAw"
        }
    ]
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-astrozero/astrozero_api_0081.html)。
#### 错误码
错误码请参见[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。
