Expand description
The Amazon Simple Workflow Service (Amazon SWF) makes it easy to build applications that use Amazon's cloud to coordinate work across distributed components. In Amazon SWF, a task represents a logical unit of work that is performed by a component of your workflow. Coordinating tasks in a workflow involves managing intertask dependencies, scheduling, and concurrency in accordance with the logical flow of the application.
Amazon SWF gives you full control over implementing tasks and coordinating them without worrying about underlying complexities such as tracking their progress and maintaining their state.
This documentation serves as reference only. For a broader overview of the Amazon SWF programming model, see the Amazon SWF Developer Guide .
If you’re using the service, you’re probably looking for SwfClient and Swf.
Structs§
- Activity
Task Unit of work sent to an activity worker.
- Activity
Task Cancel Requested Event Attributes Provides the details of the
ActivityTaskCancelRequestedevent.- Activity
Task Canceled Event Attributes Provides the details of the
ActivityTaskCanceledevent.- Activity
Task Completed Event Attributes Provides the details of the
ActivityTaskCompletedevent.- Activity
Task Failed Event Attributes Provides the details of the
ActivityTaskFailedevent.- Activity
Task Scheduled Event Attributes Provides the details of the
ActivityTaskScheduledevent.- Activity
Task Started Event Attributes Provides the details of the
ActivityTaskStartedevent.- Activity
Task Status Status information about an activity task.
- Activity
Task Timed OutEvent Attributes Provides the details of the
ActivityTaskTimedOutevent.- Activity
Type Represents an activity type.
- Activity
Type Configuration Configuration settings registered with the activity type.
- Activity
Type Detail Detailed information about an activity type.
- Activity
Type Info Detailed information about an activity type.
- Activity
Type Infos Contains a paginated list of activity type information structures.
- Cancel
Timer Decision Attributes Provides the details of the
CancelTimerdecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Cancel
Timer Failed Event Attributes Provides the details of the
CancelTimerFailedevent.- Cancel
Workflow Execution Decision Attributes Provides the details of the
CancelWorkflowExecutiondecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Cancel
Workflow Execution Failed Event Attributes Provides the details of the
CancelWorkflowExecutionFailedevent.- Child
Workflow Execution Canceled Event Attributes Provide details of the
ChildWorkflowExecutionCanceledevent.- Child
Workflow Execution Completed Event Attributes Provides the details of the
ChildWorkflowExecutionCompletedevent.- Child
Workflow Execution Failed Event Attributes Provides the details of the
ChildWorkflowExecutionFailedevent.- Child
Workflow Execution Started Event Attributes Provides the details of the
ChildWorkflowExecutionStartedevent.- Child
Workflow Execution Terminated Event Attributes Provides the details of the
ChildWorkflowExecutionTerminatedevent.- Child
Workflow Execution Timed OutEvent Attributes Provides the details of the
ChildWorkflowExecutionTimedOutevent.- Close
Status Filter Used to filter the closed workflow executions in visibility APIs by their close status.
- Complete
Workflow Execution Decision Attributes Provides the details of the
CompleteWorkflowExecutiondecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Complete
Workflow Execution Failed Event Attributes Provides the details of the
CompleteWorkflowExecutionFailedevent.- Continue
AsNew Workflow Execution Decision Attributes Provides the details of the
ContinueAsNewWorkflowExecutiondecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
Constrain the following parameters by using a
Conditionelement with the appropriate keys.-
tag– A tag used to identify the workflow execution -
taskList– String constraint. The key isswf:taskList.name. -
workflowType.version– String constraint. The key isswf: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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Continue
AsNew Workflow Execution Failed Event Attributes Provides the details of the
ContinueAsNewWorkflowExecutionFailedevent.- Count
Closed Workflow Executions Input - Count
Open Workflow Executions Input - Count
Pending Activity Tasks Input - Count
Pending Decision Tasks Input - Decision
Specifies a decision made by the decider. A decision can be one of these types:
-
CancelTimer– Cancels a previously started timer and records aTimerCanceledevent in the history. -
CancelWorkflowExecution– Closes the workflow execution and records aWorkflowExecutionCanceledevent in the history. -
CompleteWorkflowExecution– Closes the workflow execution and records aWorkflowExecutionCompletedevent in the history . -
ContinueAsNewWorkflowExecution– Closes the workflow execution and starts a new workflow execution of the same type using the same workflow ID and a unique run Id. AWorkflowExecutionContinuedAsNewevent is recorded in the history. -
FailWorkflowExecution– Closes the workflow execution and records aWorkflowExecutionFailedevent in the history. -
RecordMarker– Records aMarkerRecordedevent in the history. Markers can be used for adding custom information in the history for instance to let deciders know that they don't need to look at the history beyond the marker event. -
RequestCancelActivityTask– Attempts to cancel a previously scheduled activity task. If the activity task was scheduled but has not been assigned to a worker, then it is canceled. If the activity task was already assigned to a worker, then the worker is informed that cancellation has been requested in the response to RecordActivityTaskHeartbeat. -
RequestCancelExternalWorkflowExecution– Requests that a request be made to cancel the specified external workflow execution and records aRequestCancelExternalWorkflowExecutionInitiatedevent in the history. -
ScheduleActivityTask– Schedules an activity task. -
SignalExternalWorkflowExecution– Requests a signal to be delivered to the specified external workflow execution and records aSignalExternalWorkflowExecutionInitiatedevent in the history. -
StartChildWorkflowExecution– Requests that a child workflow execution be started and records aStartChildWorkflowExecutionInitiatedevent in the history. The child workflow execution is a separate workflow execution with its own history. -
StartTimer– Starts a timer for this workflow execution and records aTimerStartedevent in the history. This timer fires after the specified delay and record aTimerFiredevent.
Access Control
If you grant permission to use
RespondDecisionTaskCompleted, you can use IAM policies to express permissions for the list of decisions returned by this action as if they were members of the API. Treating decisions as a pseudo API maintains a uniform conceptual model and helps keep policies readable. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.Decision Failure
Decisions can fail for several reasons
-
The ordering of decisions should follow a logical flow. Some decisions might not make sense in the current context of the workflow execution and therefore fails.
-
A limit on your account was reached.
-
The decision lacks sufficient permissions.
One of the following events might be added to the history to indicate an error. The event attribute's
causeparameter indicates the cause. Ifcauseis set toOPERATIONNOTPERMITTED, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
ScheduleActivityTaskFailed– AScheduleActivityTaskdecision failed. This could happen if the activity type specified in the decision isn't registered, is in a deprecated state, or the decision isn't properly configured. -
RequestCancelActivityTaskFailed– ARequestCancelActivityTaskdecision failed. This could happen if there is no open activity task with the specified activityId. -
StartTimerFailed– AStartTimerdecision failed. This could happen if there is another open timer with the same timerId. -
CancelTimerFailed– ACancelTimerdecision failed. This could happen if there is no open timer with the specified timerId. -
StartChildWorkflowExecutionFailed– AStartChildWorkflowExecutiondecision failed. This could happen if the workflow type specified isn't registered, is deprecated, or the decision isn't properly configured. -
SignalExternalWorkflowExecutionFailed– ASignalExternalWorkflowExecutiondecision failed. This could happen if theworkflowIDspecified in the decision was incorrect. -
RequestCancelExternalWorkflowExecutionFailed– ARequestCancelExternalWorkflowExecutiondecision failed. This could happen if theworkflowIDspecified in the decision was incorrect. -
CancelWorkflowExecutionFailed– ACancelWorkflowExecutiondecision failed. This could happen if there is an unhandled decision task pending in the workflow execution. -
CompleteWorkflowExecutionFailed– ACompleteWorkflowExecutiondecision failed. This could happen if there is an unhandled decision task pending in the workflow execution. -
ContinueAsNewWorkflowExecutionFailed– AContinueAsNewWorkflowExecutiondecision failed. This could happen if there is an unhandled decision task pending in the workflow execution or the ContinueAsNewWorkflowExecution decision was not configured correctly. -
FailWorkflowExecutionFailed– AFailWorkflowExecutiondecision failed. This could happen if there is an unhandled decision task pending in the workflow execution.
The preceding error events might occur due to an error in the decider logic, which might put the workflow execution in an unstable state The cause field in the event structure for the error event indicates the cause of the error.
A workflow execution may be closed by the decider by returning one of the following decisions when completing a decision task:
CompleteWorkflowExecution,FailWorkflowExecution,CancelWorkflowExecutionandContinueAsNewWorkflowExecution. AnUnhandledDecisionfault is returned if a workflow closing decision is specified and a signal or activity event had been added to the history while the decision task was being performed by the decider. Unlike the above situations which are logic issues, this fault is always possible because of race conditions in a distributed system. The right action here is to call RespondDecisionTaskCompleted without any decisions. This would result in another decision task with these new events included in the history. The decider should handle the new events and may decide to close the workflow execution.How to Code a Decision
You code a decision by first setting the decision type field to one of the above decision values, and then set the corresponding attributes field shown below:
-
- Decision
Task A structure that represents a decision task. Decision tasks are sent to deciders in order for them to make decisions.
- Decision
Task Completed Event Attributes Provides the details of the
DecisionTaskCompletedevent.- Decision
Task Scheduled Event Attributes Provides details about the
DecisionTaskScheduledevent.- Decision
Task Started Event Attributes Provides the details of the
DecisionTaskStartedevent.- Decision
Task Timed OutEvent Attributes Provides the details of the
DecisionTaskTimedOutevent.- Deprecate
Activity Type Input - Deprecate
Domain Input - Deprecate
Workflow Type Input - Describe
Activity Type Input - Describe
Domain Input - Describe
Workflow Execution Input - Describe
Workflow Type Input - Domain
Configuration Contains the configuration settings of a domain.
- Domain
Detail Contains details of a domain.
- Domain
Info Contains general information about a domain.
- Domain
Infos Contains a paginated collection of DomainInfo structures.
- Execution
Time Filter Used to filter the workflow executions in visibility APIs by various time-based rules. Each parameter, if specified, defines a rule that must be satisfied by each returned query result. The parameter values are in the Unix Time format. For example:
"oldestDate": 1325376070.- External
Workflow Execution Cancel Requested Event Attributes Provides the details of the
ExternalWorkflowExecutionCancelRequestedevent.- External
Workflow Execution Signaled Event Attributes Provides the details of the
ExternalWorkflowExecutionSignaledevent.- Fail
Workflow Execution Decision Attributes Provides the details of the
FailWorkflowExecutiondecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Fail
Workflow Execution Failed Event Attributes Provides the details of the
FailWorkflowExecutionFailedevent.- GetWorkflow
Execution History Input - History
Paginated representation of a workflow history for a workflow execution. This is the up to date, complete and authoritative record of the events related to all tasks and events in the life of the workflow execution.
- History
Event Event within a workflow execution. A history event can be one of these types:
-
ActivityTaskCancelRequested– ARequestCancelActivityTaskdecision was received by the system. -
ActivityTaskCanceled– The activity task was successfully canceled. -
ActivityTaskCompleted– An activity worker successfully completed an activity task by calling RespondActivityTaskCompleted. -
ActivityTaskFailed– An activity worker failed an activity task by calling RespondActivityTaskFailed. -
ActivityTaskScheduled– An activity task was scheduled for execution. -
ActivityTaskStarted– The scheduled activity task was dispatched to a worker. -
ActivityTaskTimedOut– The activity task timed out. -
CancelTimerFailed– Failed to process CancelTimer decision. This happens when the decision isn't configured properly, for example no timer exists with the specified timer Id. -
CancelWorkflowExecutionFailed– A request to cancel a workflow execution failed. -
ChildWorkflowExecutionCanceled– A child workflow execution, started by this workflow execution, was canceled and closed. -
ChildWorkflowExecutionCompleted– A child workflow execution, started by this workflow execution, completed successfully and was closed. -
ChildWorkflowExecutionFailed– A child workflow execution, started by this workflow execution, failed to complete successfully and was closed. -
ChildWorkflowExecutionStarted– A child workflow execution was successfully started. -
ChildWorkflowExecutionTerminated– A child workflow execution, started by this workflow execution, was terminated. -
ChildWorkflowExecutionTimedOut– A child workflow execution, started by this workflow execution, timed out and was closed. -
CompleteWorkflowExecutionFailed– The workflow execution failed to complete. -
ContinueAsNewWorkflowExecutionFailed– The workflow execution failed to complete after being continued as a new workflow execution. -
DecisionTaskCompleted– The decider successfully completed a decision task by calling RespondDecisionTaskCompleted. -
DecisionTaskScheduled– A decision task was scheduled for the workflow execution. -
DecisionTaskStarted– The decision task was dispatched to a decider. -
DecisionTaskTimedOut– The decision task timed out. -
ExternalWorkflowExecutionCancelRequested– Request to cancel an external workflow execution was successfully delivered to the target execution. -
ExternalWorkflowExecutionSignaled– A signal, requested by this workflow execution, was successfully delivered to the target external workflow execution. -
FailWorkflowExecutionFailed– A request to mark a workflow execution as failed, itself failed. -
MarkerRecorded– A marker was recorded in the workflow history as the result of aRecordMarkerdecision. -
RecordMarkerFailed– ARecordMarkerdecision was returned as failed. -
RequestCancelActivityTaskFailed– Failed to process RequestCancelActivityTask decision. This happens when the decision isn't configured properly. -
RequestCancelExternalWorkflowExecutionFailed– Request to cancel an external workflow execution failed. -
RequestCancelExternalWorkflowExecutionInitiated– A request was made to request the cancellation of an external workflow execution. -
ScheduleActivityTaskFailed– Failed to process ScheduleActivityTask decision. This happens when the decision isn't configured properly, for example the activity type specified isn't registered. -
SignalExternalWorkflowExecutionFailed– The request to signal an external workflow execution failed. -
SignalExternalWorkflowExecutionInitiated– A request to signal an external workflow was made. -
StartActivityTaskFailed– A scheduled activity task failed to start. -
StartChildWorkflowExecutionFailed– Failed to process StartChildWorkflowExecution decision. This happens when the decision isn't configured properly, for example the workflow type specified isn't registered. -
StartChildWorkflowExecutionInitiated– A request was made to start a child workflow execution. -
StartTimerFailed– Failed to process StartTimer decision. This happens when the decision isn't configured properly, for example a timer already exists with the specified timer Id. -
TimerCanceled– A timer, previously started for this workflow execution, was successfully canceled. -
TimerFired– A timer, previously started for this workflow execution, fired. -
TimerStarted– A timer was started for the workflow execution due to aStartTimerdecision. -
WorkflowExecutionCancelRequested– A request to cancel this workflow execution was made. -
WorkflowExecutionCanceled– The workflow execution was successfully canceled and closed. -
WorkflowExecutionCompleted– The workflow execution was closed due to successful completion. -
WorkflowExecutionContinuedAsNew– The workflow execution was closed and a new execution of the same type was created with the same workflowId. -
WorkflowExecutionFailed– The workflow execution closed due to a failure. -
WorkflowExecutionSignaled– An external signal was received for the workflow execution. -
WorkflowExecutionStarted– The workflow execution was started. -
WorkflowExecutionTerminated– The workflow execution was terminated. -
WorkflowExecutionTimedOut– The workflow execution was closed because a time out was exceeded.
-
- Lambda
Function Completed Event Attributes Provides the details of the
LambdaFunctionCompletedevent. It isn't set for other event types.- Lambda
Function Failed Event Attributes Provides the details of the
LambdaFunctionFailedevent. It isn't set for other event types.- Lambda
Function Scheduled Event Attributes Provides the details of the
LambdaFunctionScheduledevent. It isn't set for other event types.- Lambda
Function Started Event Attributes Provides the details of the
LambdaFunctionStartedevent. It isn't set for other event types.- Lambda
Function Timed OutEvent Attributes Provides details of the
LambdaFunctionTimedOutevent.- List
Activity Types Input - List
Closed Workflow Executions Input - List
Domains Input - List
Open Workflow Executions Input - List
Tags ForResource Input - List
Tags ForResource Output - List
Workflow Types Input - Marker
Recorded Event Attributes Provides the details of the
MarkerRecordedevent.- Pending
Task Count Contains the count of tasks in a task list.
- Poll
ForActivity Task Input - Poll
ForDecision Task Input - Record
Activity Task Heartbeat Input - Record
Marker Decision Attributes Provides the details of the
RecordMarkerdecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Record
Marker Failed Event Attributes Provides the details of the
RecordMarkerFailedevent.- Register
Activity Type Input - Register
Domain Input - Register
Workflow Type Input - Request
Cancel Activity Task Decision Attributes Provides the details of the
RequestCancelActivityTaskdecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Request
Cancel Activity Task Failed Event Attributes Provides the details of the
RequestCancelActivityTaskFailedevent.- Request
Cancel External Workflow Execution Decision Attributes Provides the details of the
RequestCancelExternalWorkflowExecutiondecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Request
Cancel External Workflow Execution Failed Event Attributes Provides the details of the
RequestCancelExternalWorkflowExecutionFailedevent.- Request
Cancel External Workflow Execution Initiated Event Attributes Provides the details of the
RequestCancelExternalWorkflowExecutionInitiatedevent.- Request
Cancel Workflow Execution Input - Resource
Tag Tags are key-value pairs that can be associated with Amazon SWF state machines and activities.
Tags may only contain unicode letters, digits, whitespace, or these symbols:
_ . : / = + - @.- Respond
Activity Task Canceled Input - Respond
Activity Task Completed Input - Respond
Activity Task Failed Input - Respond
Decision Task Completed Input Input data for a TaskCompleted response to a decision task.
- Run
Specifies the
runIdof a workflow execution.- Schedule
Activity Task Decision Attributes Provides the details of the
ScheduleActivityTaskdecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
Constrain the following parameters by using a
Conditionelement with the appropriate keys.-
activityType.name– String constraint. The key isswf:activityType.name. -
activityType.version– String constraint. The key isswf:activityType.version. -
taskList– String constraint. The key isswf:taskList.name.
-
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Schedule
Activity Task Failed Event Attributes Provides the details of the
ScheduleActivityTaskFailedevent.- Schedule
Lambda Function Decision Attributes Decision attributes specified in
scheduleLambdaFunctionDecisionAttributeswithin the list of decisionsdecisionspassed to RespondDecisionTaskCompleted.- Schedule
Lambda Function Failed Event Attributes Provides the details of the
ScheduleLambdaFunctionFailedevent. It isn't set for other event types.- Signal
External Workflow Execution Decision Attributes Provides the details of the
SignalExternalWorkflowExecutiondecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Signal
External Workflow Execution Failed Event Attributes Provides the details of the
SignalExternalWorkflowExecutionFailedevent.- Signal
External Workflow Execution Initiated Event Attributes Provides the details of the
SignalExternalWorkflowExecutionInitiatedevent.- Signal
Workflow Execution Input - Start
Child Workflow Execution Decision Attributes Provides the details of the
StartChildWorkflowExecutiondecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
Constrain the following parameters by using a
Conditionelement 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 isswf:taskList.name. -
workflowType.name– String constraint. The key isswf:workflowType.name. -
workflowType.version– String constraint. The key isswf: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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Start
Child Workflow Execution Failed Event Attributes Provides the details of the
StartChildWorkflowExecutionFailedevent.- Start
Child Workflow Execution Initiated Event Attributes Provides the details of the
StartChildWorkflowExecutionInitiatedevent.- Start
Lambda Function Failed Event Attributes Provides the details of the
StartLambdaFunctionFailedevent. It isn't set for other event types.- Start
Timer Decision Attributes Provides the details of the
StartTimerdecision.Access Control
You can use IAM policies to control this decision's access to Amazon SWF resources as follows:
-
Use a
Resourceelement with the domain name to limit the action to only specified domains. -
Use an
Actionelement to allow or deny permission to call this action. -
You cannot use an IAM policy to constrain this action's parameters.
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
causeparameter is set toOPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.-
- Start
Timer Failed Event Attributes Provides the details of the
StartTimerFailedevent.- Start
Workflow Execution Input - SwfClient
- A client for the Amazon SWF API.
- TagFilter
Used to filter the workflow executions in visibility APIs based on a tag.
- TagResource
Input - Task
List Represents a task list.
- Terminate
Workflow Execution Input - Timer
Canceled Event Attributes Provides the details of the
TimerCanceledevent.- Timer
Fired Event Attributes Provides the details of the
TimerFiredevent.- Timer
Started Event Attributes Provides the details of the
TimerStartedevent.- Undeprecate
Activity Type Input - Undeprecate
Domain Input - Undeprecate
Workflow Type Input - Untag
Resource Input - Workflow
Execution Represents a workflow execution.
- Workflow
Execution Cancel Requested Event Attributes Provides the details of the
WorkflowExecutionCancelRequestedevent.- Workflow
Execution Canceled Event Attributes Provides the details of the
WorkflowExecutionCanceledevent.- Workflow
Execution Completed Event Attributes Provides the details of the
WorkflowExecutionCompletedevent.- Workflow
Execution Configuration The configuration settings for a workflow execution including timeout values, tasklist etc. These configuration settings are determined from the defaults specified when registering the workflow type and those specified when starting the workflow execution.
- Workflow
Execution Continued AsNew Event Attributes Provides the details of the
WorkflowExecutionContinuedAsNewevent.- Workflow
Execution Count Contains the count of workflow executions returned from CountOpenWorkflowExecutions or CountClosedWorkflowExecutions
- Workflow
Execution Detail Contains details about a workflow execution.
- Workflow
Execution Failed Event Attributes Provides the details of the
WorkflowExecutionFailedevent.- Workflow
Execution Filter Used to filter the workflow executions in visibility APIs by their
workflowId.- Workflow
Execution Info Contains information about a workflow execution.
- Workflow
Execution Infos Contains a paginated list of information about workflow executions.
- Workflow
Execution Open Counts Contains the counts of open tasks, child workflow executions and timers for a workflow execution.
- Workflow
Execution Signaled Event Attributes Provides the details of the
WorkflowExecutionSignaledevent.- Workflow
Execution Started Event Attributes Provides details of
WorkflowExecutionStartedevent.- Workflow
Execution Terminated Event Attributes Provides the details of the
WorkflowExecutionTerminatedevent.- Workflow
Execution Timed OutEvent Attributes Provides the details of the
WorkflowExecutionTimedOutevent.- Workflow
Type Represents a workflow type.
- Workflow
Type Configuration The configuration settings of a workflow type.
- Workflow
Type Detail Contains details about a workflow type.
- Workflow
Type Filter Used to filter workflow execution query results by type. Each parameter, if specified, defines a rule that must be satisfied by each returned result.
- Workflow
Type Info Contains information about a workflow type.
- Workflow
Type Infos Contains a paginated list of information structures about workflow types.
Enums§
- Count
Closed Workflow Executions Error - Errors returned by CountClosedWorkflowExecutions
- Count
Open Workflow Executions Error - Errors returned by CountOpenWorkflowExecutions
- Count
Pending Activity Tasks Error - Errors returned by CountPendingActivityTasks
- Count
Pending Decision Tasks Error - Errors returned by CountPendingDecisionTasks
- Deprecate
Activity Type Error - Errors returned by DeprecateActivityType
- Deprecate
Domain Error - Errors returned by DeprecateDomain
- Deprecate
Workflow Type Error - Errors returned by DeprecateWorkflowType
- Describe
Activity Type Error - Errors returned by DescribeActivityType
- Describe
Domain Error - Errors returned by DescribeDomain
- Describe
Workflow Execution Error - Errors returned by DescribeWorkflowExecution
- Describe
Workflow Type Error - Errors returned by DescribeWorkflowType
- GetWorkflow
Execution History Error - Errors returned by GetWorkflowExecutionHistory
- List
Activity Types Error - Errors returned by ListActivityTypes
- List
Closed Workflow Executions Error - Errors returned by ListClosedWorkflowExecutions
- List
Domains Error - Errors returned by ListDomains
- List
Open Workflow Executions Error - Errors returned by ListOpenWorkflowExecutions
- List
Tags ForResource Error - Errors returned by ListTagsForResource
- List
Workflow Types Error - Errors returned by ListWorkflowTypes
- Poll
ForActivity Task Error - Errors returned by PollForActivityTask
- Poll
ForDecision Task Error - Errors returned by PollForDecisionTask
- Record
Activity Task Heartbeat Error - Errors returned by RecordActivityTaskHeartbeat
- Register
Activity Type Error - Errors returned by RegisterActivityType
- Register
Domain Error - Errors returned by RegisterDomain
- Register
Workflow Type Error - Errors returned by RegisterWorkflowType
- Request
Cancel Workflow Execution Error - Errors returned by RequestCancelWorkflowExecution
- Respond
Activity Task Canceled Error - Errors returned by RespondActivityTaskCanceled
- Respond
Activity Task Completed Error - Errors returned by RespondActivityTaskCompleted
- Respond
Activity Task Failed Error - Errors returned by RespondActivityTaskFailed
- Respond
Decision Task Completed Error - Errors returned by RespondDecisionTaskCompleted
- Signal
Workflow Execution Error - Errors returned by SignalWorkflowExecution
- Start
Workflow Execution Error - Errors returned by StartWorkflowExecution
- TagResource
Error - Errors returned by TagResource
- Terminate
Workflow Execution Error - Errors returned by TerminateWorkflowExecution
- Undeprecate
Activity Type Error - Errors returned by UndeprecateActivityType
- Undeprecate
Domain Error - Errors returned by UndeprecateDomain
- Undeprecate
Workflow Type Error - Errors returned by UndeprecateWorkflowType
- Untag
Resource Error - Errors returned by UntagResource
Traits§
- Swf
- Trait representing the capabilities of the Amazon SWF API. Amazon SWF clients implement this trait.