# 根据对象ID新增布局 - AddLayout
#### 功能介绍
按对象ID新增对象布局。可以通过layout可视化各字段值，在新建字段时，把字段添加到具体某个layout中可以可视化这个字段。
#### URI
POST *华为云Astro轻应用域名* /u-route/baas/metadata/v1.0/Object/*{object_id}*/Layout
表1路径参数 
| 参数        | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| Object_id | 是    | String | **参数解释**： 对象的ID值，可通过调用[查询所有自定义对象 - QueryCustomObject](https://support.huaweicloud.com/api-astrozero/astrozero_api_0033.html)接口查看（响应消息中的"id"）。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
#### 请求参数
表2请求Body体参数 
| 参数                 | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| name               | 是    | String | **参数解释**： 创建表对象时的名称。 **约束限制**： 创建后不可修改。 **取值范围**： 名称必须以字母或中文开头，没有特殊字符，下划线和连续的空格，且长度不能超过64个字符。 **默认取值**： 不涉及。                                                                                                                                   |
| viewName           | 否    | String | **参数解释**： 对象的别名，格式为"__layout__ +对象名+ __布局名"。其中，"布局名"为请求体中的name，"对象名"可通过调用[查询所有自定义对象 - QueryCustomObject](https://support.huaweicloud.com/api-astrozero/astrozero_api_0033.html)中接口查看（即响应消息中的"name"）。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| existingPageLayout | 是    | String | **参数解释**： 现有页面布局的ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                               |
   
#### 响应参数
响应参数如[表3]所示。
 表3响应参数 
| 参数      | 参数类型   | 描述                                                                                                                                                                                                                                                |
|:---|:---|:---|
| resCode | String | **参数解释**： 返回码。 **取值范围**： 如果返回"0"代表请求成功，其他错误码说明请参考[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。 |
| resMsg  | String | **参数解释**： 返回消息。 **取值范围**： 成功返回"成功"，其他情况会返回具体的错误信息。                                                                                |
| result  | string | **参数解释**： 成功返回，会返回一个ID字符串。 **取值范围**： 不涉及。                                                                                         |
   
#### 请求示例
按object_id新增layout。
```
POST https://华为云Astro轻应用域名/u-route/baas/metadata/v1.0/Object/cust000000aKoa6I4E6K/Layout
{
    "name": "dsaf",
    "existingPageLayout": "000D000000aKoa6OJOxl",
    "viewName": "dsaf"
}
```
#### 响应示例
```
{
    "resCode": "0",
    "resMsg": "成功",
    "result": "000D000000aL60EyXgUS"
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-astrozero/astrozero_api_0081.html)。
#### 错误码
错误码请参见[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。