# 创建execution
#### 功能介绍
开始执行测序流程。
#### URI
POST /v1/executions
#### 请求消息
**请求参数**
请求参数如[表1]所示。
 表1请求参数 
| 参数                    | 是否必选 | 参数类型                                        | 描述                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| name                  | 是    | String                                      | 执行结果名称。 输入字符最大长度为63字节，以小写字母开头，允许出现中划线(-)、数字和小写字母，且必须以小写字母或数字结尾。                                                                                                                                                        |
| cluster_id            | 否    | String                                      | 如果使用已有集群，此处填写执行测序所使用的集群ID。                                                                                                                                                                                                                           |
| workflow_id           | 是    | String                                      | 执行测序所使用的流程ID。                                                                                                                                                                                                                                        |
| sfs_pvc_name          | 是    | String                                      | sfs存储名称。                                                                                                                                                                                                                                             |
| namespace             | 否    | String                                      | cce集群下可用namespace/cci命名空间。如果为空，则cce默认为default namespace。                                                                                                                                                                                             |
| description           | 否    | String                                      | 执行结果的描述，如果为空，则执行结果的描述为空。 取值范围：输入字符最大长度为255，中文算单个字符，不能包含\<\>#%\&字符。                                                                                                                                               |
| inputs_json           | 否    | Object                                      | 流程输入参数，当为空时，将使用流程文件的inputs中定义的默认值。                                                                                                                                                                                                                   |
| timeout               | 否    | Integer64                                   | 超时时间，如果不填，则默认是1440分钟。                                                                                                                                                                                                                                |
| priority              | 否    | Integer64                                   | execution的调度优先级。默认值为0，取值范围\[0，999\]。数据越大优先越高。                                                                                                                                                                                                        |
| target                | 是    | String                                      | execution执行的环境类型。 - cce  - cci   |
| label                 | 否    | Object                                      | execution的标签，可自定义，样式为"key：value"。                                                                                                                                                                                                                    |
| notification          | 否    | [表2] | execution执行结束时发送通知的配置。                                                                                                                                                                                                                               |
| advanced_options      | 否    | [表3]  | 高级配置，如设置镜像拉取策略。                                                                                                                                                                                                                                      |
| ref_bucket_name       | 否    | String                                      | 参考组obs桶名名称。                                                                                                                                                                                                                                          |
| data_bucket_name      | 否    | String                                      | 数据obs桶名称。                                                                                                                                                                                                                                            |
| enterprise_project_id | 否    | String                                      | execution的企业项目id，默认为"0"                                                                                                                                                                                                                              |
   
 表2notification 
| 参数        | 是否必选 | 参数类型                                        | 描述                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| events    | 否    | Array of string                             | 触发通知的事件，支持execution执行失败和成功时发送通知。 取值范围： - exec_failed  - exec_succeeded   |
| endpoints | 是    | [表4] | 通知接收终端配置，可选项为邮件和短信。                                                                                                                                                                                                                                                                                                             |
   
 表3advanced_options 
| 参数                | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| image_pull_policy | 否    | String | 镜像拉取策略。默认IfNotPresent。支持选项： - IfNotPresent：在镜像已存在时，不再拉取镜像；    - Always：总是拉取镜像；  - Never：不再拉取镜像。   |
| job_retry_count   | 否    | String | job重试次数。cce默认为3次，cci默认为0次。 取值范围：大于0的整数。                                                                                                                                                                                                                                                                                                                                                                  |
   
 表4endpoints 
| 参数    | 是否必选 | 参数类型            | 描述           |
|:---|:---|:---|:---|
| email | 否    | Array of string | 通知接受者邮箱地址列表。 |
| sms   | 否    | Array of string | 通知接受者手机号列表。  |
   
**请求示例**
```
POST /v1/executions HTTP/1.1 
Host:Host Server   
Content-Type:application/json
{
    "name": "gcs-execution",
    "workflow_id": "3323db80-d1f6-9295-e8be-0242cdfc38e9",
    "cluster_id": "b2d6bb38-a065-11e8-b0e6-0255ac105768",
    "inputs_json": {
        "cpu": "4c",
"memory": "32G",
    },
    "sfs_pvc_name": "gene-sfs-1111",
    "timeout": 1440,
    "target": "cce",
    "enterprise_project_id":"0"
}
```
#### 响应消息
**响应参数**
请求成功的响应参数如[表5]所示。
 表5成功响应参数 
| 参数 | 参数类型   | 描述      |
|:---|:---|:---|
| 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)所示。
#### 状态码
- 正常 状态码如[表6]所示。
  
 表6状态码 
| 状态码 | 描述        |
|:---|:---|
| 201 | 创建执行结果成功。 |
   
- 异常 状态码如[6.3-状态码](https://support.huaweicloud.com/api-gcs/gcs_api_006_001.html)所示。