Help Center> Object Storage Service> API Reference> APIs> Data+> Resuming a Failed Workflow Instance

Resuming a Failed Workflow Instance

Functions

Resumes a workflow instance that fails to be executed. Once resumed, the execution continues from where the workflow instance failed. Succeeded parts are not executed again.

Request Syntax

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

Request parameters

Table 1 Parameters

Parameter

Mandatory

Type

Description

Constraints

execution_name

Yes

string

Workflow instance name

The workflow instance must be an existing one.

x-workflow-graph-name

Yes

string

Workflow name

The workflow must be an existing one.

Request Headers

This request uses common headers. For details, see Table 3.

Request Elements

This request contains no message parameters.

Response Syntax

HTTP/1.1 status_code 
Date: date 
Content-Length: length 
X-Request-ID: obs request id

json body

Response Headers

The response to the request uses common headers. For details, see Table 1.

Response Elements

Table 2 Response elements

Parameter

Type

Description

execution_urn

String

URN of a running instance

restored_at

String

Start time for resuming a running instance

execution_name

String

Name of a running instance

Error Responses

No special error responses are returned. For details about error responses, see Table 2.

Sample Request

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

Sample Response

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"
}