# StartChildWorkflowExecutionDecisionAttributes
<a name="API_StartChildWorkflowExecutionDecisionAttributes"></a>

Provides the details of the `StartChildWorkflowExecution` decision.

 **Access Control** 

You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
+ Use a `Resource` element with the domain name to limit the action to only specified domains.
+ Use an `Action` element to allow or deny permission to call this action.
+ Constrain the following parameters by using a `Condition` element with the appropriate keys.
  +  `tagList.member.N` – The key is "swf:tagList.N" where N is the tag number from 0 to 4, inclusive.
  +  `taskList` – String constraint. The key is `swf:taskList.name`.
  +  `workflowType.name` – String constraint. The key is `swf:workflowType.name`.
  +  `workflowType.version` – String constraint. The key is `swf:workflowType.version`.

If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's `cause` parameter is set to `OPERATION_NOT_PERMITTED`. For details and example IAM policies, see [Using IAM to Manage Access to Amazon SWF Workflows](https://docs.aws.amazon.com/amazonswf/latest/developerguide/swf-dev-iam.html) in the *Amazon SWF Developer Guide*.

## Contents
<a name="API_StartChildWorkflowExecutionDecisionAttributes_Contents"></a>

 ** workflowId **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-workflowId"></a>
 The `workflowId` of the workflow execution.  
The specified string must not contain a `:` (colon), `/` (slash), `|` (vertical bar), or any control characters (`\u0000-\u001f` \$1 `\u007f-\u009f`). Also, it must *not* be the literal string `arn`.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Required: Yes

 ** workflowType **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-workflowType"></a>
 The type of the workflow execution to be started.  
Type: [WorkflowType](API_WorkflowType.md) object  
Required: Yes

 ** childPolicy **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-childPolicy"></a>
 If set, specifies the policy to use for the child workflow executions if the workflow execution being started is terminated by calling the [TerminateWorkflowExecution](API_TerminateWorkflowExecution.md) action explicitly or due to an expired timeout. This policy overrides the default child policy specified when registering the workflow type using [RegisterWorkflowType](API_RegisterWorkflowType.md).  
The supported child policies are:  
+  `TERMINATE` – The child executions are terminated.
+  `REQUEST_CANCEL` – A request to cancel is attempted for each child execution by recording a `WorkflowExecutionCancelRequested` event in its history. It is up to the decider to take appropriate actions when it receives an execution history with this event.
+  `ABANDON` – No action is taken. The child executions continue to run.
A child policy for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default child policy was specified at registration time then a fault is returned.
Type: String  
Valid Values: `TERMINATE | REQUEST_CANCEL | ABANDON`   
Required: No

 ** control **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-control"></a>
The data attached to the event that can be used by the decider in subsequent workflow tasks. This data isn't sent to the child workflow execution.  
Type: String  
Length Constraints: Maximum length of 32768.  
Required: No

 ** executionStartToCloseTimeout **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-executionStartToCloseTimeout"></a>
The total duration for this workflow execution. This overrides the defaultExecutionStartToCloseTimeout specified when registering the workflow type.  
The duration is specified in seconds, an integer greater than or equal to `0`. You can use `NONE` to specify unlimited duration.  
An execution start-to-close timeout for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default execution start-to-close timeout was specified at registration time then a fault is returned.
Type: String  
Length Constraints: Maximum length of 8.  
Required: No

 ** input **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-input"></a>
The input to be provided to the workflow execution.  
Type: String  
Length Constraints: Maximum length of 32768.  
Required: No

 ** lambdaRole **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-lambdaRole"></a>
The IAM role attached to the child workflow execution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1600.  
Required: No

 ** tagList **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-tagList"></a>
The list of tags to associate with the child workflow execution. A maximum of 5 tags can be specified. You can list workflow executions with a specific tag by calling [ListOpenWorkflowExecutions](API_ListOpenWorkflowExecutions.md) or [ListClosedWorkflowExecutions](API_ListClosedWorkflowExecutions.md) and specifying a [TagFilter](API_TagFilter.md).  
Type: Array of strings  
Array Members: Maximum number of 5 items.  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** taskList **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-taskList"></a>
The name of the task list to be used for decision tasks of the child workflow execution.  
A task list for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default task list was specified at registration time then a fault is returned.
The specified string must not start or end with whitespace. It must not contain a `:` (colon), `/` (slash), `|` (vertical bar), or any control characters (`\u0000-\u001f` \$1 `\u007f-\u009f`). Also, it must *not* be the literal string `arn`.  
Type: [TaskList](API_TaskList.md) object  
Required: No

 ** taskPriority **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-taskPriority"></a>
 A task priority that, if set, specifies the priority for a decision task of this workflow execution. This overrides the defaultTaskPriority specified when registering the workflow type. Valid values are integers that range from Java's `Integer.MIN_VALUE` (-2147483648) to `Integer.MAX_VALUE` (2147483647). Higher numbers indicate higher priority.  
For more information about setting task priority, see [Setting Task Priority](https://docs.aws.amazon.com/amazonswf/latest/developerguide/programming-priority.html) in the *Amazon SWF Developer Guide*.  
Type: String  
Required: No

 ** taskStartToCloseTimeout **   <a name="SWF-Type-StartChildWorkflowExecutionDecisionAttributes-taskStartToCloseTimeout"></a>
Specifies the maximum duration of decision tasks for this workflow execution. This parameter overrides the `defaultTaskStartToCloseTimout` specified when registering the workflow type using [RegisterWorkflowType](API_RegisterWorkflowType.md).  
The duration is specified in seconds, an integer greater than or equal to `0`. You can use `NONE` to specify unlimited duration.  
A task start-to-close timeout for this workflow execution must be specified either as a default for the workflow type or through this parameter. If neither this parameter is set nor a default task start-to-close timeout was specified at registration time then a fault is returned.
Type: String  
Length Constraints: Maximum length of 8.  
Required: No

## See Also
<a name="API_StartChildWorkflowExecutionDecisionAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/swf-2012-01-25/StartChildWorkflowExecutionDecisionAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/swf-2012-01-25/StartChildWorkflowExecutionDecisionAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/swf-2012-01-25/StartChildWorkflowExecutionDecisionAttributes)