Updates a flow.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateFlow

The operation that you want to perform. Set the value to UpdateFlow.

Name String Yes flow

The name of the flow. The name must be unique in an Alibaba Cloud account.
Definition String No version: v1.0\ntype: flow\nname: test\nsteps:\n - type: pass\n name: mypass

The definition of the flow. It must comply with the Flow Definition Language (FDL) syntax.

Description String No test definition

The description of the flow.
RequestId String No testRequestId

The ID of the request. If this parameter is not specified, the system generates a random value.

RoleArn String No acs:ram::${accountID}:${role}

The ARN of the specified RAM role that Serverless Workflow uses to assume the role when Serverless Workflow executes a task.

Type String No FDL

The type of the flow. Set the value to FDL.

Response parameters

Parameter Type Example Description
CreatedTime String 2019-01-01T01:01:01.001Z

The time when the flow was created.
Definition String version: v1.0\ntype: flow\nname: test\nsteps:\n - type: pass\n name: mypass

The definition of the flow.
Description String test definition

The description of the flow.
Id String e589e092-e2c0-4dee-b306-3574ddfdddf5ccc3

The unique ID of the flow.
LastModifiedTime String 2019-01-01T01:01:01.001Z

The time when the flow was last modified.
Name String flow

The name of the flow.
RequestId String testRequestID

The ID of the request.
RoleArn String acs:ram::${accountID}:${role}

The ARN of the specified RAM role.
Type String FDL

The type of the flow.

Examples

Sample requests


http(s)://[Endpoint]/? Action=UpdateFlow
&Name=flow
&<Common request parameters>

Sample success responses

XML format 

<CreateFlowResponseponse>
    <Description>Response in XML format is not supported. </Description>
</CreateFlowResponseponse>

JSON format 

{
	"Name":"flow",
	"Description":"test definition",
	"CreatedTime":"2019-01-01T01:01:01.001Z",
	"Type":"FDL",
	"RequestId":"testRequestID",
	"Id":"e589e092-e2c0-4dee-b306-3574ddfdddf5ccc3",
	"LastModifiedTime":"2019-01-01T01:01:01.001Z",
	"Version":"1",
	"RoleArn":"acs:ram::${accountID}:${role}",
	"Definition":"version:&#160;v1.0
type:&#160;flow
steps:
&#160;-&#160;type:&#160;pass
&#160;name:&#160;mypass"
}

Error codes

HttpCode Error code Error message Description
403 AccessDenied The resources doesn't belong to you. The error message returned because request authentication failed. For more information, see the actual error message.
400 ActionNotSupported The requested API operation '%s' is incorrect. Please check. The error message returned because the request method is wrong. For more information, see the API documentation and check the spelling.
400 APIVersionNotSupported The requested API version '%s' is not supported yet. Please check. The error message returned because the requested API version is wrong. For more information, see Make API requests.
409 ConcurrentUpdateError Update conflict, please retry. The error message returned because concurrent write operations are performed on the requested resource. Wait for a while and then try again.
404 FlowNotExists Flow %s does not exist. The error message returned because the requested resource does not exist. Ensure that the flow has been created.
500 InternalServerError An internal error has occurred. Please retry. The error message returned because an internal server error has occurred. Try again later.
403 InvalidAccessKeyID The AccessKey ID %s is invalid. The error message returned because the AccessKey ID is invalid.
400 InvalidArgument Parameter error. The error message returned because the request parameters are invalid. For more information, see the actual error message.
400 MissingRequiredHeader The HTTP header '%s' must be specified. The error message returned because the required request parameters are missing. For more information, see the actual error message.
400 MissingRequiredParams The HTTP query '%s' must be specified. The error message returned because the required request parameters are missing. For more information, see the actual error message.
412 PreconditionFailed The resource to be modified has been changed. The error message returned because resource view or check for updates failed, and the resource may be modified. Try again later.
403 RequestTimeTooSkewed The difference between the request time %s and the current time %s is too large. The error message returned because your request time is wrong. The request has been identified as invalid. For more information, see the "Common parameters" section.
429 ResourceThrottled The request is throttled. Please try again later. The error message returned because the request is throttled for some reason. Try again later.
403 SignatureNotMatch The request signature we calculated does not match the signature you provided. Check your access key and signing method. The error message returned because the request signature we calculated does not match the request signature you provided. Check your signature algorithm and AccessKey secret.
415 UnsupportedMediaType The content type must be "application/json". The error message returned because the type of the request message body is wrong.

For a list of error codes, visit the API Error Center.