edit-icon download-icon

Modify an execution plan

Last Updated: Dec 28, 2017

Modify an execution plan.

Request parameters

Field Type Required? Default Value Description
RegionId String Yes None The region ID of the execution plan.
Id String Yes None Execution plan Id.
Name String Yes None Execution plan name.
Strategy String Yes None The running strategy of the execution plan. RUN_MANUALLY: manual running. The execution plan is run only when the user triggers it; SCHEDULE: periodical scheduling. The execution plan is automatically run at specified time.
StartTime Long No, required when Strategy==SCHEDULE None The time when the periodical scheduling takes effect.
TimeUnit String No, required when Strategy==SCHEDULE None The time interval for periodical scheduling. DAY: the execution plan is scheduled every day; HOUR: the execution plan is scheduled every hour.
TimeInterval Integer No, required when Strategy==SCHEDULE None Time interval. If the time unit is DAY: only 1 is allowed; if the time unit is HOUR: a value of 1-23 is allowed.
JobIdList Array<String> Yes None The job Id array, similar to: [“J-24H770B821D3C56A”,”J-8A37Y0B821D3C90R”].
CreateClusterOnDemand Boolean No False Whether to dynamically create the cluster on demand.
ClusterId String No, required when CreateClusterOnDemand=false None The associated existing cluster Id.
When CreateClusterOnDemand=true, automatically create cluster information on demand
ClusterName Boolean No None The name of the newly created cluster.
ZoneId String No None Zone Id, similar to cn-hangzhou-b.
LogEnable Boolean No None Enable log storage? To use this function, ensure you have activated OSS.
LogPath String No, required when LogEnable==true None Path of logs saved on OSS, similar to oss://bucketname/dir.
SecurityGroupId String Yes None Any security group Id. You can create one in the ECS and then use it. Note: If you are using an existing security group, the default security group policy will apply: Port 22 for incoming requests only and all ports for outgoing requests.
IsOpenPublicIp Boolean No True Enable public IP address? If yes, 8 MB bandwidth will be available by default.
EmrVer String Yes None E-MapReduce version number. Such as “EMR 1.0.0” and “EMR 1.1.0”.
ClusterType String Yes None Cluster type. It can be HADOOP, and Hbase is not supported.
HighAvailabilityEnable Boolean No False Enable high availability mode? If yes, 2 master nodes are required to be active.
EcsOrder EcsOrder Yes None The ECS information contained in the cluster, in JSON format. It is similar to the format below: [{“nodeCount”:3, “nodeType”:”MASTER”, “instanceType”:”ecs.n1.large”, “diskType”:”CLOUD_EFFICIENCY”, “diskCapacity”:80,diskCount”:1}]. 
BootstrapActions List BootstrapAction No None Bootstrap action list. A maximum of 16 actions are allowed. Otherwise, only the first 16 actions are retained.
Configurations String No None Provide an OSS file path and the file content can be found in the User Manual.
VpcId String No None vpc ID.
VSwitchId String No None ID of the switch in VPC.
NetType String No None classic/vpc, classic by default.
IoOptimized Boolean No True Enable I/O optimization?
InstanceGeneration String No No ECS instance series, and the value is ecs-1 or ecs-2.

Returned parameters

Public returned parameters.


Request example

  1. https://emr.aliyuncs.com/?Action=ModifyExecutionPlan
  2. &Id=WF-13A570B821D4BAB3
  3. &CreateClusterOnDemand=false
  4. &ClusterId=C-358770B821D4B293
  5. &JobIdList=%5B%22J-24H770B821D3C56A%22%2C%22J-8A37Y0B821D3C90R%22%5D
  6. &Name=%E9%A2%84%E5%8F%91%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B_SSD%E7%9B%98HDFS%E5%86%99
  7. &StartTime=1
  8. &TimeInterval=1
  9. &Strategy=RUN_MANUALLY
  10. &RegionId=cn-hangzhou

Returned format

JSON format

  1. {
  2. "RequestId": "34B08619-2636-49F9-AB4E-CD8D347B1E07"
  3. }
Thank you! We've received your feedback.