
# 创建对象并定义字段
#### 操作场景
创建一个车辆类型对象VehicleType，并定义字段，用于保存车辆类型、类型编号信息。
下面介绍如何调用创建对象并定义字段API，API的调用方法请参见[如何调用API（OAuth 2.0）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0008.html)。
#### 创建对象
1. 根据请求URI和请求方法，明确请求如下： 
   ```
   POST https://华为云Astro轻应用域名/u-route/baas/metadata/v1.0/object
   ```
   
   
2. 设置请求消息头。 
   表1请求消息头 
   | 消息头名称        | 描述                                                                              | 是否必选 |
   |:---|:---|:---|
   | Content-Type | HTTP协议中设定的一个参数，用于标识返回的内容用什么格式去解析，此处必须配置为"application/json"。表示浏览器将返回内容解析为json对象。 | 是    |
   | access-token | 当用户登录系统鉴权成功后，后台会生成一个token，在响应消息中携带，并存在浏览器中。下次再调用请求后，会带上这个token，表示这个用户已经被鉴权过。    | 是    |
      
   
   
3. 构造请求消息体。 
   ```
   {
       "label": "VehicleType",
       "name": "VehicleType__CST",
       "description": "",
       "fields": [
           {
               "label": "Name",
               "name": "name",
               "dataType": "Name"
           }
       ],
       "view": {
           "ObjectDetailLayout": {
               "name": "__layout__VehicleType__CST__detail",
               "fields": [
                   "name"
               ]
           },
           "ObjectRecordsLayout": {
               "name": "__layout__VehicleType__CST__records",
               "fields": [
                   "name"
               ]
           }
       }
   }
   ```
   返回如下响应，表示成功创建对象，记录"result"字段取值"cust000000aHYAsrPh4K"，为对象ID。
   ```
   {
       "resCode": "0",
       "resMsg": "成功",
       "result": "cust000000aHYAsrPh4K"
   }
   ```
   
   
 
#### 自定义字段
1. 根据请求URI和请求方法，明确请求如下，其中"cust000000aHYAsrPh4K"为对象ID： 
   ```
   POST https://华为云Astro轻应用域名/u-route/baas/metadata/v1.0/object/cust000000aHYAsrPh4K/fields
   ```
   
   
2. 设置请求消息头。 
   表2请求消息头 
   | 消息头名称        | 描述                                                                              | 是否必选 |
   |:---|:---|:---|
   | Content-Type | HTTP协议中设定的一个参数，用于标识返回的内容用什么格式去解析，此处必须配置为"application/json"。表示浏览器将返回内容解析为json对象。 | 是    |
   | access-token | 当用户登录系统鉴权成功后，后台会生成一个token，在响应消息中携带，并存在浏览器中。下次再调用请求后，会带上这个token，表示这个用户已经被鉴权过。    | 是    |
      
   
   
3. 构造请求消息体，创建"VehicleType"、"VehicleNumber"字段。 
   ```
   {
       "fields": [
           {
               "label": "VehicleType",
               "name": "VehicleType__CST",
               "dataType": "text",
               "dataLength": 255,
               "caseSensitive": false,
               "isRequired": false,
               "isUnique": false,
               "isSearchable": false
           },
           {
               "label": "VehicleNumber",
               "name": "VehicleNumber__CST",
               "dataType": "text",
               "dataLength": 255,
               "caseSensitive": true,
               "isRequired": false,
               "isUnique": true,
               "isSearchable": false
           }
       ]
   }
   ```
   返回如下响应，表示成功创建字段。
   ```
   {
       "resCode": "0",
       "resMsg": "成功",
       "result": [
           "cust000000aHaE6S3mim",
           "cust000000aHaE6TlNVA"
       ]
   }
   ```
   
   
 
