# 操作execution
#### 功能介绍
启动/停止/更新执行任务。
停止任务成功后即停止下发新Job至环境，已下发的Job将持续运行直至自然结束。若想停止Job，请在环境对应的服务内删除Job，或直接删除该任务。
#### URI
PUT /v1/executions/{execution_id}
表1参数说明 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                         |
|:---|:---|:---|:---|
| execution_id | 是    | String | 执行结果ID，即[创建execution](https://support.huaweicloud.com/api-gcs/gcs_api_005_0020.html)接口返回值。 |
   
#### 请求消息
**请求参数**
请求参数如[表2]所示。
 表2请求参数 
| 参数          | 是否必选 | 参数类型      | 取值范围                | 描述                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|:---|
| action      | 是    | String    | cancel/retry/update | 执行结果操作名称，支持选项为： - cancel: 取消  - retry: 重试  - update: 更新priority   |
| inputs_json | 否    | Map       | 根据其流程定义             | 流程输入参数，当为空时，将使用流程文件的inputs中定义的默认值。                                                                                                                                                                                                                                                                                                                             |
| timeout     | 否    | Integer64 | 为空取默认值，默认值为1440分钟   | 超时时间，如果不填，则默认是1440分钟。                                                                                                                                                                                                                                                                                                                                          |
| priority    | 否    | Integer64 | 默认值为0，取值范围\[0，999\] | execution的调度优先级，默认值为0，取值范围\[0，999\]。数值越高优先级越高。                                                                                                                                                                                                                                                                                                                 |
   
**请求示例**
```
PUT /v1/executions/e19d3faf-9f04-9685-e5c0-fbe8d40b96cd HTTP/1.1 
Host:Host Server   
Content-Type:application/json
{
    "action": "cancel",
 }
```
#### 响应消息
**响应参数**
请求成功的响应参数如[表3]所示。
 表3成功响应参数 
| 参数 | 参数类型   | 描述      |
|:---|:---|:---|
| id | String | 执行结果ID。 |
   
**响应示例**
```
{
    "id": "e19d3faf-9f04-9685-e5c0-fbe8d40b96cd"
}
```
请求失败的响应参数如[表9](https://support.huaweicloud.com/api-gcs/gcs_api_005_002.html#gcs_api_005_002__table104171158104518)所示。
#### 状态码
- 正常 状态码如[表4]所示。
  
 表4状态码 
| 状态码 | 描述        |
|:---|:---|
| 200 | 操作执行任务成功。 |
   
- 异常 状态码如[6.3-状态码](https://support.huaweicloud.com/api-gcs/gcs_api_006_001.html)所示。