
# 根据对象ID新增触发器 - AddTrigger
#### 功能介绍
为对象添加对象触发器。
#### URI
POST *华为云Astro轻应用域名* /u-route/baas/metadata/v1.0/Object/*{object_id}*/Trigger
表1路径参数 
| 参数        | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| object_id | 是    | String | **参数解释**： 对象的ID值，可通过调用[查询所有自定义对象 - QueryCustomObject](https://support.huaweicloud.com/api-astrozero/astrozero_api_0033.html)接口查看（响应消息中的"id"）。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
#### 请求参数
表2请求Body参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| name        | 是    | String | **参数解释**： 新增触发器的名称。 **约束限制**： 不涉及。 **取值范围**： 必须以英文字母开头，只能由英文字母，数字和单下划线组成，没有连续的下划线，不能以单下划线结尾，且长度不能超过64个字符。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| label       | 否    | String | **参数解释**： 新增触发器的标签。 **约束限制**： 不涉及。 **取值范围**： 1\~64个字符。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| description | 否    | String | **参数解释**： 触发器的描述信息。 **约束限制**： 不涉及。 **取值范围**： 1\~255个字符。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| script      | 是    | String | **参数解释**： 脚本名，即基于哪个脚本实现触发器的功能。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| jscode      | 否    | string | **参数解释**： 触发器中的JavaScript代码。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| active      | 否    | String | **参数解释**： 是否激活触发器。 **约束限制**： 不涉及。 **取值范围**： - true：表示激活。  - false：表示不激活。   **默认取值**： false                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| event       | 否    | String | **参数解释**： 满足什么条件时启动触发器。 **约束限制**： 不涉及。 **取值范围**： - BeforeInsert：在插入记录前启动触发器。  - AfterInsert：在插入记录后启动触发器。  - BeforeUpdate：在更新记录前启动触发器。  - AfterUpdate：在更新记录后启动触发器。  - BeforeDelete：在删除记录前启动触发器。  - AfterDelete：在删除记录后启动触发器。   **默认取值**： 不涉及。 |
   
#### 响应参数
表3响应参数 
| 参数      | 参数类型   | 描述                                                                                                                                                                                                                                              |
|:---|:---|:---|
| resCode | String | **参数解释**： 返回码。 **取值范围**： 如果返回"0"代表请求成功，其他错误码说明请参考[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。 |
| resMsg  | String | **参数解释**： 返回消息。 **取值范围**： 成功返回"Success"，其他情况会返回具体的错误信息。                                                                            |
| result  | string | **参数解释**： 成功返回会返回Object的一个ID值。 **取值范围**： 不涉及。                                                                                      |
   
#### 请求示例
根据object_id新增trigger。
```
POST https://华为云Astro轻应用域名/u-route/baas/metadata/v1.0/Object/cust000000aKtFZpERvc/Trigger
{
    "name": "Trigger_01",
    "label": "Trigger 01",
    "description": null,
    "script": "string",
    "jscode": "Hello, world;rn",
    "active": true,
    "event": "BeforeInsert"
}
```
#### 响应示例
```
{
    "resCode": "0",
    "resMsg": "Success",
    "result": "001i000000SIrEi3E0a8"
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-astrozero/astrozero_api_0081.html)。
#### 错误码
错误码请参见[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。
