Client library for Amazon Simple Workflow Service
npm install --save @datafire/amazonaws_swf
let amazonaws_swf = require('@datafire/amazonaws_swf').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
.then(data => {
console.log(data);
});
Amazon Simple Workflow Service
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 .
amazonaws_swf.CountClosedWorkflowExecutions({
"domain": null
}, context)
- input
object
- closeStatusFilter
- status required
- closeTimeFilter
- latestDate
- oldestDate required
- domain required
- executionFilter
- workflowId required
- startTimeFilter
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- closeStatusFilter
- output WorkflowExecutionCount
amazonaws_swf.CountOpenWorkflowExecutions({
"domain": null,
"startTimeFilter": null
}, context)
- input
object
- domain required
- executionFilter
- workflowId required
- startTimeFilter required
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- output WorkflowExecutionCount
amazonaws_swf.CountPendingActivityTasks({
"domain": null,
"taskList": null
}, context)
- input
object
- domain required
- taskList required
- name required
- output PendingTaskCount
amazonaws_swf.CountPendingDecisionTasks({
"domain": null,
"taskList": null
}, context)
- input
object
- domain required
- taskList required
- name required
- output PendingTaskCount
amazonaws_swf.DeprecateActivityType({
"domain": null,
"activityType": null
}, context)
- input
object
- activityType required
- name required
- version required
- domain required
- activityType required
Output schema unknown
amazonaws_swf.DeprecateDomain({
"name": null
}, context)
- input
object
- name required
Output schema unknown
amazonaws_swf.DeprecateWorkflowType({
"domain": null,
"workflowType": null
}, context)
- input
object
- domain required
- workflowType required
- name required
- version required
Output schema unknown
amazonaws_swf.DescribeActivityType({
"domain": null,
"activityType": null
}, context)
- input
object
- activityType required
- name required
- version required
- domain required
- activityType required
- output ActivityTypeDetail
amazonaws_swf.DescribeDomain({
"name": null
}, context)
- input
object
- name required
- output DomainDetail
amazonaws_swf.DescribeWorkflowExecution({
"domain": null,
"execution": null
}, context)
- input
object
- domain required
- execution required
- runId required
- workflowId required
- output WorkflowExecutionDetail
amazonaws_swf.DescribeWorkflowType({
"domain": null,
"workflowType": null
}, context)
- input
object
- domain required
- workflowType required
- name required
- version required
- output WorkflowTypeDetail
amazonaws_swf.GetWorkflowExecutionHistory({
"domain": null,
"execution": null
}, context)
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required
- execution required
- runId required
- workflowId required
- maximumPageSize
- nextPageToken
- reverseOrder
- maximumPageSize
- output History
amazonaws_swf.ListActivityTypes({
"domain": null,
"registrationStatus": null
}, context)
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required
- maximumPageSize
- name
- nextPageToken
- registrationStatus required
- reverseOrder
- maximumPageSize
- output ActivityTypeInfos
amazonaws_swf.ListClosedWorkflowExecutions({
"domain": null
}, context)
- input
object
- maximumPageSize
string
- nextPageToken
string
- closeStatusFilter
- status required
- closeTimeFilter
- latestDate
- oldestDate required
- domain required
- executionFilter
- workflowId required
- maximumPageSize
- nextPageToken
- reverseOrder
- startTimeFilter
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- maximumPageSize
- output WorkflowExecutionInfos
amazonaws_swf.ListDomains({
"registrationStatus": null
}, context)
- input
object
- maximumPageSize
string
- nextPageToken
string
- maximumPageSize
- nextPageToken
- registrationStatus required
- reverseOrder
- maximumPageSize
- output DomainInfos
amazonaws_swf.ListOpenWorkflowExecutions({
"domain": null,
"startTimeFilter": null
}, context)
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required
- executionFilter
- workflowId required
- maximumPageSize
- nextPageToken
- reverseOrder
- startTimeFilter required
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- maximumPageSize
- output WorkflowExecutionInfos
amazonaws_swf.ListTagsForResource({
"resourceArn": null
}, context)
- input
object
- resourceArn required
- output ListTagsForResourceOutput
amazonaws_swf.ListWorkflowTypes({
"domain": null,
"registrationStatus": null
}, context)
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required
- maximumPageSize
- name
- nextPageToken
- registrationStatus required
- reverseOrder
- maximumPageSize
- output WorkflowTypeInfos
amazonaws_swf.PollForActivityTask({
"domain": null,
"taskList": null
}, context)
- input
object
- domain required
- identity
- taskList required
- name required
- output ActivityTask
amazonaws_swf.PollForDecisionTask({
"domain": null,
"taskList": null
}, context)
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required
- identity
- maximumPageSize
- nextPageToken
- reverseOrder
- taskList required
- name required
- maximumPageSize
- output DecisionTask
amazonaws_swf.RecordActivityTaskHeartbeat({
"taskToken": null
}, context)
- input
object
- details
- taskToken required
- output ActivityTaskStatus
amazonaws_swf.RegisterActivityType({
"domain": null,
"name": null,
"version": null
}, context)
- input
object
- defaultTaskHeartbeatTimeout
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskScheduleToCloseTimeout
- defaultTaskScheduleToStartTimeout
- defaultTaskStartToCloseTimeout
- description
- domain required
- name required
- version required
Output schema unknown
amazonaws_swf.RegisterDomain({
"name": null,
"workflowExecutionRetentionPeriodInDays": null
}, context)
- input
object
- tags
- items ResourceTag
- description
- name required
- workflowExecutionRetentionPeriodInDays required
- tags
Output schema unknown
amazonaws_swf.RegisterWorkflowType({
"domain": null,
"name": null,
"version": null
}, context)
- input
object
- defaultChildPolicy
- defaultExecutionStartToCloseTimeout
- defaultLambdaRole
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskStartToCloseTimeout
- description
- domain required
- name required
- version required
Output schema unknown
amazonaws_swf.RequestCancelWorkflowExecution({
"domain": null,
"workflowId": null
}, context)
- input
object
- domain required
- runId
- workflowId required
Output schema unknown
amazonaws_swf.RespondActivityTaskCanceled({
"taskToken": null
}, context)
- input
object
- details
- taskToken required
Output schema unknown
amazonaws_swf.RespondActivityTaskCompleted({
"taskToken": null
}, context)
- input
object
- result
- taskToken required
Output schema unknown
amazonaws_swf.RespondActivityTaskFailed({
"taskToken": null
}, context)
- input
object
- details
- reason
- taskToken required
Output schema unknown
amazonaws_swf.RespondDecisionTaskCompleted({
"taskToken": null
}, context)
- input
object
- decisions
- items Decision
- executionContext
- taskToken required
- decisions
Output schema unknown
amazonaws_swf.SignalWorkflowExecution({
"domain": null,
"workflowId": null,
"signalName": null
}, context)
- input
object
- domain required
- input
- runId
- signalName required
- workflowId required
Output schema unknown
amazonaws_swf.StartWorkflowExecution({
"domain": null,
"workflowId": null,
"workflowType": null
}, context)
- input
object
- childPolicy
- domain required
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowId required
- workflowType required
- name required
- version required
- output Run
amazonaws_swf.TagResource({
"resourceArn": null,
"tags": null
}, context)
- input
object
- tags required
- items ResourceTag
- resourceArn required
- tags required
Output schema unknown
amazonaws_swf.TerminateWorkflowExecution({
"domain": null,
"workflowId": null
}, context)
- input
object
- childPolicy
- details
- domain required
- reason
- runId
- workflowId required
Output schema unknown
amazonaws_swf.UndeprecateActivityType({
"domain": null,
"activityType": null
}, context)
- input
object
- activityType required
- name required
- version required
- domain required
- activityType required
Output schema unknown
amazonaws_swf.UndeprecateDomain({
"name": null
}, context)
- input
object
- name required
Output schema unknown
amazonaws_swf.UndeprecateWorkflowType({
"domain": null,
"workflowType": null
}, context)
- input
object
- domain required
- workflowType required
- name required
- version required
Output schema unknown
amazonaws_swf.UntagResource({
"resourceArn": null,
"tagKeys": null
}, context)
- input
object
- resourceArn required
- tagKeys required
- items ResourceTagKey
Output schema unknown
- ActivityId
string
- ActivityTask
object
: Unit of work sent to an activity worker.- activityId required
- activityType required
- name required
- version required
- input
- startedEventId required
- taskToken required
- workflowExecution required
- runId required
- workflowId required
- ActivityTaskCancelRequestedEventAttributes
object
: Provides the details of theActivityTaskCancelRequested
event.- activityId required
- decisionTaskCompletedEventId required
- ActivityTaskCanceledEventAttributes
object
: Provides the details of theActivityTaskCanceled
event.- details
- latestCancelRequestedEventId
- scheduledEventId required
- startedEventId required
- ActivityTaskCompletedEventAttributes
object
: Provides the details of theActivityTaskCompleted
event.- result
- scheduledEventId required
- startedEventId required
- ActivityTaskFailedEventAttributes
object
: Provides the details of theActivityTaskFailed
event.- details
- reason
- scheduledEventId required
- startedEventId required
- ActivityTaskScheduledEventAttributes
object
: Provides the details of theActivityTaskScheduled
event.- activityId required
- activityType required
- name required
- version required
- control
- decisionTaskCompletedEventId required
- heartbeatTimeout
- input
- scheduleToCloseTimeout
- scheduleToStartTimeout
- startToCloseTimeout
- taskList required
- name required
- taskPriority
- ActivityTaskStartedEventAttributes
object
: Provides the details of theActivityTaskStarted
event.- identity
- scheduledEventId required
- ActivityTaskStatus
object
: Status information about an activity task.- cancelRequested required
- ActivityTaskTimedOutEventAttributes
object
: Provides the details of theActivityTaskTimedOut
event.- details
- scheduledEventId required
- startedEventId required
- timeoutType required
- ActivityTaskTimeoutType
string
(values: START_TO_CLOSE, SCHEDULE_TO_START, SCHEDULE_TO_CLOSE, HEARTBEAT)
- ActivityType
object
: Represents an activity type.- name required
- version required
- ActivityTypeConfiguration
object
: Configuration settings registered with the activity type.- defaultTaskHeartbeatTimeout
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskScheduleToCloseTimeout
- defaultTaskScheduleToStartTimeout
- defaultTaskStartToCloseTimeout
- ActivityTypeDetail
object
: Detailed information about an activity type.- configuration required
- defaultTaskHeartbeatTimeout
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskScheduleToCloseTimeout
- defaultTaskScheduleToStartTimeout
- defaultTaskStartToCloseTimeout
- typeInfo required
- activityType required
- name required
- version required
- creationDate required
- deprecationDate
- description
- status required
- activityType required
- configuration required
- ActivityTypeInfo
object
: Detailed information about an activity type.- activityType required
- name required
- version required
- creationDate required
- deprecationDate
- description
- status required
- activityType required
- ActivityTypeInfoList
array
- items ActivityTypeInfo
- ActivityTypeInfos
object
: Contains a paginated list of activity type information structures.- nextPageToken
- typeInfos required
- items ActivityTypeInfo
- Arn
string
- CancelTimerDecisionAttributes
object
:Provides the details of the
CancelTimer
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. -
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
cause
parameter 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.- timerId required
-
- CancelTimerFailedCause
string
(values: TIMER_ID_UNKNOWN, OPERATION_NOT_PERMITTED)
- CancelTimerFailedEventAttributes
object
: Provides the details of theCancelTimerFailed
event.- cause required
- decisionTaskCompletedEventId required
- timerId required
- CancelWorkflowExecutionDecisionAttributes
object
:Provides the details of the
CancelWorkflowExecution
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. -
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
cause
parameter 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.- details
-
- CancelWorkflowExecutionFailedCause
string
(values: UNHANDLED_DECISION, OPERATION_NOT_PERMITTED)
- CancelWorkflowExecutionFailedEventAttributes
object
: Provides the details of theCancelWorkflowExecutionFailed
event.- cause required
- decisionTaskCompletedEventId required
- Canceled
boolean
- CauseMessage
string
- ChildPolicy
string
(values: TERMINATE, REQUEST_CANCEL, ABANDON)
- ChildWorkflowExecutionCanceledEventAttributes
object
: Provide details of theChildWorkflowExecutionCanceled
event.- details
- initiatedEventId required
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- ChildWorkflowExecutionCompletedEventAttributes
object
: Provides the details of theChildWorkflowExecutionCompleted
event.- initiatedEventId required
- result
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- ChildWorkflowExecutionFailedEventAttributes
object
: Provides the details of theChildWorkflowExecutionFailed
event.- details
- initiatedEventId required
- reason
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- ChildWorkflowExecutionStartedEventAttributes
object
: Provides the details of theChildWorkflowExecutionStarted
event.- initiatedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- ChildWorkflowExecutionTerminatedEventAttributes
object
: Provides the details of theChildWorkflowExecutionTerminated
event.- initiatedEventId required
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- ChildWorkflowExecutionTimedOutEventAttributes
object
: Provides the details of theChildWorkflowExecutionTimedOut
event.- initiatedEventId required
- startedEventId required
- timeoutType required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- CloseStatus
string
(values: COMPLETED, FAILED, CANCELED, TERMINATED, CONTINUED_AS_NEW, TIMED_OUT)
- CloseStatusFilter
object
: Used to filter the closed workflow executions in visibility APIs by their close status.- status required
- CompleteWorkflowExecutionDecisionAttributes
object
:Provides the details of the
CompleteWorkflowExecution
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. -
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
cause
parameter 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.- result
-
- CompleteWorkflowExecutionFailedCause
string
(values: UNHANDLED_DECISION, OPERATION_NOT_PERMITTED)
- CompleteWorkflowExecutionFailedEventAttributes
object
: Provides the details of theCompleteWorkflowExecutionFailed
event.- cause required
- decisionTaskCompletedEventId required
- ContinueAsNewWorkflowExecutionDecisionAttributes
object
:Provides the details of the
ContinueAsNewWorkflowExecution
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.-
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
cause
parameter 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.- childPolicy
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowTypeVersion
-
- ContinueAsNewWorkflowExecutionFailedCause
string
(values: UNHANDLED_DECISION, WORKFLOW_TYPE_DEPRECATED, WORKFLOW_TYPE_DOES_NOT_EXIST, DEFAULT_EXECUTION_START_TO_CLOSE_TIMEOUT_UNDEFINED, DEFAULT_TASK_START_TO_CLOSE_TIMEOUT_UNDEFINED, DEFAULT_TASK_LIST_UNDEFINED, DEFAULT_CHILD_POLICY_UNDEFINED, CONTINUE_AS_NEW_WORKFLOW_EXECUTION_RATE_EXCEEDED, OPERATION_NOT_PERMITTED)
- ContinueAsNewWorkflowExecutionFailedEventAttributes
object
: Provides the details of theContinueAsNewWorkflowExecutionFailed
event.- cause required
- decisionTaskCompletedEventId required
- Count
integer
- CountClosedWorkflowExecutionsInput
object
- closeStatusFilter
- status required
- closeTimeFilter
- latestDate
- oldestDate required
- domain required
- executionFilter
- workflowId required
- startTimeFilter
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- closeStatusFilter
- CountOpenWorkflowExecutionsInput
object
- domain required
- executionFilter
- workflowId required
- startTimeFilter required
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- CountPendingActivityTasksInput
object
- domain required
- taskList required
- name required
- CountPendingDecisionTasksInput
object
- domain required
- taskList required
- name required
- Data
string
- Decision
object
:Specifies a decision made by the decider. A decision can be one of these types:
-
CancelTimer
– Cancels a previously started timer and records aTimerCanceled
event in the history. -
CancelWorkflowExecution
– Closes the workflow execution and records aWorkflowExecutionCanceled
event in the history. -
CompleteWorkflowExecution
– Closes the workflow execution and records aWorkflowExecutionCompleted
event 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. AWorkflowExecutionContinuedAsNew
event is recorded in the history. -
FailWorkflowExecution
– Closes the workflow execution and records aWorkflowExecutionFailed
event in the history. -
RecordMarker
– Records aMarkerRecorded
event 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 aRequestCancelExternalWorkflowExecutionInitiated
event in the history. -
ScheduleActivityTask
– Schedules an activity task. -
SignalExternalWorkflowExecution
– Requests a signal to be delivered to the specified external workflow execution and records aSignalExternalWorkflowExecutionInitiated
event in the history. -
StartChildWorkflowExecution
– Requests that a child workflow execution be started and records aStartChildWorkflowExecutionInitiated
event 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 aTimerStarted
event in the history. This timer fires after the specified delay and record aTimerFired
event.
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
cause
parameter indicates the cause. Ifcause
is set toOPERATION_NOT_PERMITTED
, 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
– AScheduleActivityTask
decision 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
– ARequestCancelActivityTask
decision failed. This could happen if there is no open activity task with the specified activityId. -
StartTimerFailed
– AStartTimer
decision failed. This could happen if there is another open timer with the same timerId. -
CancelTimerFailed
– ACancelTimer
decision failed. This could happen if there is no open timer with the specified timerId. -
StartChildWorkflowExecutionFailed
– AStartChildWorkflowExecution
decision failed. This could happen if the workflow type specified isn't registered, is deprecated, or the decision isn't properly configured. -
SignalExternalWorkflowExecutionFailed
– ASignalExternalWorkflowExecution
decision failed. This could happen if theworkflowID
specified in the decision was incorrect. -
RequestCancelExternalWorkflowExecutionFailed
– ARequestCancelExternalWorkflowExecution
decision failed. This could happen if theworkflowID
specified in the decision was incorrect. -
CancelWorkflowExecutionFailed
– ACancelWorkflowExecution
decision failed. This could happen if there is an unhandled decision task pending in the workflow execution. -
CompleteWorkflowExecutionFailed
– ACompleteWorkflowExecution
decision failed. This could happen if there is an unhandled decision task pending in the workflow execution. -
ContinueAsNewWorkflowExecutionFailed
– AContinueAsNewWorkflowExecution
decision 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
– AFailWorkflowExecution
decision 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
,CancelWorkflowExecution
andContinueAsNewWorkflowExecution
. AnUnhandledDecision
fault 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:
-
ScheduleActivityTaskDecisionAttributes
-
RequestCancelActivityTaskDecisionAttributes
-
CompleteWorkflowExecutionDecisionAttributes
-
FailWorkflowExecutionDecisionAttributes
-
CancelWorkflowExecutionDecisionAttributes
-
ContinueAsNewWorkflowExecutionDecisionAttributes
-
RecordMarkerDecisionAttributes
-
StartTimerDecisionAttributes
-
CancelTimerDecisionAttributes
-
SignalExternalWorkflowExecutionDecisionAttributes
-
RequestCancelExternalWorkflowExecutionDecisionAttributes
-
StartChildWorkflowExecutionDecisionAttributes
- cancelTimerDecisionAttributes
- timerId required
- cancelWorkflowExecutionDecisionAttributes
- details
- completeWorkflowExecutionDecisionAttributes
- result
- continueAsNewWorkflowExecutionDecisionAttributes
- childPolicy
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowTypeVersion
- decisionType required
- failWorkflowExecutionDecisionAttributes
- details
- reason
- recordMarkerDecisionAttributes
- details
- markerName required
- requestCancelActivityTaskDecisionAttributes
- activityId required
- requestCancelExternalWorkflowExecutionDecisionAttributes
- control
- runId
- workflowId required
- scheduleActivityTaskDecisionAttributes
- activityId required
- activityType required
- name required
- version required
- control
- heartbeatTimeout
- input
- scheduleToCloseTimeout
- scheduleToStartTimeout
- startToCloseTimeout
- taskList
- name required
- taskPriority
- scheduleLambdaFunctionDecisionAttributes
- control
- id required
- input
- name required
- startToCloseTimeout
- signalExternalWorkflowExecutionDecisionAttributes
- control
- input
- runId
- signalName required
- workflowId required
- startChildWorkflowExecutionDecisionAttributes
- childPolicy
- control
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowId required
- workflowType required
- name required
- version required
- startTimerDecisionAttributes
- control
- startToFireTimeout required
- timerId required
-
- DecisionList
array
- items Decision
- DecisionTask
object
: A structure that represents a decision task. Decision tasks are sent to deciders in order for them to make decisions.- events required
- items HistoryEvent
- nextPageToken
- previousStartedEventId
- startedEventId required
- taskToken required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- events required
- DecisionTaskCompletedEventAttributes
object
: Provides the details of theDecisionTaskCompleted
event.- executionContext
- scheduledEventId required
- startedEventId required
- DecisionTaskScheduledEventAttributes
object
: Provides details about theDecisionTaskScheduled
event.- startToCloseTimeout
- taskList required
- name required
- taskPriority
- DecisionTaskStartedEventAttributes
object
: Provides the details of theDecisionTaskStarted
event.- identity
- scheduledEventId required
- DecisionTaskTimedOutEventAttributes
object
: Provides the details of theDecisionTaskTimedOut
event.- scheduledEventId required
- startedEventId required
- timeoutType required
- DecisionTaskTimeoutType
string
(values: START_TO_CLOSE)
- DecisionType
string
(values: ScheduleActivityTask, RequestCancelActivityTask, CompleteWorkflowExecution, FailWorkflowExecution, CancelWorkflowExecution, ContinueAsNewWorkflowExecution, RecordMarker, StartTimer, CancelTimer, SignalExternalWorkflowExecution, RequestCancelExternalWorkflowExecution, StartChildWorkflowExecution, ScheduleLambdaFunction)
- DeprecateActivityTypeInput
object
- activityType required
- name required
- version required
- domain required
- activityType required
- DeprecateDomainInput
object
- name required
- DeprecateWorkflowTypeInput
object
- domain required
- workflowType required
- name required
- version required
- DescribeActivityTypeInput
object
- activityType required
- name required
- version required
- domain required
- activityType required
- DescribeDomainInput
object
- name required
- DescribeWorkflowExecutionInput
object
- domain required
- execution required
- runId required
- workflowId required
- DescribeWorkflowTypeInput
object
- domain required
- workflowType required
- name required
- version required
- Description
string
- DomainConfiguration
object
: Contains the configuration settings of a domain.- workflowExecutionRetentionPeriodInDays required
- DomainDetail
object
: Contains details of a domain.- configuration required
- workflowExecutionRetentionPeriodInDays required
- domainInfo required
- arn
- description
- name required
- status required
- configuration required
- DomainInfo
object
: Contains general information about a domain.- arn
- description
- name required
- status required
- DomainInfoList
array
- items DomainInfo
- DomainInfos
object
: Contains a paginated collection of DomainInfo structures.- domainInfos required
- items DomainInfo
- nextPageToken
- domainInfos required
- DomainName
string
- DurationInDays
string
- DurationInSeconds
string
- DurationInSecondsOptional
string
- EventId
integer
- EventType
string
(values: WorkflowExecutionStarted, WorkflowExecutionCancelRequested, WorkflowExecutionCompleted, CompleteWorkflowExecutionFailed, WorkflowExecutionFailed, FailWorkflowExecutionFailed, WorkflowExecutionTimedOut, WorkflowExecutionCanceled, CancelWorkflowExecutionFailed, WorkflowExecutionContinuedAsNew, ContinueAsNewWorkflowExecutionFailed, WorkflowExecutionTerminated, DecisionTaskScheduled, DecisionTaskStarted, DecisionTaskCompleted, DecisionTaskTimedOut, ActivityTaskScheduled, ScheduleActivityTaskFailed, ActivityTaskStarted, ActivityTaskCompleted, ActivityTaskFailed, ActivityTaskTimedOut, ActivityTaskCanceled, ActivityTaskCancelRequested, RequestCancelActivityTaskFailed, WorkflowExecutionSignaled, MarkerRecorded, RecordMarkerFailed, TimerStarted, StartTimerFailed, TimerFired, TimerCanceled, CancelTimerFailed, StartChildWorkflowExecutionInitiated, StartChildWorkflowExecutionFailed, ChildWorkflowExecutionStarted, ChildWorkflowExecutionCompleted, ChildWorkflowExecutionFailed, ChildWorkflowExecutionTimedOut, ChildWorkflowExecutionCanceled, ChildWorkflowExecutionTerminated, SignalExternalWorkflowExecutionInitiated, SignalExternalWorkflowExecutionFailed, ExternalWorkflowExecutionSignaled, RequestCancelExternalWorkflowExecutionInitiated, RequestCancelExternalWorkflowExecutionFailed, ExternalWorkflowExecutionCancelRequested, LambdaFunctionScheduled, LambdaFunctionStarted, LambdaFunctionCompleted, LambdaFunctionFailed, LambdaFunctionTimedOut, ScheduleLambdaFunctionFailed, StartLambdaFunctionFailed)
- ExecutionStatus
string
(values: OPEN, CLOSED)
- ExecutionTimeFilter
object
: 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.
- latestDate
- oldestDate required
- ExternalWorkflowExecutionCancelRequestedEventAttributes
object
: Provides the details of theExternalWorkflowExecutionCancelRequested
event.- initiatedEventId required
- workflowExecution required
- runId required
- workflowId required
- ExternalWorkflowExecutionSignaledEventAttributes
object
: Provides the details of theExternalWorkflowExecutionSignaled
event.- initiatedEventId required
- workflowExecution required
- runId required
- workflowId required
- FailWorkflowExecutionDecisionAttributes
object
:Provides the details of the
FailWorkflowExecution
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. -
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
cause
parameter 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.- details
- reason
-
- FailWorkflowExecutionFailedCause
string
(values: UNHANDLED_DECISION, OPERATION_NOT_PERMITTED)
- FailWorkflowExecutionFailedEventAttributes
object
: Provides the details of theFailWorkflowExecutionFailed
event.- cause required
- decisionTaskCompletedEventId required
- FailureReason
string
- FunctionId
string
- FunctionInput
string
- FunctionName
string
- GetWorkflowExecutionHistoryInput
object
- domain required
- execution required
- runId required
- workflowId required
- maximumPageSize
- nextPageToken
- reverseOrder
- History
object
: 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.- events required
- items HistoryEvent
- nextPageToken
- events required
- HistoryEvent
object
:Event within a workflow execution. A history event can be one of these types:
-
ActivityTaskCancelRequested
– ARequestCancelActivityTask
decision 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 aRecordMarker
decision. -
RecordMarkerFailed
– ARecordMarker
decision 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 aStartTimer
decision. -
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.
- activityTaskCancelRequestedEventAttributes
- activityId required
- decisionTaskCompletedEventId required
- activityTaskCanceledEventAttributes
- details
- latestCancelRequestedEventId
- scheduledEventId required
- startedEventId required
- activityTaskCompletedEventAttributes
- result
- scheduledEventId required
- startedEventId required
- activityTaskFailedEventAttributes
- details
- reason
- scheduledEventId required
- startedEventId required
- activityTaskScheduledEventAttributes
- activityId required
- activityType required
- name required
- version required
- control
- decisionTaskCompletedEventId required
- heartbeatTimeout
- input
- scheduleToCloseTimeout
- scheduleToStartTimeout
- startToCloseTimeout
- taskList required
- name required
- taskPriority
- activityTaskStartedEventAttributes
- identity
- scheduledEventId required
- activityTaskTimedOutEventAttributes
- details
- scheduledEventId required
- startedEventId required
- timeoutType required
- cancelTimerFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- timerId required
- cancelWorkflowExecutionFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- childWorkflowExecutionCanceledEventAttributes
- details
- initiatedEventId required
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- childWorkflowExecutionCompletedEventAttributes
- initiatedEventId required
- result
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- childWorkflowExecutionFailedEventAttributes
- details
- initiatedEventId required
- reason
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- childWorkflowExecutionStartedEventAttributes
- initiatedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- childWorkflowExecutionTerminatedEventAttributes
- initiatedEventId required
- startedEventId required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- childWorkflowExecutionTimedOutEventAttributes
- initiatedEventId required
- startedEventId required
- timeoutType required
- workflowExecution required
- runId required
- workflowId required
- workflowType required
- name required
- version required
- completeWorkflowExecutionFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- continueAsNewWorkflowExecutionFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- decisionTaskCompletedEventAttributes
- executionContext
- scheduledEventId required
- startedEventId required
- decisionTaskScheduledEventAttributes
- startToCloseTimeout
- taskList required
- name required
- taskPriority
- decisionTaskStartedEventAttributes
- identity
- scheduledEventId required
- decisionTaskTimedOutEventAttributes
- scheduledEventId required
- startedEventId required
- timeoutType required
- eventId required
- eventTimestamp required
- eventType required
- externalWorkflowExecutionCancelRequestedEventAttributes
- initiatedEventId required
- workflowExecution required
- runId required
- workflowId required
- externalWorkflowExecutionSignaledEventAttributes
- initiatedEventId required
- workflowExecution required
- runId required
- workflowId required
- failWorkflowExecutionFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- lambdaFunctionCompletedEventAttributes
- result
- scheduledEventId required
- startedEventId required
- lambdaFunctionFailedEventAttributes
- details
- reason
- scheduledEventId required
- startedEventId required
- lambdaFunctionScheduledEventAttributes
- control
- decisionTaskCompletedEventId required
- id required
- input
- name required
- startToCloseTimeout
- lambdaFunctionStartedEventAttributes
- scheduledEventId required
- lambdaFunctionTimedOutEventAttributes
- scheduledEventId required
- startedEventId required
- timeoutType
- markerRecordedEventAttributes
- decisionTaskCompletedEventId required
- details
- markerName required
- recordMarkerFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- markerName required
- requestCancelActivityTaskFailedEventAttributes
- activityId required
- cause required
- decisionTaskCompletedEventId required
- requestCancelExternalWorkflowExecutionFailedEventAttributes
- cause required
- control
- decisionTaskCompletedEventId required
- initiatedEventId required
- runId
- workflowId required
- requestCancelExternalWorkflowExecutionInitiatedEventAttributes
- control
- decisionTaskCompletedEventId required
- runId
- workflowId required
- scheduleActivityTaskFailedEventAttributes
- activityId required
- activityType required
- name required
- version required
- cause required
- decisionTaskCompletedEventId required
- scheduleLambdaFunctionFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- id required
- name required
- signalExternalWorkflowExecutionFailedEventAttributes
- cause required
- control
- decisionTaskCompletedEventId required
- initiatedEventId required
- runId
- workflowId required
- signalExternalWorkflowExecutionInitiatedEventAttributes
- control
- decisionTaskCompletedEventId required
- input
- runId
- signalName required
- workflowId required
- startChildWorkflowExecutionFailedEventAttributes
- cause required
- control
- decisionTaskCompletedEventId required
- initiatedEventId required
- workflowId required
- workflowType required
- name required
- version required
- startChildWorkflowExecutionInitiatedEventAttributes
- childPolicy required
- control
- decisionTaskCompletedEventId required
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowId required
- workflowType required
- name required
- version required
- startLambdaFunctionFailedEventAttributes
- cause
- message
- scheduledEventId
- startTimerFailedEventAttributes
- cause required
- decisionTaskCompletedEventId required
- timerId required
- timerCanceledEventAttributes
- decisionTaskCompletedEventId required
- startedEventId required
- timerId required
- timerFiredEventAttributes
- startedEventId required
- timerId required
- timerStartedEventAttributes
- control
- decisionTaskCompletedEventId required
- startToFireTimeout required
- timerId required
- workflowExecutionCancelRequestedEventAttributes
- cause
- externalInitiatedEventId
- externalWorkflowExecution
- runId required
- workflowId required
- workflowExecutionCanceledEventAttributes
- decisionTaskCompletedEventId required
- details
- workflowExecutionCompletedEventAttributes
- decisionTaskCompletedEventId required
- result
- workflowExecutionContinuedAsNewEventAttributes
- childPolicy required
- decisionTaskCompletedEventId required
- executionStartToCloseTimeout
- input
- lambdaRole
- newExecutionRunId required
- tagList
- items Tag
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowType required
- name required
- version required
- workflowExecutionFailedEventAttributes
- decisionTaskCompletedEventId required
- details
- reason
- workflowExecutionSignaledEventAttributes
- externalInitiatedEventId
- externalWorkflowExecution
- runId required
- workflowId required
- input
- signalName required
- workflowExecutionStartedEventAttributes
- childPolicy required
- continuedExecutionRunId
- executionStartToCloseTimeout
- input
- lambdaRole
- parentInitiatedEventId
- parentWorkflowExecution
- runId required
- workflowId required
- tagList
- items Tag
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowType required
- name required
- version required
- workflowExecutionTerminatedEventAttributes
- cause
- childPolicy required
- details
- reason
- workflowExecutionTimedOutEventAttributes
- childPolicy required
- timeoutType required
-
- HistoryEventList
array
- items HistoryEvent
- Identity
string
- LambdaFunctionCompletedEventAttributes
object
: Provides the details of theLambdaFunctionCompleted
event. It isn't set for other event types.- result
- scheduledEventId required
- startedEventId required
- LambdaFunctionFailedEventAttributes
object
: Provides the details of theLambdaFunctionFailed
event. It isn't set for other event types.- details
- reason
- scheduledEventId required
- startedEventId required
- LambdaFunctionScheduledEventAttributes
object
: Provides the details of theLambdaFunctionScheduled
event. It isn't set for other event types.- control
- decisionTaskCompletedEventId required
- id required
- input
- name required
- startToCloseTimeout
- LambdaFunctionStartedEventAttributes
object
: Provides the details of theLambdaFunctionStarted
event. It isn't set for other event types.- scheduledEventId required
- LambdaFunctionTimedOutEventAttributes
object
: Provides details of theLambdaFunctionTimedOut
event.- scheduledEventId required
- startedEventId required
- timeoutType
- LambdaFunctionTimeoutType
string
(values: START_TO_CLOSE)
- LimitedData
string
- ListActivityTypesInput
object
- domain required
- maximumPageSize
- name
- nextPageToken
- registrationStatus required
- reverseOrder
- ListClosedWorkflowExecutionsInput
object
- closeStatusFilter
- status required
- closeTimeFilter
- latestDate
- oldestDate required
- domain required
- executionFilter
- workflowId required
- maximumPageSize
- nextPageToken
- reverseOrder
- startTimeFilter
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- closeStatusFilter
- ListDomainsInput
object
- maximumPageSize
- nextPageToken
- registrationStatus required
- reverseOrder
- ListOpenWorkflowExecutionsInput
object
- domain required
- executionFilter
- workflowId required
- maximumPageSize
- nextPageToken
- reverseOrder
- startTimeFilter required
- latestDate
- oldestDate required
- tagFilter
- tag required
- typeFilter
- name required
- version
- ListTagsForResourceInput
object
- resourceArn required
- ListTagsForResourceOutput
object
- tags
- items ResourceTag
- tags
- ListWorkflowTypesInput
object
- domain required
- maximumPageSize
- name
- nextPageToken
- registrationStatus required
- reverseOrder
- MarkerName
string
- MarkerRecordedEventAttributes
object
: Provides the details of theMarkerRecorded
event.- decisionTaskCompletedEventId required
- details
- markerName required
- Name
string
- OpenDecisionTasksCount
integer
- PageSize
integer
- PageToken
string
- PendingTaskCount
object
: Contains the count of tasks in a task list.- count required
- truncated
- PollForActivityTaskInput
object
- domain required
- identity
- taskList required
- name required
- PollForDecisionTaskInput
object
- domain required
- identity
- maximumPageSize
- nextPageToken
- reverseOrder
- taskList required
- name required
- RecordActivityTaskHeartbeatInput
object
- details
- taskToken required
- RecordMarkerDecisionAttributes
object
:Provides the details of the
RecordMarker
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. -
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
cause
parameter 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.- details
- markerName required
-
- RecordMarkerFailedCause
string
(values: OPERATION_NOT_PERMITTED)
- RecordMarkerFailedEventAttributes
object
: Provides the details of theRecordMarkerFailed
event.- cause required
- decisionTaskCompletedEventId required
- markerName required
- RegisterActivityTypeInput
object
- defaultTaskHeartbeatTimeout
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskScheduleToCloseTimeout
- defaultTaskScheduleToStartTimeout
- defaultTaskStartToCloseTimeout
- description
- domain required
- name required
- version required
- RegisterDomainInput
object
- tags
- items ResourceTag
- description
- name required
- workflowExecutionRetentionPeriodInDays required
- tags
- RegisterWorkflowTypeInput
object
- defaultChildPolicy
- defaultExecutionStartToCloseTimeout
- defaultLambdaRole
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskStartToCloseTimeout
- description
- domain required
- name required
- version required
- RegistrationStatus
string
(values: REGISTERED, DEPRECATED)
- RequestCancelActivityTaskDecisionAttributes
object
:Provides the details of the
RequestCancelActivityTask
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. -
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
cause
parameter 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.- activityId required
-
- RequestCancelActivityTaskFailedCause
string
(values: ACTIVITY_ID_UNKNOWN, OPERATION_NOT_PERMITTED)
- RequestCancelActivityTaskFailedEventAttributes
object
: Provides the details of theRequestCancelActivityTaskFailed
event.- activityId required
- cause required
- decisionTaskCompletedEventId required
- RequestCancelExternalWorkflowExecutionDecisionAttributes
object
:Provides the details of the
RequestCancelExternalWorkflowExecution
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. -
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
cause
parameter 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.- control
- runId
- workflowId required
-
- RequestCancelExternalWorkflowExecutionFailedCause
string
(values: UNKNOWN_EXTERNAL_WORKFLOW_EXECUTION, REQUEST_CANCEL_EXTERNAL_WORKFLOW_EXECUTION_RATE_EXCEEDED, OPERATION_NOT_PERMITTED)
- RequestCancelExternalWorkflowExecutionFailedEventAttributes
object
: Provides the details of theRequestCancelExternalWorkflowExecutionFailed
event.- cause required
- control
- decisionTaskCompletedEventId required
- initiatedEventId required
- runId
- workflowId required
- RequestCancelExternalWorkflowExecutionInitiatedEventAttributes
object
: Provides the details of theRequestCancelExternalWorkflowExecutionInitiated
event.- control
- decisionTaskCompletedEventId required
- runId
- workflowId required
- RequestCancelWorkflowExecutionInput
object
- domain required
- runId
- workflowId required
- ResourceTag
object
: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:
_ . : / = + - @
.- key required
- value
- ResourceTagKey
string
- ResourceTagKeyList
array
- items ResourceTagKey
- ResourceTagList
array
- items ResourceTag
- ResourceTagValue
string
- RespondActivityTaskCanceledInput
object
- details
- taskToken required
- RespondActivityTaskCompletedInput
object
- result
- taskToken required
- RespondActivityTaskFailedInput
object
- details
- reason
- taskToken required
- RespondDecisionTaskCompletedInput
object
: Input data for a TaskCompleted response to a decision task.- decisions
- items Decision
- executionContext
- taskToken required
- decisions
- ReverseOrder
boolean
- Run
object
: Specifies therunId
of a workflow execution.- runId
- ScheduleActivityTaskDecisionAttributes
object
:Provides the details of the
ScheduleActivityTask
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.-
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
cause
parameter 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.- activityId required
- activityType required
- name required
- version required
- control
- heartbeatTimeout
- input
- scheduleToCloseTimeout
- scheduleToStartTimeout
- startToCloseTimeout
- taskList
- name required
- taskPriority
-
- ScheduleActivityTaskFailedCause
string
(values: ACTIVITY_TYPE_DEPRECATED, ACTIVITY_TYPE_DOES_NOT_EXIST, ACTIVITY_ID_ALREADY_IN_USE, OPEN_ACTIVITIES_LIMIT_EXCEEDED, ACTIVITY_CREATION_RATE_EXCEEDED, DEFAULT_SCHEDULE_TO_CLOSE_TIMEOUT_UNDEFINED, DEFAULT_TASK_LIST_UNDEFINED, DEFAULT_SCHEDULE_TO_START_TIMEOUT_UNDEFINED, DEFAULT_START_TO_CLOSE_TIMEOUT_UNDEFINED, DEFAULT_HEARTBEAT_TIMEOUT_UNDEFINED, OPERATION_NOT_PERMITTED)
- ScheduleActivityTaskFailedEventAttributes
object
: Provides the details of theScheduleActivityTaskFailed
event.- activityId required
- activityType required
- name required
- version required
- cause required
- decisionTaskCompletedEventId required
- ScheduleLambdaFunctionDecisionAttributes
object
: Decision attributes specified inscheduleLambdaFunctionDecisionAttributes
within the list of decisionsdecisions
passed to RespondDecisionTaskCompleted.- control
- id required
- input
- name required
- startToCloseTimeout
- ScheduleLambdaFunctionFailedCause
string
(values: ID_ALREADY_IN_USE, OPEN_LAMBDA_FUNCTIONS_LIMIT_EXCEEDED, LAMBDA_FUNCTION_CREATION_RATE_EXCEEDED, LAMBDA_SERVICE_NOT_AVAILABLE_IN_REGION)
- ScheduleLambdaFunctionFailedEventAttributes
object
: Provides the details of theScheduleLambdaFunctionFailed
event. It isn't set for other event types.- cause required
- decisionTaskCompletedEventId required
- id required
- name required
- SignalExternalWorkflowExecutionDecisionAttributes
object
:Provides the details of the
SignalExternalWorkflowExecution
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. -
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
cause
parameter 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.- control
- input
- runId
- signalName required
- workflowId required
-
- SignalExternalWorkflowExecutionFailedCause
string
(values: UNKNOWN_EXTERNAL_WORKFLOW_EXECUTION, SIGNAL_EXTERNAL_WORKFLOW_EXECUTION_RATE_EXCEEDED, OPERATION_NOT_PERMITTED)
- SignalExternalWorkflowExecutionFailedEventAttributes
object
: Provides the details of theSignalExternalWorkflowExecutionFailed
event.- cause required
- control
- decisionTaskCompletedEventId required
- initiatedEventId required
- runId
- workflowId required
- SignalExternalWorkflowExecutionInitiatedEventAttributes
object
: Provides the details of theSignalExternalWorkflowExecutionInitiated
event.- control
- decisionTaskCompletedEventId required
- input
- runId
- signalName required
- workflowId required
- SignalName
string
- SignalWorkflowExecutionInput
object
- domain required
- input
- runId
- signalName required
- workflowId required
- StartChildWorkflowExecutionDecisionAttributes
object
: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 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
cause
parameter 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.- childPolicy
- control
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowId required
- workflowType required
- name required
- version required
-
- StartChildWorkflowExecutionFailedCause
string
(values: WORKFLOW_TYPE_DOES_NOT_EXIST, WORKFLOW_TYPE_DEPRECATED, OPEN_CHILDREN_LIMIT_EXCEEDED, OPEN_WORKFLOWS_LIMIT_EXCEEDED, CHILD_CREATION_RATE_EXCEEDED, WORKFLOW_ALREADY_RUNNING, DEFAULT_EXECUTION_START_TO_CLOSE_TIMEOUT_UNDEFINED, DEFAULT_TASK_LIST_UNDEFINED, DEFAULT_TASK_START_TO_CLOSE_TIMEOUT_UNDEFINED, DEFAULT_CHILD_POLICY_UNDEFINED, OPERATION_NOT_PERMITTED)
- StartChildWorkflowExecutionFailedEventAttributes
object
: Provides the details of theStartChildWorkflowExecutionFailed
event.- cause required
- control
- decisionTaskCompletedEventId required
- initiatedEventId required
- workflowId required
- workflowType required
- name required
- version required
- StartChildWorkflowExecutionInitiatedEventAttributes
object
: Provides the details of theStartChildWorkflowExecutionInitiated
event.- childPolicy required
- control
- decisionTaskCompletedEventId required
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowId required
- workflowType required
- name required
- version required
- StartLambdaFunctionFailedCause
string
(values: ASSUME_ROLE_FAILED)
- StartLambdaFunctionFailedEventAttributes
object
: Provides the details of theStartLambdaFunctionFailed
event. It isn't set for other event types.- cause
- message
- scheduledEventId
- StartTimerDecisionAttributes
object
:Provides the details of the
StartTimer
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. -
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
cause
parameter 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.- control
- startToFireTimeout required
- timerId required
-
- StartTimerFailedCause
string
(values: TIMER_ID_ALREADY_IN_USE, OPEN_TIMERS_LIMIT_EXCEEDED, TIMER_CREATION_RATE_EXCEEDED, OPERATION_NOT_PERMITTED)
- StartTimerFailedEventAttributes
object
: Provides the details of theStartTimerFailed
event.- cause required
- decisionTaskCompletedEventId required
- timerId required
- StartWorkflowExecutionInput
object
- childPolicy
- domain required
- executionStartToCloseTimeout
- input
- lambdaRole
- tagList
- items Tag
- taskList
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowId required
- workflowType required
- name required
- version required
- Tag
string
- TagFilter
object
: Used to filter the workflow executions in visibility APIs based on a tag.- tag required
- TagList
array
- items Tag
- TagResourceInput
object
- tags required
- items ResourceTag
- resourceArn required
- tags required
- TaskList
object
: Represents a task list.- name required
- TaskPriority
string
- TaskToken
string
- TerminateReason
string
- TerminateWorkflowExecutionInput
object
- childPolicy
- details
- domain required
- reason
- runId
- workflowId required
- TimerCanceledEventAttributes
object
: Provides the details of theTimerCanceled
event.- decisionTaskCompletedEventId required
- startedEventId required
- timerId required
- TimerFiredEventAttributes
object
: Provides the details of theTimerFired
event.- startedEventId required
- timerId required
- TimerId
string
- TimerStartedEventAttributes
object
: Provides the details of theTimerStarted
event.- control
- decisionTaskCompletedEventId required
- startToFireTimeout required
- timerId required
- Timestamp
string
- Truncated
boolean
- UndeprecateActivityTypeInput
object
- activityType required
- name required
- version required
- domain required
- activityType required
- UndeprecateDomainInput
object
- name required
- UndeprecateWorkflowTypeInput
object
- domain required
- workflowType required
- name required
- version required
- UntagResourceInput
object
- resourceArn required
- tagKeys required
- items ResourceTagKey
- Version
string
- VersionOptional
string
- WorkflowExecution
object
: Represents a workflow execution.- runId required
- workflowId required
- WorkflowExecutionCancelRequestedCause
string
(values: CHILD_POLICY_APPLIED)
- WorkflowExecutionCancelRequestedEventAttributes
object
: Provides the details of theWorkflowExecutionCancelRequested
event.- cause
- externalInitiatedEventId
- externalWorkflowExecution
- runId required
- workflowId required
- WorkflowExecutionCanceledEventAttributes
object
: Provides the details of theWorkflowExecutionCanceled
event.- decisionTaskCompletedEventId required
- details
- WorkflowExecutionCompletedEventAttributes
object
: Provides the details of theWorkflowExecutionCompleted
event.- decisionTaskCompletedEventId required
- result
- WorkflowExecutionConfiguration
object
: 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.- childPolicy required
- executionStartToCloseTimeout required
- lambdaRole
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout required
- WorkflowExecutionContinuedAsNewEventAttributes
object
: Provides the details of theWorkflowExecutionContinuedAsNew
event.- childPolicy required
- decisionTaskCompletedEventId required
- executionStartToCloseTimeout
- input
- lambdaRole
- newExecutionRunId required
- tagList
- items Tag
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowType required
- name required
- version required
- WorkflowExecutionCount
object
: Contains the count of workflow executions returned from CountOpenWorkflowExecutions or CountClosedWorkflowExecutions- count required
- truncated
- WorkflowExecutionDetail
object
: Contains details about a workflow execution.- executionConfiguration required
- childPolicy required
- executionStartToCloseTimeout required
- lambdaRole
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout required
- executionInfo required
- cancelRequested
- closeStatus
- closeTimestamp
- execution required
- runId required
- workflowId required
- executionStatus required
- parent
- runId required
- workflowId required
- startTimestamp required
- tagList
- items Tag
- workflowType required
- name required
- version required
- latestActivityTaskTimestamp
- latestExecutionContext
- openCounts required
- openActivityTasks required
- openChildWorkflowExecutions required
- openDecisionTasks required
- openLambdaFunctions
- openTimers required
- executionConfiguration required
- WorkflowExecutionFailedEventAttributes
object
: Provides the details of theWorkflowExecutionFailed
event.- decisionTaskCompletedEventId required
- details
- reason
- WorkflowExecutionFilter
object
: Used to filter the workflow executions in visibility APIs by theirworkflowId
.- workflowId required
- WorkflowExecutionInfo
object
: Contains information about a workflow execution.- cancelRequested
- closeStatus
- closeTimestamp
- execution required
- runId required
- workflowId required
- executionStatus required
- parent
- runId required
- workflowId required
- startTimestamp required
- tagList
- items Tag
- workflowType required
- name required
- version required
- WorkflowExecutionInfoList
array
- items WorkflowExecutionInfo
- WorkflowExecutionInfos
object
: Contains a paginated list of information about workflow executions.- executionInfos required
- items WorkflowExecutionInfo
- nextPageToken
- executionInfos required
- WorkflowExecutionOpenCounts
object
: Contains the counts of open tasks, child workflow executions and timers for a workflow execution.- openActivityTasks required
- openChildWorkflowExecutions required
- openDecisionTasks required
- openLambdaFunctions
- openTimers required
- WorkflowExecutionSignaledEventAttributes
object
: Provides the details of theWorkflowExecutionSignaled
event.- externalInitiatedEventId
- externalWorkflowExecution
- runId required
- workflowId required
- input
- signalName required
- WorkflowExecutionStartedEventAttributes
object
: Provides details ofWorkflowExecutionStarted
event.- childPolicy required
- continuedExecutionRunId
- executionStartToCloseTimeout
- input
- lambdaRole
- parentInitiatedEventId
- parentWorkflowExecution
- runId required
- workflowId required
- tagList
- items Tag
- taskList required
- name required
- taskPriority
- taskStartToCloseTimeout
- workflowType required
- name required
- version required
- WorkflowExecutionTerminatedCause
string
(values: CHILD_POLICY_APPLIED, EVENT_LIMIT_EXCEEDED, OPERATOR_INITIATED)
- WorkflowExecutionTerminatedEventAttributes
object
: Provides the details of theWorkflowExecutionTerminated
event.- cause
- childPolicy required
- details
- reason
- WorkflowExecutionTimedOutEventAttributes
object
: Provides the details of theWorkflowExecutionTimedOut
event.- childPolicy required
- timeoutType required
- WorkflowExecutionTimeoutType
string
(values: START_TO_CLOSE)
- WorkflowId
string
- WorkflowRunId
string
- WorkflowRunIdOptional
string
- WorkflowType
object
: Represents a workflow type.- name required
- version required
- WorkflowTypeConfiguration
object
: The configuration settings of a workflow type.- defaultChildPolicy
- defaultExecutionStartToCloseTimeout
- defaultLambdaRole
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskStartToCloseTimeout
- WorkflowTypeDetail
object
: Contains details about a workflow type.- configuration required
- defaultChildPolicy
- defaultExecutionStartToCloseTimeout
- defaultLambdaRole
- defaultTaskList
- name required
- defaultTaskPriority
- defaultTaskStartToCloseTimeout
- typeInfo required
- creationDate required
- deprecationDate
- description
- status required
- workflowType required
- name required
- version required
- configuration required
- WorkflowTypeFilter
object
: Used to filter workflow execution query results by type. Each parameter, if specified, defines a rule that must be satisfied by each returned result.- name required
- version
- WorkflowTypeInfo
object
: Contains information about a workflow type.- creationDate required
- deprecationDate
- description
- status required
- workflowType required
- name required
- version required
- WorkflowTypeInfoList
array
- items WorkflowTypeInfo
- WorkflowTypeInfos
object
: Contains a paginated list of information structures about workflow types.- nextPageToken
- typeInfos required
- items WorkflowTypeInfo