# 恢复失败状态的工作流实例-RestoreFailedWorkflowExecution
#### 功能介绍
本接口用于恢复一个执行失败状态的工作流实例。恢复后，工作流实例将从上次失败的状态处继续执行，而工作流步骤中已经执行成功的状态不会再执行。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dwr/dwr_07_0050.html)。
#### URI
POST /v3/{project_id}/workflows/{graph_name}/workflowexecution/{execution_name}/retry
#### 请求消息样式
```
PUT /v2/workflowexecutions/{execution_name}?x-workflow-graph-name={graph_name} HTTP/1.1
Host: obs.cn-north-4.myhuaweicloud.com 
Authorization: authorization
Content-Type: application/json
Content-Length: length
Date: date
```
#### 请求消息参数
表1参数说明 
| 名称                    | 是否必选 | 参数类型   | 说明      | 约束           |
|:---|:---|:---|:---|:---|
| execution_name        | 是    | string | 工作流实例名称 | 是已存在的工作流实例名称 |
| x-workflow-graph-name | 是    | string | 工作流名称   | 是已存在的工作流     |
   
#### 请求消息头
该请求使用公共消息头，具体参见[表3](https://support.huaweicloud.com/api-dwr/dwr_07_0008.html#dwr_07_0008__zh-cn_topic_0121682347_table1986821153312)。
#### 请求消息元素
该请求消息中不使用消息参数。
#### 响应消息样式
```
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)。
#### 响应消息元素
表2响应元素 
| 名称             | 参数类型   | 说明           |
|:---|:---|:---|
| execution_urn  | String | 运行实例的URN。    |
| restored_at    | String | 运行实例的恢复启动时间。 |
| execution_name | String | 运行实例的名字。     |
   
#### 错误响应消息
无特殊错误，所有错误已经包含在[错误码](https://support.huaweicloud.com/api-dwr/ErrorCode_0.html)中。
#### 请求示例
```
PUT /v2/workflowexecutions/{execution_name}?x-workflow-graph-name={graph_name} HTTP/1.1
Host: obs.cn-north-4.myhuaweicloud.com 
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo=
Content-Type: application/json
Content-Length: 0
Date: Thu, 27 Aug 2020 12:38:10 GMT
```
#### 响应示例
```
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>",
    "restored_at": "2020-04-23T13:37:43.847Z"
}
```