You can call this operation to modify a workflow that contains graphic information.


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 Required ModifyFlowForWeb

The operation that you want to perform. For API requests using the HTTP or HTTPS URL, this parameter is required. Set the value to ModifyFlowForWeb.

ClusterId String Required A23BD131A862****

The ID of the cluster.

CreateCluster Boolean Yes false

Indicates whether the cluster was created from the cluster template.

  • If this parameter is set to true, the ID of the cluster is cluster template ID:CT-XXXXXX.
  • If this parameter is set to false, the ID of the cluster is cluster ID:C-XXXXXX.
Graph String Required {"nodes":[{"id":"48d474ea","index":0,"spmAnchorId":"0.0.0.i0.766645eb2cmNtQ","attribute":{"type":"START"},"shape":"startControlNode","type":"node","y":250,"size":"80*34","x":500},{"id":"7ba480b3","index":1,"spmAnchorId":"5176.8250060.0.i19.771e28d0IPNQGE","attribute":{"jobType":"SHELL","jobId":"FJ-7BE1062897B19D25","type":"JOB"},"config":{"hostName":""},"label":"fail_job","shape":"shellJobNode","type":"node","y":398.5,"size":"170*34","x":470.5},{"id":"33202d60","index":2,"spmAnchorId":"5176.8250060.0.i23.771e28d0IPNQGE","attribute":{"type":"END"},"shape":"endControlNode","type":"node","y":562.5,"size":"80*34","x":430.5}],"edges":[{"id":"28167ea0","index":3,"source":"48d474ea","sourceAnchor":0,"target":"7ba480b3","targetAnchor":0},{"id":"e8d5ff52","index":4,"source":"7ba480b3","sourceAnchor":1,"target":"33202d60","targetAnchor":0}]}

The information of the directed acyclic graph (DAG) of the workflow.

Id String Required F-7A39731FE719****

The ID of the workflow.

ProjectId String Required FP-257A173659F5****

The ID of the project.

Region ID String Required cn-hangzhou

The ID of the region to which the cluster belongs.

Name String No my_flow

The name of the workflow. The name can be up to 64 characters in length. The name must be unique in a project.

Status String No STOP_SCHEDULE

The status of the workflow. Supports STOP_SCHEDULE and UNDER_SCHEDULE.

Description String No This is the description of a workflow

The description of the workflow. Length constraint: maximum length of 256.

Periodic Boolean No true

Specifies whether to enable periodic scheduling.

StartSchedule Long No 1538017814000

The start time of the schedule. It is a timestamp whose data type is long. Example: System.currentTimeMillis () it must be less than EndSchedule. This parameter is required if the CronExpr parameter is not left empty.

EndSchedule Long No 1538018814000

The end time of the scheduling of the workflow. It is a timestamp whose data type is long. For example, you can set the value to System.currentTimeMillis.() .

CronExpr String No 0 0 0-23/1 * * ?

The Cron expression of the time-based scheduling of the workflow. For more information, see A Cron Expressions.

HostName String No emr-header-1.cluster-123456

The information of the host on which the workflow instance is running. The format is emr-header-1.cluster-123456.

AlertConf String No {"items":[{"enable":true,"eventId":"EMR-210401001","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]},{"enable":true,"eventId":"EMR-110401015","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]},{"enable":true,"eventId":"EMR-110401002","alertUserGroupIdList":["AUG-b79bb29bb6e14ddd89674a242623851b"],"alertDingDingGroupList":["ADG-af1f9689d6194e2dbd89927d5c515172"]}]}

The alarm notification configuration. Currently, eventId supports the following configuration:

  • EMR-210401001 (workflow failure alarm)
  • EMR-110401002 (workflow success notification)
  • EMR-110401015 (monitoring of workflow node failures)
AlertUserGroupBizId String No -

A deprecated parameter.

AlertDingDingGroupBizId String No -

A deprecated parameter.

ParentFlowList String No [F-123456]

The information of the parent workflow.

ParentCategory String No FC-F2495319DA05****

The ID of the parent directory.

Response parameters

Parameter Type Example Description
Data Boolean True

The result of the operation.

RequestId String 243D5A48-96A5-4C0C-8966-93CBF65635ED

The ID of the request.


Sample requests

http(s)://[Endpoint]/? Action=ModifyFlowForWeb
&Graph=Graph information
&Example_common request parameters_>

Sample success responses

XML format


JSON format


Error codes

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