@datafire/amazonaws_swf v5.0.0
@datafire/amazonaws_swf
Client library for Amazon Simple Workflow Service
Installation and Usage
npm install --save @datafire/amazonaws_swf
let amazonaws_swf = require('@datafire/amazonaws_swf').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
amazonaws_swf.CountClosedWorkflowExecutions({
"domain": ""
}).then(data => {
console.log(data);
});
Description
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 .
Actions
CountClosedWorkflowExecutions
amazonaws_swf.CountClosedWorkflowExecutions({
"domain": ""
}, context)
Input
- input
object
- closeStatusFilter CloseStatusFilter
- closeTimeFilter ExecutionTimeFilter
- domain required DomainName
- executionFilter WorkflowExecutionFilter
- startTimeFilter ExecutionTimeFilter
- tagFilter TagFilter
- typeFilter WorkflowTypeFilter
Output
- output WorkflowExecutionCount
CountOpenWorkflowExecutions
amazonaws_swf.CountOpenWorkflowExecutions({
"domain": "",
"startTimeFilter": {
"oldestDate": ""
}
}, context)
Input
- input
object
- domain required DomainName
- executionFilter WorkflowExecutionFilter
- startTimeFilter required ExecutionTimeFilter
- tagFilter TagFilter
- typeFilter WorkflowTypeFilter
Output
- output WorkflowExecutionCount
CountPendingActivityTasks
amazonaws_swf.CountPendingActivityTasks({
"domain": "",
"taskList": {
"name": ""
}
}, context)
Input
- input
object
- domain required DomainName
- taskList required TaskList
Output
- output PendingTaskCount
CountPendingDecisionTasks
amazonaws_swf.CountPendingDecisionTasks({
"domain": "",
"taskList": {
"name": ""
}
}, context)
Input
- input
object
- domain required DomainName
- taskList required TaskList
Output
- output PendingTaskCount
DeprecateActivityType
amazonaws_swf.DeprecateActivityType({
"domain": "",
"activityType": {
"name": "",
"version": ""
}
}, context)
Input
- input
object
- activityType required ActivityType
- domain required DomainName
Output
Output schema unknown
DeprecateDomain
amazonaws_swf.DeprecateDomain({
"name": ""
}, context)
Input
- input
object
- name required DomainName
Output
Output schema unknown
DeprecateWorkflowType
amazonaws_swf.DeprecateWorkflowType({
"domain": "",
"workflowType": {
"name": "",
"version": ""
}
}, context)
Input
- input
object
- domain required DomainName
- workflowType required WorkflowType
Output
Output schema unknown
DescribeActivityType
amazonaws_swf.DescribeActivityType({
"domain": "",
"activityType": {
"name": "",
"version": ""
}
}, context)
Input
- input
object
- activityType required ActivityType
- domain required DomainName
Output
- output ActivityTypeDetail
DescribeDomain
amazonaws_swf.DescribeDomain({
"name": ""
}, context)
Input
- input
object
- name required DomainName
Output
- output DomainDetail
DescribeWorkflowExecution
amazonaws_swf.DescribeWorkflowExecution({
"domain": "",
"execution": {
"workflowId": "",
"runId": ""
}
}, context)
Input
- input
object
- domain required DomainName
- execution required WorkflowExecution
Output
- output WorkflowExecutionDetail
DescribeWorkflowType
amazonaws_swf.DescribeWorkflowType({
"domain": "",
"workflowType": {
"name": "",
"version": ""
}
}, context)
Input
- input
object
- domain required DomainName
- workflowType required WorkflowType
Output
- output WorkflowTypeDetail
GetWorkflowExecutionHistory
amazonaws_swf.GetWorkflowExecutionHistory({
"domain": "",
"execution": {
"workflowId": "",
"runId": ""
}
}, context)
Input
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required DomainName
- execution required WorkflowExecution
- maximumPageSize PageSize
- nextPageToken PageToken
- reverseOrder ReverseOrder
- maximumPageSize
Output
- output History
ListActivityTypes
amazonaws_swf.ListActivityTypes({
"domain": "",
"registrationStatus": ""
}, context)
Input
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required DomainName
- maximumPageSize PageSize
- name Name
- nextPageToken PageToken
- registrationStatus required RegistrationStatus
- reverseOrder ReverseOrder
- maximumPageSize
Output
- output ActivityTypeInfos
ListClosedWorkflowExecutions
amazonaws_swf.ListClosedWorkflowExecutions({
"domain": ""
}, context)
Input
- input
object
- maximumPageSize
string
- nextPageToken
string
- closeStatusFilter CloseStatusFilter
- closeTimeFilter ExecutionTimeFilter
- domain required DomainName
- executionFilter WorkflowExecutionFilter
- maximumPageSize PageSize
- nextPageToken PageToken
- reverseOrder ReverseOrder
- startTimeFilter ExecutionTimeFilter
- tagFilter TagFilter
- typeFilter WorkflowTypeFilter
- maximumPageSize
Output
- output WorkflowExecutionInfos
ListDomains
amazonaws_swf.ListDomains({
"registrationStatus": ""
}, context)
Input
- input
object
- maximumPageSize
string
- nextPageToken
string
- maximumPageSize PageSize
- nextPageToken PageToken
- registrationStatus required RegistrationStatus
- reverseOrder ReverseOrder
- maximumPageSize
Output
- output DomainInfos
ListOpenWorkflowExecutions
amazonaws_swf.ListOpenWorkflowExecutions({
"domain": "",
"startTimeFilter": {
"oldestDate": ""
}
}, context)
Input
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required DomainName
- executionFilter WorkflowExecutionFilter
- maximumPageSize PageSize
- nextPageToken PageToken
- reverseOrder ReverseOrder
- startTimeFilter required ExecutionTimeFilter
- tagFilter TagFilter
- typeFilter WorkflowTypeFilter
- maximumPageSize
Output
- output WorkflowExecutionInfos
ListWorkflowTypes
amazonaws_swf.ListWorkflowTypes({
"domain": "",
"registrationStatus": ""
}, context)
Input
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required DomainName
- maximumPageSize PageSize
- name Name
- nextPageToken PageToken
- registrationStatus required RegistrationStatus
- reverseOrder ReverseOrder
- maximumPageSize
Output
- output WorkflowTypeInfos
PollForActivityTask
amazonaws_swf.PollForActivityTask({
"domain": "",
"taskList": {
"name": ""
}
}, context)
Input
- input
object
- domain required DomainName
- identity Identity
- taskList required TaskList
Output
- output ActivityTask
PollForDecisionTask
amazonaws_swf.PollForDecisionTask({
"domain": "",
"taskList": {
"name": ""
}
}, context)
Input
- input
object
- maximumPageSize
string
- nextPageToken
string
- domain required DomainName
- identity Identity
- maximumPageSize PageSize
- nextPageToken PageToken
- reverseOrder ReverseOrder
- taskList required TaskList
- maximumPageSize
Output
- output DecisionTask
RecordActivityTaskHeartbeat
amazonaws_swf.RecordActivityTaskHeartbeat({
"taskToken": ""
}, context)
Input
- input
object
- details LimitedData
- taskToken required TaskToken
Output
- output ActivityTaskStatus
RegisterActivityType
amazonaws_swf.RegisterActivityType({
"domain": "",
"name": "",
"version": ""
}, context)
Input
- input
object
- defaultTaskHeartbeatTimeout DurationInSecondsOptional
- defaultTaskList TaskList
- defaultTaskPriority TaskPriority
- defaultTaskScheduleToCloseTimeout DurationInSecondsOptional
- defaultTaskScheduleToStartTimeout DurationInSecondsOptional
- defaultTaskStartToCloseTimeout DurationInSecondsOptional
- description Description
- domain required DomainName
- name required Name
- version required Version
Output
Output schema unknown
RegisterDomain
amazonaws_swf.RegisterDomain({
"name": "",
"workflowExecutionRetentionPeriodInDays": ""
}, context)
Input
- input
object
- description Description
- name required DomainName
- workflowExecutionRetentionPeriodInDays required DurationInDays
Output
Output schema unknown
RegisterWorkflowType
amazonaws_swf.RegisterWorkflowType({
"domain": "",
"name": "",
"version": ""
}, context)
Input
- input
object
- defaultChildPolicy ChildPolicy
- defaultExecutionStartToCloseTimeout DurationInSecondsOptional
- defaultLambdaRole Arn
- defaultTaskList TaskList
- defaultTaskPriority TaskPriority
- defaultTaskStartToCloseTimeout DurationInSecondsOptional
- description Description
- domain required DomainName
- name required Name
- version required Version
Output
Output schema unknown
RequestCancelWorkflowExecution
amazonaws_swf.RequestCancelWorkflowExecution({
"domain": "",
"workflowId": ""
}, context)
Input
- input
object
- domain required DomainName
- runId WorkflowRunIdOptional
- workflowId required WorkflowId
Output
Output schema unknown
RespondActivityTaskCanceled
amazonaws_swf.RespondActivityTaskCanceled({
"taskToken": ""
}, context)
Input
Output
Output schema unknown
RespondActivityTaskCompleted
amazonaws_swf.RespondActivityTaskCompleted({
"taskToken": ""
}, context)
Input
Output
Output schema unknown
RespondActivityTaskFailed
amazonaws_swf.RespondActivityTaskFailed({
"taskToken": ""
}, context)
Input
- input
object
- details Data
- reason FailureReason
- taskToken required TaskToken
Output
Output schema unknown
RespondDecisionTaskCompleted
amazonaws_swf.RespondDecisionTaskCompleted({
"taskToken": ""
}, context)
Input
- input
object
- decisions DecisionList
- executionContext Data
- taskToken required TaskToken
Output
Output schema unknown
SignalWorkflowExecution
amazonaws_swf.SignalWorkflowExecution({
"domain": "",
"workflowId": "",
"signalName": ""
}, context)
Input
- input
object
- domain required DomainName
- input Data
- runId WorkflowRunIdOptional
- signalName required SignalName
- workflowId required WorkflowId
Output
Output schema unknown
StartWorkflowExecution
amazonaws_swf.StartWorkflowExecution({
"domain": "",
"workflowId": "",
"workflowType": {
"name": "",
"version": ""
}
}, context)
Input
- input
object
- childPolicy ChildPolicy
- domain required DomainName
- executionStartToCloseTimeout DurationInSecondsOptional
- input Data
- lambdaRole Arn
- tagList TagList
- taskList TaskList
- taskPriority TaskPriority
- taskStartToCloseTimeout DurationInSecondsOptional
- workflowId required WorkflowId
- workflowType required WorkflowType
Output
- output Run
TerminateWorkflowExecution
amazonaws_swf.TerminateWorkflowExecution({
"domain": "",
"workflowId": ""
}, context)
Input
- input
object
- childPolicy ChildPolicy
- details Data
- domain required DomainName
- reason TerminateReason
- runId WorkflowRunIdOptional
- workflowId required WorkflowId
Output
Output schema unknown
Definitions
ActivityId
- ActivityId
string
ActivityTask
- ActivityTask
object
: Unit of work sent to an activity worker.- activityId required ActivityId
- activityType required ActivityType
- input Data
- startedEventId required EventId
- taskToken required TaskToken
- workflowExecution required WorkflowExecution
ActivityTaskCancelRequestedEventAttributes
- ActivityTaskCancelRequestedEventAttributes
object
: Provides the details of the ActivityTaskCancelRequested event.- activityId required ActivityId
- decisionTaskCompletedEventId required EventId
ActivityTaskCanceledEventAttributes
- ActivityTaskCanceledEventAttributes
object
: Provides the details of the ActivityTaskCanceled event.
ActivityTaskCompletedEventAttributes
- ActivityTaskCompletedEventAttributes
object
: Provides the details of the ActivityTaskCompleted event.
ActivityTaskFailedEventAttributes
- ActivityTaskFailedEventAttributes
object
: Provides the details of the ActivityTaskFailed event.- details Data
- reason FailureReason
- scheduledEventId required EventId
- startedEventId required EventId
ActivityTaskScheduledEventAttributes
- ActivityTaskScheduledEventAttributes
object
: Provides the details of the ActivityTaskScheduled event.- activityId required ActivityId
- activityType required ActivityType
- control Data
- decisionTaskCompletedEventId required EventId
- heartbeatTimeout DurationInSecondsOptional
- input Data
- scheduleToCloseTimeout DurationInSecondsOptional
- scheduleToStartTimeout DurationInSecondsOptional
- startToCloseTimeout DurationInSecondsOptional
- taskList required TaskList
- taskPriority TaskPriority
ActivityTaskStartedEventAttributes
- ActivityTaskStartedEventAttributes
object
: Provides the details of the ActivityTaskStarted event.
ActivityTaskStatus
- ActivityTaskStatus
object
: Status information about an activity task.- cancelRequested required Canceled
ActivityTaskTimedOutEventAttributes
- ActivityTaskTimedOutEventAttributes
object
: Provides the details of the ActivityTaskTimedOut event.- details LimitedData
- scheduledEventId required EventId
- startedEventId required EventId
- timeoutType required ActivityTaskTimeoutType
ActivityTaskTimeoutType
- ActivityTaskTimeoutType
string
(values: START_TO_CLOSE, SCHEDULE_TO_START, SCHEDULE_TO_CLOSE, HEARTBEAT)
ActivityType
ActivityTypeConfiguration
- ActivityTypeConfiguration
object
: Configuration settings registered with the activity type.- defaultTaskHeartbeatTimeout DurationInSecondsOptional
- defaultTaskList TaskList
- defaultTaskPriority TaskPriority
- defaultTaskScheduleToCloseTimeout DurationInSecondsOptional
- defaultTaskScheduleToStartTimeout DurationInSecondsOptional
- defaultTaskStartToCloseTimeout DurationInSecondsOptional
ActivityTypeDetail
- ActivityTypeDetail
object
: Detailed information about an activity type.- configuration required ActivityTypeConfiguration
- typeInfo required ActivityTypeInfo
ActivityTypeInfo
- ActivityTypeInfo
object
: Detailed information about an activity type.- activityType required ActivityType
- creationDate required Timestamp
- deprecationDate Timestamp
- description Description
- status required RegistrationStatus
ActivityTypeInfoList
- ActivityTypeInfoList
array
- items ActivityTypeInfo
ActivityTypeInfos
- ActivityTypeInfos
object
: Contains a paginated list of activity type information structures.- nextPageToken PageToken
- typeInfos required ActivityTypeInfoList
Arn
- Arn
string
CancelTimerDecisionAttributes
- 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 to OPERATION_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 TimerId
CancelTimerFailedCause
- CancelTimerFailedCause
string
(values: TIMER_ID_UNKNOWN, OPERATION_NOT_PERMITTED)
CancelTimerFailedEventAttributes
- CancelTimerFailedEventAttributes
object
: Provides the details of the CancelTimerFailed event.- cause required CancelTimerFailedCause
- decisionTaskCompletedEventId required EventId
- timerId required TimerId
CancelWorkflowExecutionDecisionAttributes
- 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 to OPERATION_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 Data
CancelWorkflowExecutionFailedCause
- CancelWorkflowExecutionFailedCause
string
(values: UNHANDLED_DECISION, OPERATION_NOT_PERMITTED)
CancelWorkflowExecutionFailedEventAttributes
- CancelWorkflowExecutionFailedEventAttributes
object
: Provides the details of the CancelWorkflowExecutionFailed event.- cause required CancelWorkflowExecutionFailedCause
- decisionTaskCompletedEventId required EventId
Canceled
- Canceled
boolean
CauseMessage
- CauseMessage
string
ChildPolicy
- ChildPolicy
string
(values: TERMINATE, REQUEST_CANCEL, ABANDON)
ChildWorkflowExecutionCanceledEventAttributes
- ChildWorkflowExecutionCanceledEventAttributes
object
: Provide details of the ChildWorkflowExecutionCanceled event.- details Data
- initiatedEventId required EventId
- startedEventId required EventId
- workflowExecution required WorkflowExecution
- workflowType required WorkflowType
ChildWorkflowExecutionCompletedEventAttributes
- ChildWorkflowExecutionCompletedEventAttributes
object
: Provides the details of the ChildWorkflowExecutionCompleted event.- initiatedEventId required EventId
- result Data
- startedEventId required EventId
- workflowExecution required WorkflowExecution
- workflowType required WorkflowType
ChildWorkflowExecutionFailedEventAttributes
- ChildWorkflowExecutionFailedEventAttributes
object
: Provides the details of the ChildWorkflowExecutionFailed event.- details Data
- initiatedEventId required EventId
- reason FailureReason
- startedEventId required EventId
- workflowExecution required WorkflowExecution
- workflowType required WorkflowType
ChildWorkflowExecutionStartedEventAttributes
- ChildWorkflowExecutionStartedEventAttributes
object
: Provides the details of the ChildWorkflowExecutionStarted event.- initiatedEventId required EventId
- workflowExecution required WorkflowExecution
- workflowType required WorkflowType
ChildWorkflowExecutionTerminatedEventAttributes
- ChildWorkflowExecutionTerminatedEventAttributes
object
: Provides the details of the ChildWorkflowExecutionTerminated event.- initiatedEventId required EventId
- startedEventId required EventId
- workflowExecution required WorkflowExecution
- workflowType required WorkflowType
ChildWorkflowExecutionTimedOutEventAttributes
- ChildWorkflowExecutionTimedOutEventAttributes
object
: Provides the details of the ChildWorkflowExecutionTimedOut event.- initiatedEventId required EventId
- startedEventId required EventId
- timeoutType required WorkflowExecutionTimeoutType
- workflowExecution required WorkflowExecution
- workflowType required WorkflowType
CloseStatus
- CloseStatus
string
(values: COMPLETED, FAILED, CANCELED, TERMINATED, CONTINUED_AS_NEW, TIMED_OUT)
CloseStatusFilter
- CloseStatusFilter
object
: Used to filter the closed workflow executions in visibility APIs by their close status.- status required CloseStatus
CompleteWorkflowExecutionDecisionAttributes
- 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 to OPERATION_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 Data
CompleteWorkflowExecutionFailedCause
- CompleteWorkflowExecutionFailedCause
string
(values: UNHANDLED_DECISION, OPERATION_NOT_PERMITTED)
CompleteWorkflowExecutionFailedEventAttributes
- CompleteWorkflowExecutionFailedEventAttributes
object
: Provides the details of the CompleteWorkflowExecutionFailed event.- cause required CompleteWorkflowExecutionFailedCause
- decisionTaskCompletedEventId required EventId
ContinueAsNewWorkflowExecutionDecisionAttributes
- 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 is swf:taskList.name. workflowType.version – String constraint. The key is swf:workflowType.version. If the caller doesn't have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.- childPolicy ChildPolicy
- executionStartToCloseTimeout DurationInSecondsOptional
- input Data
- lambdaRole Arn
- tagList TagList
- taskList TaskList
- taskPriority TaskPriority
- taskStartToCloseTimeout DurationInSecondsOptional
- workflowTypeVersion Version
ContinueAsNewWorkflowExecutionFailedCause
- 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
- ContinueAsNewWorkflowExecutionFailedEventAttributes
object
: Provides the details of the ContinueAsNewWorkflowExecutionFailed event.- cause required ContinueAsNewWorkflowExecutionFailedCause
- decisionTaskCompletedEventId required EventId
Count
- Count
integer
CountClosedWorkflowExecutionsInput
- CountClosedWorkflowExecutionsInput
object
- closeStatusFilter CloseStatusFilter
- closeTimeFilter ExecutionTimeFilter
- domain required DomainName
- executionFilter WorkflowExecutionFilter
- startTimeFilter ExecutionTimeFilter
- tagFilter TagFilter
- typeFilter WorkflowTypeFilter
CountOpenWorkflowExecutionsInput
- CountOpenWorkflowExecutionsInput
object
- domain required DomainName
- executionFilter WorkflowExecutionFilter
- startTimeFilter required ExecutionTimeFilter
- tagFilter TagFilter
- typeFilter WorkflowTypeFilter
CountPendingActivityTasksInput
- CountPendingActivityTasksInput
object
- domain required DomainName
- taskList required TaskList
CountPendingDecisionTasksInput
- CountPendingDecisionTasksInput
object
- domain required DomainName
- taskList required TaskList
Data
- Data
string
Decision
- 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 a TimerCanceled event in the history. CancelWorkflowExecution – Closes the workflow execution and records a WorkflowExecutionCanceled event in the history. CompleteWorkflowExecution – Closes the workflow execution and records a WorkflowExecutionCompleted 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. A WorkflowExecutionContinuedAsNew event is recorded in the history. FailWorkflowExecution – Closes the workflow execution and records a WorkflowExecutionFailed event in the history. RecordMarker – Records a MarkerRecorded 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 a RequestCancelExternalWorkflowExecutionInitiated event in the history. ScheduleActivityTask – Schedules an activity task. SignalExternalWorkflowExecution – Requests a signal to be delivered to the specified external workflow execution and records a SignalExternalWorkflowExecutionInitiated event in the history. StartChildWorkflowExecution – Requests that a child workflow execution be started and records a StartChildWorkflowExecutionInitiated 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 a TimerStarted event in the history. This timer fires after the specified delay and record a TimerFired 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. If cause is set to OPERATION_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 – A ScheduleActivityTask 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 – A RequestCancelActivityTask decision failed. This could happen if there is no open activity task with the specified activityId. StartTimerFailed – A StartTimer decision failed. This could happen if there is another open timer with the same timerId. CancelTimerFailed – A CancelTimer decision failed. This could happen if there is no open timer with the specified timerId. StartChildWorkflowExecutionFailed – A StartChildWorkflowExecution decision failed. This could happen if the workflow type specified isn't registered, is deprecated, or the decision isn't properly configured. SignalExternalWorkflowExecutionFailed – A SignalExternalWorkflowExecution decision failed. This could happen if the workflowID specified in the decision was incorrect. RequestCancelExternalWorkflowExecutionFailed – A RequestCancelExternalWorkflowExecution decision failed. This could happen if the workflowID specified in the decision was incorrect. CancelWorkflowExecutionFailed – A CancelWorkflowExecution decision failed. This could happen if there is an unhandled decision task pending in the workflow execution. CompleteWorkflowExecutionFailed – A CompleteWorkflowExecution decision failed. This could happen if there is an unhandled decision task pending in the workflow execution. ContinueAsNewWorkflowExecutionFailed – A ContinueAsNewWorkflowExecution 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 – A FailWorkflowExecution 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 and ContinueAsNewWorkflowExecution. An UnhandledDecision 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 CancelTimerDecisionAttributes
- cancelWorkflowExecutionDecisionAttributes CancelWorkflowExecutionDecisionAttributes
- completeWorkflowExecutionDecisionAttributes CompleteWorkflowExecutionDecisionAttributes
- continueAsNewWorkflowExecutionDecisionAttributes ContinueAsNewWorkflowExecutionDecisionAttributes
- decisionType required DecisionType
- failWorkflowExecutionDecisionAttributes FailWorkflowExecutionDecisionAttributes
- recordMarkerDecisionAttributes RecordMarkerDecisionAttributes
- requestCancelActivityTaskDecisionAttributes RequestCancelActivityTaskDecisionAttributes
- requestCancelExternalWorkflowExecutionDecisionAttributes RequestCancelExternalWorkflowExecutionDecisionAttributes
- scheduleActivityTaskDecisionAttributes ScheduleActivityTaskDecisionAttributes
- scheduleLambdaFunctionDecisionAttributes ScheduleLambdaFunctionDecisionAttributes
- signalExternalWorkflowExecutionDecisionAttributes SignalExternalWorkflowExecutionDecisionAttributes
- startChildWorkflowExecutionDecisionAttributes StartChildWorkflowExecutionDecisionAttributes
- startTimerDecisionAttributes StartTimerDecisionAttributes
DecisionList
- DecisionList
array
- items Decision
DecisionTask
- DecisionTask
object
: A structure that represents a decision task. Decision tasks are sent to deciders in order for them to make decisions.- events required HistoryEventList
- nextPageToken PageToken
- previousStartedEventId EventId
- startedEventId required EventId
- taskToken required TaskToken
- workflowExecution required WorkflowExecution
- workflowType required WorkflowType
DecisionTaskCompletedEventAttributes
- DecisionTaskCompletedEventAttributes
object
: Provides the details of the DecisionTaskCompleted event.
DecisionTaskScheduledEventAttributes
- DecisionTaskScheduledEventAttributes
object
: Provides details about the DecisionTaskScheduled event.- startToCloseTimeout DurationInSecondsOptional
- taskList required TaskList
- taskPriority TaskPriority
DecisionTaskStartedEventAttributes
- DecisionTaskStartedEventAttributes
object
: Provides the details of the DecisionTaskStarted event.
DecisionTaskTimedOutEventAttributes
- DecisionTaskTimedOutEventAttributes
object
: Provides the details of the DecisionTaskTimedOut event.- scheduledEventId required EventId
- startedEventId required EventId
- timeoutType required DecisionTaskTimeoutType
DecisionTaskTimeoutType
- DecisionTaskTimeoutType
string
(values: START_TO_CLOSE)
DecisionType
- DecisionType
string
(values: ScheduleActivityTask, RequestCancelActivityTask, CompleteWorkflowExecution, FailWorkflowExecution, CancelWorkflowExecution, ContinueAsNewWorkflowExecution, RecordMarker, StartTimer, CancelTimer, SignalExternalWorkflowExecution, RequestCancelExternalWorkflowExecution, StartChildWorkflowExecution, ScheduleLambdaFunction)
DefaultUndefinedFault
- DefaultUndefinedFault
object
: The StartWorkflowExecution API action was called without the required parameters set. Some workflow execution parameters, such as the decision taskList, must be set to start the execution. However, these parameters might have been set as defaults when the workflow type was registered. In this case, you can omit these parameters from the StartWorkflowExecution call and Amazon SWF uses the values defined in the workflow type. If these parameters aren't set and no default parameters were defined in the workflow type, this error is displayed.- message ErrorMessage
DeprecateActivityTypeInput
- DeprecateActivityTypeInput
object
- activityType required ActivityType
- domain required DomainName
DeprecateDomainInput
- DeprecateDomainInput
object
- name required DomainName
DeprecateWorkflowTypeInput
- DeprecateWorkflowTypeInput
object
- domain required DomainName
- workflowType required WorkflowType
DescribeActivityTypeInput
- DescribeActivityTypeInput
object
- activityType required ActivityType
- domain required DomainName
DescribeDomainInput
- DescribeDomainInput
object
- name required DomainName
DescribeWorkflowExecutionInput
- DescribeWorkflowExecutionInput
object
- domain required DomainName
- execution required WorkflowExecution
DescribeWorkflowTypeInput
- DescribeWorkflowTypeInput
object
- domain required DomainName
- workflowType required WorkflowType
Description
- Description
string
DomainAlreadyExistsFault
- DomainAlreadyExistsFault
object
: Returned if the specified domain already exists. You get this fault even if the existing domain is in deprecated status.- message ErrorMessage
DomainConfiguration
- DomainConfiguration
object
: Contains the configuration settings of a domain.- workflowExecutionRetentionPeriodInDays required DurationInDays
DomainDeprecatedFault
- DomainDeprecatedFault
object
: Returned when the specified domain has been deprecated.- message ErrorMessage
DomainDetail
- DomainDetail
object
: Contains details of a domain.- configuration required DomainConfiguration
- domainInfo required DomainInfo
DomainInfo
- DomainInfo
object
: Contains general information about a domain.- description Description
- name required DomainName
- status required RegistrationStatus
DomainInfoList
- DomainInfoList
array
- items DomainInfo
DomainInfos
- DomainInfos
object
: Contains a paginated collection of DomainInfo structures.- domainInfos required DomainInfoList
- nextPageToken PageToken
DomainName
- DomainName
string
DurationInDays
- DurationInDays
string
DurationInSeconds
- DurationInSeconds
string
DurationInSecondsOptional
- DurationInSecondsOptional
string
ErrorMessage
- ErrorMessage
string
EventId
- EventId
integer
EventType
- 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
- ExecutionStatus
string
(values: OPEN, CLOSED)
ExecutionTimeFilter
- 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.
ExternalWorkflowExecutionCancelRequestedEventAttributes
- ExternalWorkflowExecutionCancelRequestedEventAttributes
object
: Provides the details of the ExternalWorkflowExecutionCancelRequested event.- initiatedEventId required EventId
- workflowExecution required WorkflowExecution
ExternalWorkflowExecutionSignaledEventAttributes
- ExternalWorkflowExecutionSignaledEventAttributes
object
: Provides the details of the ExternalWorkflowExecutionSignaled event.- initiatedEventId required EventId
- workflowExecution required WorkflowExecution
FailWorkflowExecutionDecisionAttributes
- 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 to OPERATION_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 Data
- reason FailureReason
FailWorkflowExecutionFailedCause
- FailWorkflowExecutionFailedCause
string
(values: UNHANDLED_DECISION, OPERATION_NOT_PERMITTED)
FailWorkflowExecutionFailedEventAttributes
- FailWorkflowExecutionFailedEventAttributes
object
: Provides the details of the FailWorkflowExecutionFailed event.- cause required FailWorkflowExecutionFailedCause
- decisionTaskCompletedEventId required EventId
FailureReason
- FailureReason
string
FunctionId
- FunctionId
string
FunctionInput
- FunctionInput
string
FunctionName
- FunctionName
string
GetWorkflowExecutionHistoryInput
- GetWorkflowExecutionHistoryInput
object
- domain required DomainName
- execution required WorkflowExecution
- maximumPageSize PageSize
- nextPageToken PageToken
- reverseOrder ReverseOrder
History
- 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 HistoryEventList
- nextPageToken PageToken
HistoryEvent
- HistoryEvent
object
: Event within a workflow execution. A history event can be one of these types: ActivityTaskCancelRequested – A RequestCancelActivityTask 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 a RecordMarker decision. RecordMarkerFailed – A RecordMarker 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 a StartTimer 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 ActivityTaskCancelRequestedEventAttributes
- activityTaskCanceledEventAttributes ActivityTaskCanceledEventAttributes
- activityTaskCompletedEventAttributes ActivityTaskCompletedEventAttributes
- activityTaskFailedEventAttributes ActivityTaskFailedEventAttributes
- activityTaskScheduledEventAttributes ActivityTaskScheduledEventAttributes
- activityTaskStartedEventAttributes ActivityTaskStartedEventAttributes
- activityTaskTimedOutEventAttributes ActivityTaskTimedOutEventAttributes
- cancelTimerFailedEventAttributes CancelTimerFailedEventAttributes
- cancelWorkflowExecutionFailedEventAttributes CancelWorkflowExecutionFailedEventAttributes
- childWorkflowExecutionCanceledEventAttributes ChildWorkflowExecutionCanceledEventAttributes
- childWorkflowExecutionCompletedEventAttributes ChildWorkflowExecutionCompletedEventAttributes
- childWorkflowExecutionFailedEventAttributes ChildWorkflowExecutionFailedEventAttributes
- childWorkflowExecutionStartedEventAttributes ChildWorkflowExecutionStartedEventAttributes
- childWorkflowExecutionTerminatedEventAttributes ChildWorkflowExecutionTerminatedEventAttributes
- childWorkflowExecutionTimedOutEventAttributes ChildWorkflowExecutionTimedOutEventAttributes
- completeWorkflowExecutionFailedEventAttributes CompleteWorkflowExecutionFailedEventAttributes
- continueAsNewWorkflowExecutionFailedEventAttributes ContinueAsNewWorkflowExecutionFailedEventAttributes
- decisionTaskCompletedEventAttributes DecisionTaskCompletedEventAttributes
- decisionTaskScheduledEventAttributes DecisionTaskScheduledEventAttributes
- decisionTaskStartedEventAttributes DecisionTaskStartedEventAttributes
- decisionTaskTimedOutEventAttributes DecisionTaskTimedOutEventAttributes
- eventId required EventId
- eventTimestamp required Timestamp
- eventType required EventType
- externalWorkflowExecutionCancelRequestedEventAttributes ExternalWorkflowExecutionCancelRequestedEventAttributes
- externalWorkflowExecutionSignaledEventAttributes ExternalWorkflowExecutionSignaledEventAttributes
- failWorkflowExecutionFailedEventAttributes FailWorkflowExecutionFailedEventAttributes
- lambdaFunctionCompletedEventAttributes LambdaFunctionCompletedEventAttributes
- lambdaFunctionFailedEventAttributes LambdaFunctionFailedEventAttributes
- lambdaFunctionScheduledEventAttributes LambdaFunctionScheduledEventAttributes
- lambdaFunctionStartedEventAttributes LambdaFunctionStartedEventAttributes
- lambdaFunctionTimedOutEventAttributes [LambdaFunctionTimedOutEventAt