# API异步启动工作流-AsyncInvokeApiStartWorkflow
#### 功能介绍
本接口用于API方式异步启动已有工作流，产生工作流实例。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dwr/dwr_07_0050.html)。
#### URI
POST /v3/{project_id}/workflows/{graph_name}/execute
#### 请求消息样式
```
POST /v2/workflows/{graph_name} HTTP/1.1
Host: obs.cn-north-4.myhuaweicloud.com 
Authorization: authorization
Content-Type: application/json
Content-Length: length
Date: date
json body
```
#### 请求消息参数
表1请求消息参数 
| 名称         | 是否必选 | 参数类型   | 说明     | 约束                                           |
|:---|:---|:---|:---|:---|
| graph_name | 是    | String | 工作流名称。 | 名称必须以字母或数字开头，只能由字母、数字、下划线和中划线组成，长度小于等于64个字符。 |
   
#### 请求消息头
该请求使用公共消息头，具体参见[表3](https://support.huaweicloud.com/api-dwr/dwr_07_0008.html#dwr_07_0008__zh-cn_topic_0121682347_table1986821153312)。
#### 请求消息元素
表2参数说明 
| 名称     | 是否必选 | 参数类型   | 说明           | 约束                             |
|:---|:---|:---|:---|:---|
| bucket | 是    | String | 桶名。          | -                              |
| object | 是    | String | 对象名。         | -                              |
| inputs | 否    | Json   | 工作流中可修改参数列表。 | Map中的key必须是工作流中的parameter中的名字。 |
   
#### 响应消息样式
```
HTTP/1.1 status_code 
Date: date 
Content-Length: length 
X-Request-ID: obs request id
json body
```
#### 响应消息头
该请求的响应消息使用公共消息头，具体请参考[响应消息头](https://support.huaweicloud.com/api-dwr/dwr_07_0011.html#dwr_07_0011__zh-cn_topic_0170155703_zh-cn_topic_0113746487_section61333484715)。
#### 响应消息元素
表3响应元素 
| 名称             | 参数类型   | 说明        |
|:---|:---|:---|
| execution_urn  | String | 运行实例的URN。 |
| started_at     | String | 运行实例启动时间。 |
| execution_name | String | 运行实例的名字。  |
   
#### 错误响应消息
无特殊错误，所有错误已经包含在[错误码](https://support.huaweicloud.com/api-dwr/ErrorCode_0.html)中。
#### 请求示例
```
POST /v2/workflows/{graph_name} HTTP/1.1
Host: obs.cn-north-4.myhuaweicloud.com 
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo=
Content-Type: application/json
Content-Length: 100
Date: Thu, 27 Aug 2020 12:38:10 GMT
{
    "bucket": "demo-bucket",
    "object": "/mpc/demo.mp4",
    "inputs": {
        "<parameter-name>": <parameter-value>
    }
}
```
#### 响应示例
```
HTTP/1.1 200 OK 
Date: Thu, 27 Aug 2020 12:38:10 GMT 
Content-Length: 100 
X-Request-ID: 000001742FE8FB3CCA20173B00807C43
{
    "execution_urn": "urn:fgs:<region_id>:<project_id>:execution:<graph_name>:<execution_name>:<domain_id>",
    "execution_name": "<execution_name>",
    "started_at": "2020-04-23T13:37:43.847Z"
}
```