# 编辑基线任务 - UpdateFactoryBaseline
#### 功能介绍
编辑基线任务。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dataartsstudio/making_request.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
PUT /v2/{project_id}/factory/aiops/{instance_id}/baseline/{baseline_id}
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                        |
|:---|:---|:---|:---|
| project_id  | 是    | String | 项目ID，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。                     |
| instance_id | 是    | String | DataArts Studio实例ID，获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 |
| baseline_id | 是    | String | 基线任务ID，可通过查询基线任务列表接口获取。                                                                                                   |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| X-Auth-Token | 否    | String | IAM Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值），使用Token认证时必选，最小长度：0，最大长度：4096。                                                                                                                                |
| X-Project-Id | 否    | String | project_id，项目编号。获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。 多project场景采用AK/SK认证的接口请求，则该字段必选。 |
| workspace    | 是    | String | 工作空间ID，获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。                                                                                                            |
| Content-Type | 是    | String | 默认值：application/json;charset=UTF-8 可选，有Body体的情况下必选，没有Body体则无需填写和校验。                                                                               |
   
表3请求Body参数 
| 参数                    | 是否必选 | 参数类型                                                                                                             | 描述                                                                                                           |
|:---|:---|:---|:---|
| workspace_id          | 是    | String                                                                                                           | 工作空间ID，获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 |
| name                  | 是    | String                                                                                                           | 基线任务名称。只能包含：英文字母、数字、中文、中划线、下划线和点号，且长度不超过128位。                                                                |
| owner_name            | 是    | String                                                                                                           | 责任人用户名称。                                                                                                     |
| type                  | 是    | String                                                                                                           | 基线任务类型。取值为 DAY和HOUR。                                                                                         |
| sla_task_ids          | 是    | Array of strings                                                                                                 | 保障作业ID列表，作业ID可通过查询作业详情接口获取。                                                                                  |
| priority              | 是    | Integer                                                                                                          | 优先级，取值范围是1到5。                                                                                                |
| buffer                | 是    | Integer                                                                                                          | 预警余量。单位毫秒，取值范围在0到86400000之间，且必须是整数分钟级别的毫秒。                                                                   |
| enable                | 是    | Boolean                                                                                                          | 是否生效，取值为true或者false。默认为true。                                                                                 |
| alarm_enable          | 是    | Boolean                                                                                                          | 报警是否打开，取值为true或者false，默认为true。                                                                               |
| sign_enable           | 是    | Boolean                                                                                                          | 基线签署是否打开，取值为true或者false。默认为false。                                                                            |
| sla_hour              | 是    | String                                                                                                           | 天基线承诺小时。                                                                                                     |
| sla_min               | 是    | String                                                                                                           | 天基线承诺分钟。                                                                                                     |
| baseline_alarm_enable | 是    | Boolean                                                                                                          | 基线报警是否打开，取值为true或者false。                                                                                     |
| smn_topics            | 否    | Array of [SmnTopicRequest] objects | SMN主题列表。                                                                                                     |
| event_smn_topics      | 否    | Array of [SmnTopicRequest] objects | 事件报警信息。                                                                                                      |
| event_alarm           | 否    | Array of strings                                                                                                 | 事件告警开启类型，取值为ERROR：出错，SLOW_DOWN：变慢。                                                                           |
| period                | 否    | Array of [PeriodObject] objects       | 当type取值为HOUR时，该值需要填写。                                                                                        |
   
 表4SmnTopicRequest 
| 参数                 | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| name               | 否    | String  | 主题名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| urn                | 否    | String  | smn urn，可以在SMN服务查看对应主题的urn。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| notify_method      | 是    | String  | 告警方式：主题、责任人、值班表和钉钉机器人，取值如下： - SUBJECT: 主题   - OWNER： 责任人   - DUTY_SCHEDULE: 值班表   - DINGDING: 钉钉机器人    |
| protocol           | 否    | String  | 告警协议：短信、邮件、电话，示例：\["email"\] "email"：邮件传输协议,"sms"：短信传输协议,"callnotify":语音, "dingding":个人钉钉。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| other_persons      | 否    | String  | 抄送人，示例：\["lin","hua"\]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| max_send_times     | 是    | Integer | 最大告警次数，取值为 \[1, 50\]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| send_interval      | 是    | Integer | 告警间隔，取值为\[5, 60\]，单位：分钟。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| duty_schedule_name | 否    | String  | 值班表名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| smn_config_name    | 否    | String  | 机器人名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| enable_recovery    | 否    | Boolean | 是否开启恢复通知。开启后，当作业失败后重跑成功时发送恢复通知。 仅对remind_type=1（运行异常）的规则生效。删除主规则时会自动级联删除恢复子规则。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
 表5PeriodObject 
| 参数          | 是否必选 | 参数类型    | 描述             |
|:---|:---|:---|:---|
| period_num  | 是    | Integer | 周期，取值为1到24。    |
| period_time | 是    | String  | 小时:分钟，样例：00:59 |
   
#### 响应参数
**状态码：200**
成功，状态响应200。
**状态码：400**
表6响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误描述。 |
   
#### 请求示例
编辑基线任务。
```
PUT /v2/62099355b894428e8916573ae635f1f9/factory/aiops/65212faf-91e2-4914-a116-be71b1aaf49e/baseline/1241325900378950667
{
  "workspace_id" : "62fbba734e634c5087656fc3ff7adf34",
  "name" : "3333334457",
  "owner_name" : "test",
  "type" : "DAY",
  "sla_task_ids" : [ "935280" ],
  "priority" : 3,
  "buffer" : 3600000,
  "enable" : true,
  "alarm_enable" : true,
  "sign_enable" : false,
  "sla_hour" : "00",
  "sla_min" : "00",
  "baseline_alarm_enable" : true,
  "smn_topics" : [ {
    "name" : "",
    "urn" : "",
    "notify_method" : "DUTY_SCHEDULE",
    "protocol" : "[\"sms\",\"email\",\"callnotify\"]",
    "other_persons" : null,
    "max_send_times" : 1,
    "send_interval" : 60,
    "duty_schedule_name" : "444",
    "smn_config_name" : null
  } ],
  "event_alarm" : [ ]
}
```
#### 响应示例
**状态码：400**
失败，返回信息。
```
{
  "error_msg" : "The value of parameter [owner_name] does not exist, please check again its value.",
  "error_code" : "DLF.21203"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | 成功，状态响应200。 |
| 400 | 失败，返回信息。    |