All Products
Search
Document Center

CloudFlow:UpdateMapRun

Last Updated:Oct 27, 2025

Updates the configuration of a MapRun.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RequestId

string

No

The request ID.

3A44E113-9962-5B0B-AB92-14060EFE3164

FlowName

string

Yes

The name of the flow.

my_flow_name

ExecutionName

string

Yes

The name of the execution.

my_exec_name

MapRunName

string

Yes

The name of the MapRun. When an execution starts a MapRun, a MapRunStarted event is generated. The MapRun name is available in the output of the MapRunStarted event.

c39142f1345b196d678333c41f113100

Concurrency

integer

No

The concurrency limit for the MapRun runtime. The default quota for a single account is 300. You can request a quota increase in Quota Center.

1

ToleratedFailedCount

integer

No

The maximum number of failed items that are allowed.

100

ToleratedFailedPercentage

number

No

The maximum percentage of failed items that are allowed. The value must be between 0 and 100.

20

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

Id of the request

3A44E113-9962-5B0B-AB92-14060EFE3164

FlowName

string

The name of the flow.

my_flow_name

ExecutionName

string

The name of the execution.

my_exec_name

MapRunName

string

The name of the MapRun. When an execution starts a MapRun, a MapRunStarted event is generated. The MapRun name is available in the output of the MapRunStarted event.

c39142f1345b196d678333c41f113000

Concurrency

integer

The concurrency limit for the MapRun runtime.

1

ToleratedFailedCount

integer

The maximum number of failed items that are allowed.

100

ToleratedFailedPercentage

number

The maximum percentage of failed items that are allowed.

20

Examples

Success response

JSON format

{
  "RequestId": "3A44E113-9962-5B0B-AB92-14060EFE3164",
  "FlowName": "my_flow_name",
  "ExecutionName": "my_exec_name",
  "MapRunName": "c39142f1345b196d678333c41f113000",
  "Concurrency": 1,
  "ToleratedFailedCount": 100,
  "ToleratedFailedPercentage": 20
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidArgument Parameter error. Parameter error.
400 MissingRequiredHeader The HTTP header '%s' must be specified. The HTTP header '%s' must be specified.
400 MissingRequiredParams The HTTP query '%s' must be specified. The HTTP query '%s' must be specified.
400 ActionNotSupported The requested API operation '%s' is incorrect. Please check.
400 APIVersionNotSupported The requested API version '%s' is not supported yet. Please check.
400 EntityTooLarge The payload size exceeds maximum allowed size (%s bytes). The payload size exceeds maximum allowed size (%s bytes).
412 PreconditionFailed The resource to be modified has been changed. The resource to be modified has been changed. Please try again later.
500 InternalServerError An internal error has occurred. Please retry. An internal error has occurred. Please retry.
403 InvalidAccessKeyID The AccessKey ID %s is invalid. The AccessKey ID %s is invalid.
403 RequestTimeTooSkewed The difference between the request time %s and the current time %s is too large. The difference between the request time %s and the current time %s is too large.
403 SignatureNotMatch The request signature we calculated does not match the signature you provided. Check your access key and signing method. The calculated signature of the request does not match the signature you provided. Check your AccessKey Secret and signing algorithm.
403 AccessDenied The resources doesn't belong to you.
404 ExecutionNotExists Execution %s for flow %s does not exist. Execution %s for flow %s does not exist.
404 FlowNotExists Flow %s does not exist. Flow %s does not exist.
415 UnsupportedMediaType The content type must be "application/json". The content type must be "application/json".
429 ResourceThrottled The request is throttled. Please try again later. The request is throttled. Please try again later.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.