WorkflowService.Iface (cadence-client 2.6.0 API)

All Known Subinterfaces:

IWorkflowService

All Known Implementing Classes:

TestWorkflowService, WorkflowService.Client, WorkflowServiceTChannel

Enclosing class:

WorkflowService
```
public static interface WorkflowService.Iface
```
WorkflowService API is exposed to provide support for long running applications. Application is expected to call StartWorkflowExecution to create an instance for each instance of long running workflow. Such applications are expected to have a worker which regularly polls for DecisionTask and ActivityTask from the WorkflowService. For each DecisionTask, application is expected to process the history of events for that session and respond back with next decisions. For each ActivityTask, application is expected to execute the actual logic for that task and respond back with completion or failure. Worker is expected to regularly heartbeat while activity task is running.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`CountWorkflowExecutionsResponse`	`CountWorkflowExecutions(CountWorkflowExecutionsRequest countRequest)` CountWorkflowExecutions is a visibility API to count of workflow executions in a specific domain.
`void`	`DeprecateDomain(DeprecateDomainRequest deprecateRequest)` DeprecateDomain us used to update status of a registered domain to DEPRECATED.
`DescribeDomainResponse`	`DescribeDomain(DescribeDomainRequest describeRequest)` DescribeDomain returns the information and configuration for a registered domain.
`DescribeTaskListResponse`	`DescribeTaskList(DescribeTaskListRequest request)` DescribeTaskList returns information about the target tasklist, right now this API returns the pollers which polled this tasklist in last few minutes.
`DescribeWorkflowExecutionResponse`	`DescribeWorkflowExecution(DescribeWorkflowExecutionRequest describeRequest)` DescribeWorkflowExecution returns information about the specified workflow execution.
`GetSearchAttributesResponse`	`GetSearchAttributes()` GetSearchAttributes is a visibility API to get all legal keys that could be used in list APIs
`GetWorkflowExecutionHistoryResponse`	`GetWorkflowExecutionHistory(GetWorkflowExecutionHistoryRequest getRequest)` Returns the history of specified workflow execution.
`ListClosedWorkflowExecutionsResponse`	`ListClosedWorkflowExecutions(ListClosedWorkflowExecutionsRequest listRequest)` ListClosedWorkflowExecutions is a visibility API to list the closed executions in a specific domain.
`ListDomainsResponse`	`ListDomains(ListDomainsRequest listRequest)` ListDomains returns the information and configuration for all domains.
`ListOpenWorkflowExecutionsResponse`	`ListOpenWorkflowExecutions(ListOpenWorkflowExecutionsRequest listRequest)` ListOpenWorkflowExecutions is a visibility API to list the open executions in a specific domain.
`ListWorkflowExecutionsResponse`	`ListWorkflowExecutions(ListWorkflowExecutionsRequest listRequest)` ListWorkflowExecutions is a visibility API to list workflow executions in a specific domain.
`PollForActivityTaskResponse`	`PollForActivityTask(PollForActivityTaskRequest pollRequest)` PollForActivityTask is called by application worker to process ActivityTask from a specific taskList.
`PollForDecisionTaskResponse`	`PollForDecisionTask(PollForDecisionTaskRequest pollRequest)` PollForDecisionTask is called by application worker to process DecisionTask from a specific taskList.
`QueryWorkflowResponse`	`QueryWorkflow(QueryWorkflowRequest queryRequest)` QueryWorkflow returns query result for a specified workflow execution
`RecordActivityTaskHeartbeatResponse`	`RecordActivityTaskHeartbeat(RecordActivityTaskHeartbeatRequest heartbeatRequest)` RecordActivityTaskHeartbeat is called by application worker while it is processing an ActivityTask.
`RecordActivityTaskHeartbeatResponse`	`RecordActivityTaskHeartbeatByID(RecordActivityTaskHeartbeatByIDRequest heartbeatRequest)` RecordActivityTaskHeartbeatByID is called by application worker while it is processing an ActivityTask.
`void`	`RegisterDomain(RegisterDomainRequest registerRequest)` RegisterDomain creates a new domain which can be used as a container for all resources.
`void`	`RequestCancelWorkflowExecution(RequestCancelWorkflowExecutionRequest cancelRequest)` RequestCancelWorkflowExecution is called by application worker when it wants to request cancellation of a workflow instance.
`ResetStickyTaskListResponse`	`ResetStickyTaskList(ResetStickyTaskListRequest resetRequest)` Reset the sticky tasklist related information in mutable state of a given workflow.
`ResetWorkflowExecutionResponse`	`ResetWorkflowExecution(ResetWorkflowExecutionRequest resetRequest)` ResetWorkflowExecution reset an existing workflow execution to DecisionTaskCompleted event(exclusive).
`void`	`RespondActivityTaskCanceled(RespondActivityTaskCanceledRequest canceledRequest)` RespondActivityTaskCanceled is called by application worker when it is successfully canceled an ActivityTask.
`void`	`RespondActivityTaskCanceledByID(RespondActivityTaskCanceledByIDRequest canceledRequest)` RespondActivityTaskCanceledByID is called by application worker when it is successfully canceled an ActivityTask.
`void`	`RespondActivityTaskCompleted(RespondActivityTaskCompletedRequest completeRequest)` RespondActivityTaskCompleted is called by application worker when it is done processing an ActivityTask.
`void`	`RespondActivityTaskCompletedByID(RespondActivityTaskCompletedByIDRequest completeRequest)` RespondActivityTaskCompletedByID is called by application worker when it is done processing an ActivityTask.
`void`	`RespondActivityTaskFailed(RespondActivityTaskFailedRequest failRequest)` RespondActivityTaskFailed is called by application worker when it is done processing an ActivityTask.
`void`	`RespondActivityTaskFailedByID(RespondActivityTaskFailedByIDRequest failRequest)` RespondActivityTaskFailedByID is called by application worker when it is done processing an ActivityTask.
`RespondDecisionTaskCompletedResponse`	`RespondDecisionTaskCompleted(RespondDecisionTaskCompletedRequest completeRequest)` RespondDecisionTaskCompleted is called by application worker to complete a DecisionTask handed as a result of 'PollForDecisionTask' API call.
`void`	`RespondDecisionTaskFailed(RespondDecisionTaskFailedRequest failedRequest)` RespondDecisionTaskFailed is called by application worker to indicate failure.
`void`	`RespondQueryTaskCompleted(RespondQueryTaskCompletedRequest completeRequest)` RespondQueryTaskCompleted is called by application worker to complete a QueryTask (which is a DecisionTask for query) as a result of 'PollForDecisionTask' API call.
`ListWorkflowExecutionsResponse`	`ScanWorkflowExecutions(ListWorkflowExecutionsRequest listRequest)` ScanWorkflowExecutions is a visibility API to list large amount of workflow executions in a specific domain without order.
`StartWorkflowExecutionResponse`	`SignalWithStartWorkflowExecution(SignalWithStartWorkflowExecutionRequest signalWithStartRequest)` SignalWithStartWorkflowExecution is used to ensure sending signal to a workflow.
`void`	`SignalWorkflowExecution(SignalWorkflowExecutionRequest signalRequest)` SignalWorkflowExecution is used to send a signal event to running workflow execution.
`StartWorkflowExecutionResponse`	`StartWorkflowExecution(StartWorkflowExecutionRequest startRequest)` StartWorkflowExecution starts a new long running workflow instance.
`void`	`TerminateWorkflowExecution(TerminateWorkflowExecutionRequest terminateRequest)` TerminateWorkflowExecution terminates an existing workflow execution by recording WorkflowExecutionTerminated event in the history and immediately terminating the execution instance.
`UpdateDomainResponse`	`UpdateDomain(UpdateDomainRequest updateRequest)` UpdateDomain is used to update the information and configuration for a registered domain.

Method Detail

RegisterDomain
```
void RegisterDomain(RegisterDomainRequest registerRequest)
             throws BadRequestError,
                    InternalServiceError,
                    DomainAlreadyExistsError,
                    ServiceBusyError,
                    ClientVersionNotSupportedError,
                    org.apache.thrift.TException
```
RegisterDomain creates a new domain which can be used as a container for all resources. Domain is a top level entity within Cadence, used as a container for all resources like workflow executions, tasklists, etc. Domain acts as a sandbox and provides isolation for all resources within the domain. All resources belongs to exactly one domain.

Parameters:

registerRequest -

Throws:

BadRequestError

InternalServiceError

DomainAlreadyExistsError

ServiceBusyError

ClientVersionNotSupportedError

org.apache.thrift.TException

DescribeDomain

DescribeDomainResponse DescribeDomain(DescribeDomainRequest describeRequest)
                               throws BadRequestError,
                                      InternalServiceError,
                                      EntityNotExistsError,
                                      ServiceBusyError,
                                      ClientVersionNotSupportedError,
                                      org.apache.thrift.TException

DescribeDomain returns the information and configuration for a registered domain.

Parameters:: describeRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

ListDomains

ListDomainsResponse ListDomains(ListDomainsRequest listRequest)
                         throws BadRequestError,
                                InternalServiceError,
                                EntityNotExistsError,
                                ServiceBusyError,
                                ClientVersionNotSupportedError,
                                org.apache.thrift.TException

ListDomains returns the information and configuration for all domains.

Parameters:: listRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

UpdateDomain

UpdateDomainResponse UpdateDomain(UpdateDomainRequest updateRequest)
                           throws BadRequestError,
                                  InternalServiceError,
                                  EntityNotExistsError,
                                  ServiceBusyError,
                                  DomainNotActiveError,
                                  ClientVersionNotSupportedError,
                                  org.apache.thrift.TException

UpdateDomain is used to update the information and configuration for a registered domain.

Parameters:: updateRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; DomainNotActiveError; ClientVersionNotSupportedError; org.apache.thrift.TException

DeprecateDomain

void DeprecateDomain(DeprecateDomainRequest deprecateRequest)
              throws BadRequestError,
                     InternalServiceError,
                     EntityNotExistsError,
                     ServiceBusyError,
                     DomainNotActiveError,
                     ClientVersionNotSupportedError,
                     org.apache.thrift.TException

DeprecateDomain us used to update status of a registered domain to DEPRECATED. Once the domain is deprecated it cannot be used to start new workflow executions. Existing workflow executions will continue to run on deprecated domains.

Parameters:: deprecateRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; DomainNotActiveError; ClientVersionNotSupportedError; org.apache.thrift.TException

StartWorkflowExecution

StartWorkflowExecutionResponse StartWorkflowExecution(StartWorkflowExecutionRequest startRequest)
                                               throws BadRequestError,
                                                      InternalServiceError,
                                                      WorkflowExecutionAlreadyStartedError,
                                                      ServiceBusyError,
                                                      DomainNotActiveError,
                                                      LimitExceededError,
                                                      EntityNotExistsError,
                                                      ClientVersionNotSupportedError,
                                                      org.apache.thrift.TException

StartWorkflowExecution starts a new long running workflow instance. It will create the instance with 'WorkflowExecutionStarted' event in history and also schedule the first DecisionTask for the worker to make the first decision for this instance. It will return 'WorkflowExecutionAlreadyStartedError', if an instance already exists with same workflowId.

Parameters:: startRequest -
Throws:: BadRequestError; InternalServiceError; WorkflowExecutionAlreadyStartedError; ServiceBusyError; DomainNotActiveError; LimitExceededError; EntityNotExistsError; ClientVersionNotSupportedError; org.apache.thrift.TException

GetWorkflowExecutionHistory

GetWorkflowExecutionHistoryResponse GetWorkflowExecutionHistory(GetWorkflowExecutionHistoryRequest getRequest)
                                                         throws BadRequestError,
                                                                InternalServiceError,
                                                                EntityNotExistsError,
                                                                ServiceBusyError,
                                                                ClientVersionNotSupportedError,
                                                                org.apache.thrift.TException

Returns the history of specified workflow execution. It fails with 'EntityNotExistError' if speficied workflow execution in unknown to the service.

Parameters:: getRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

PollForDecisionTask

PollForDecisionTaskResponse PollForDecisionTask(PollForDecisionTaskRequest pollRequest)
                                         throws BadRequestError,
                                                InternalServiceError,
                                                ServiceBusyError,
                                                LimitExceededError,
                                                EntityNotExistsError,
                                                DomainNotActiveError,
                                                ClientVersionNotSupportedError,
                                                org.apache.thrift.TException

PollForDecisionTask is called by application worker to process DecisionTask from a specific taskList. A DecisionTask is dispatched to callers for active workflow executions, with pending decisions. Application is then expected to call 'RespondDecisionTaskCompleted' API when it is done processing the DecisionTask. It will also create a 'DecisionTaskStarted' event in the history for that session before handing off DecisionTask to application worker.

Parameters:: pollRequest -
Throws:: BadRequestError; InternalServiceError; ServiceBusyError; LimitExceededError; EntityNotExistsError; DomainNotActiveError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondDecisionTaskCompleted

RespondDecisionTaskCompletedResponse RespondDecisionTaskCompleted(RespondDecisionTaskCompletedRequest completeRequest)
                                                           throws BadRequestError,
                                                                  InternalServiceError,
                                                                  EntityNotExistsError,
                                                                  DomainNotActiveError,
                                                                  LimitExceededError,
                                                                  ServiceBusyError,
                                                                  ClientVersionNotSupportedError,
                                                                  org.apache.thrift.TException

RespondDecisionTaskCompleted is called by application worker to complete a DecisionTask handed as a result of 'PollForDecisionTask' API call. Completing a DecisionTask will result in new events for the workflow execution and potentially new ActivityTask being created for corresponding decisions. It will also create a DecisionTaskCompleted event in the history for that session. Use the 'taskToken' provided as response of PollForDecisionTask API call for completing the DecisionTask. The response could contain a new decision task if there is one or if the request asking for one.

Parameters:: completeRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondDecisionTaskFailed

void RespondDecisionTaskFailed(RespondDecisionTaskFailedRequest failedRequest)
                        throws BadRequestError,
                               InternalServiceError,
                               EntityNotExistsError,
                               DomainNotActiveError,
                               LimitExceededError,
                               ServiceBusyError,
                               ClientVersionNotSupportedError,
                               org.apache.thrift.TException

RespondDecisionTaskFailed is called by application worker to indicate failure. This results in DecisionTaskFailedEvent written to the history and a new DecisionTask created. This API can be used by client to either clear sticky tasklist or report any panics during DecisionTask processing. Cadence will only append first DecisionTaskFailed event to the history of workflow execution for consecutive failures.

Parameters:: failedRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

PollForActivityTask

PollForActivityTaskResponse PollForActivityTask(PollForActivityTaskRequest pollRequest)
                                         throws BadRequestError,
                                                InternalServiceError,
                                                ServiceBusyError,
                                                LimitExceededError,
                                                EntityNotExistsError,
                                                DomainNotActiveError,
                                                ClientVersionNotSupportedError,
                                                org.apache.thrift.TException

PollForActivityTask is called by application worker to process ActivityTask from a specific taskList. ActivityTask is dispatched to callers whenever a ScheduleTask decision is made for a workflow execution. Application is expected to call 'RespondActivityTaskCompleted' or 'RespondActivityTaskFailed' once it is done processing the task. Application also needs to call 'RecordActivityTaskHeartbeat' API within 'heartbeatTimeoutSeconds' interval to prevent the task from getting timed out. An event 'ActivityTaskStarted' event is also written to workflow execution history before the ActivityTask is dispatched to application worker.

Parameters:: pollRequest -
Throws:: BadRequestError; InternalServiceError; ServiceBusyError; LimitExceededError; EntityNotExistsError; DomainNotActiveError; ClientVersionNotSupportedError; org.apache.thrift.TException

RecordActivityTaskHeartbeat

RecordActivityTaskHeartbeatResponse RecordActivityTaskHeartbeat(RecordActivityTaskHeartbeatRequest heartbeatRequest)
                                                         throws BadRequestError,
                                                                InternalServiceError,
                                                                EntityNotExistsError,
                                                                DomainNotActiveError,
                                                                LimitExceededError,
                                                                ServiceBusyError,
                                                                ClientVersionNotSupportedError,
                                                                org.apache.thrift.TException

RecordActivityTaskHeartbeat is called by application worker while it is processing an ActivityTask. If worker fails to heartbeat within 'heartbeatTimeoutSeconds' interval for the ActivityTask, then it will be marked as timedout and 'ActivityTaskTimedOut' event will be written to the workflow history. Calling 'RecordActivityTaskHeartbeat' will fail with 'EntityNotExistsError' in such situations. Use the 'taskToken' provided as response of PollForActivityTask API call for heartbeating.

Parameters:: heartbeatRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RecordActivityTaskHeartbeatByID

RecordActivityTaskHeartbeatResponse RecordActivityTaskHeartbeatByID(RecordActivityTaskHeartbeatByIDRequest heartbeatRequest)
                                                             throws BadRequestError,
                                                                    InternalServiceError,
                                                                    EntityNotExistsError,
                                                                    DomainNotActiveError,
                                                                    LimitExceededError,
                                                                    ServiceBusyError,
                                                                    ClientVersionNotSupportedError,
                                                                    org.apache.thrift.TException

RecordActivityTaskHeartbeatByID is called by application worker while it is processing an ActivityTask. If worker fails to heartbeat within 'heartbeatTimeoutSeconds' interval for the ActivityTask, then it will be marked as timedout and 'ActivityTaskTimedOut' event will be written to the workflow history. Calling 'RecordActivityTaskHeartbeatByID' will fail with 'EntityNotExistsError' in such situations. Instead of using 'taskToken' like in RecordActivityTaskHeartbeat, use Domain, WorkflowID and ActivityID

Parameters:: heartbeatRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondActivityTaskCompleted

void RespondActivityTaskCompleted(RespondActivityTaskCompletedRequest completeRequest)
                           throws BadRequestError,
                                  InternalServiceError,
                                  EntityNotExistsError,
                                  DomainNotActiveError,
                                  LimitExceededError,
                                  ServiceBusyError,
                                  ClientVersionNotSupportedError,
                                  org.apache.thrift.TException

RespondActivityTaskCompleted is called by application worker when it is done processing an ActivityTask. It will result in a new 'ActivityTaskCompleted' event being written to the workflow history and a new DecisionTask created for the workflow so new decisions could be made. Use the 'taskToken' provided as response of PollForActivityTask API call for completion. It fails with 'EntityNotExistsError' if the taskToken is not valid anymore due to activity timeout.

Parameters:: completeRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondActivityTaskCompletedByID

void RespondActivityTaskCompletedByID(RespondActivityTaskCompletedByIDRequest completeRequest)
                               throws BadRequestError,
                                      InternalServiceError,
                                      EntityNotExistsError,
                                      DomainNotActiveError,
                                      LimitExceededError,
                                      ServiceBusyError,
                                      ClientVersionNotSupportedError,
                                      org.apache.thrift.TException

RespondActivityTaskCompletedByID is called by application worker when it is done processing an ActivityTask. It will result in a new 'ActivityTaskCompleted' event being written to the workflow history and a new DecisionTask created for the workflow so new decisions could be made. Similar to RespondActivityTaskCompleted but use Domain, WorkflowID and ActivityID instead of 'taskToken' for completion. It fails with 'EntityNotExistsError' if the these IDs are not valid anymore due to activity timeout.

Parameters:: completeRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondActivityTaskFailed

void RespondActivityTaskFailed(RespondActivityTaskFailedRequest failRequest)
                        throws BadRequestError,
                               InternalServiceError,
                               EntityNotExistsError,
                               DomainNotActiveError,
                               LimitExceededError,
                               ServiceBusyError,
                               ClientVersionNotSupportedError,
                               org.apache.thrift.TException

RespondActivityTaskFailed is called by application worker when it is done processing an ActivityTask. It will result in a new 'ActivityTaskFailed' event being written to the workflow history and a new DecisionTask created for the workflow instance so new decisions could be made. Use the 'taskToken' provided as response of PollForActivityTask API call for completion. It fails with 'EntityNotExistsError' if the taskToken is not valid anymore due to activity timeout.

Parameters:: failRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondActivityTaskFailedByID

void RespondActivityTaskFailedByID(RespondActivityTaskFailedByIDRequest failRequest)
                            throws BadRequestError,
                                   InternalServiceError,
                                   EntityNotExistsError,
                                   DomainNotActiveError,
                                   LimitExceededError,
                                   ServiceBusyError,
                                   ClientVersionNotSupportedError,
                                   org.apache.thrift.TException

RespondActivityTaskFailedByID is called by application worker when it is done processing an ActivityTask. It will result in a new 'ActivityTaskFailed' event being written to the workflow history and a new DecisionTask created for the workflow instance so new decisions could be made. Similar to RespondActivityTaskFailed but use Domain, WorkflowID and ActivityID instead of 'taskToken' for completion. It fails with 'EntityNotExistsError' if the these IDs are not valid anymore due to activity timeout.

Parameters:: failRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondActivityTaskCanceled

void RespondActivityTaskCanceled(RespondActivityTaskCanceledRequest canceledRequest)
                          throws BadRequestError,
                                 InternalServiceError,
                                 EntityNotExistsError,
                                 DomainNotActiveError,
                                 LimitExceededError,
                                 ServiceBusyError,
                                 ClientVersionNotSupportedError,
                                 org.apache.thrift.TException

RespondActivityTaskCanceled is called by application worker when it is successfully canceled an ActivityTask. It will result in a new 'ActivityTaskCanceled' event being written to the workflow history and a new DecisionTask created for the workflow instance so new decisions could be made. Use the 'taskToken' provided as response of PollForActivityTask API call for completion. It fails with 'EntityNotExistsError' if the taskToken is not valid anymore due to activity timeout.

Parameters:: canceledRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondActivityTaskCanceledByID

void RespondActivityTaskCanceledByID(RespondActivityTaskCanceledByIDRequest canceledRequest)
                              throws BadRequestError,
                                     InternalServiceError,
                                     EntityNotExistsError,
                                     DomainNotActiveError,
                                     LimitExceededError,
                                     ServiceBusyError,
                                     ClientVersionNotSupportedError,
                                     org.apache.thrift.TException

RespondActivityTaskCanceledByID is called by application worker when it is successfully canceled an ActivityTask. It will result in a new 'ActivityTaskCanceled' event being written to the workflow history and a new DecisionTask created for the workflow instance so new decisions could be made. Similar to RespondActivityTaskCanceled but use Domain, WorkflowID and ActivityID instead of 'taskToken' for completion. It fails with 'EntityNotExistsError' if the these IDs are not valid anymore due to activity timeout.

Parameters:: canceledRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; DomainNotActiveError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RequestCancelWorkflowExecution

void RequestCancelWorkflowExecution(RequestCancelWorkflowExecutionRequest cancelRequest)
                             throws BadRequestError,
                                    InternalServiceError,
                                    EntityNotExistsError,
                                    CancellationAlreadyRequestedError,
                                    ServiceBusyError,
                                    DomainNotActiveError,
                                    LimitExceededError,
                                    ClientVersionNotSupportedError,
                                    org.apache.thrift.TException

RequestCancelWorkflowExecution is called by application worker when it wants to request cancellation of a workflow instance. It will result in a new 'WorkflowExecutionCancelRequested' event being written to the workflow history and a new DecisionTask created for the workflow instance so new decisions could be made. It fails with 'EntityNotExistsError' if the workflow is not valid anymore due to completion or doesn't exist.

Parameters:: cancelRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; CancellationAlreadyRequestedError; ServiceBusyError; DomainNotActiveError; LimitExceededError; ClientVersionNotSupportedError; org.apache.thrift.TException

SignalWorkflowExecution

void SignalWorkflowExecution(SignalWorkflowExecutionRequest signalRequest)
                      throws BadRequestError,
                             InternalServiceError,
                             EntityNotExistsError,
                             ServiceBusyError,
                             DomainNotActiveError,
                             LimitExceededError,
                             ClientVersionNotSupportedError,
                             org.apache.thrift.TException

SignalWorkflowExecution is used to send a signal event to running workflow execution. This results in WorkflowExecutionSignaled event recorded in the history and a decision task being created for the execution.

Parameters:: signalRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; DomainNotActiveError; LimitExceededError; ClientVersionNotSupportedError; org.apache.thrift.TException

SignalWithStartWorkflowExecution

StartWorkflowExecutionResponse SignalWithStartWorkflowExecution(SignalWithStartWorkflowExecutionRequest signalWithStartRequest)
                                                         throws BadRequestError,
                                                                InternalServiceError,
                                                                EntityNotExistsError,
                                                                ServiceBusyError,
                                                                DomainNotActiveError,
                                                                LimitExceededError,
                                                                WorkflowExecutionAlreadyStartedError,
                                                                ClientVersionNotSupportedError,
                                                                org.apache.thrift.TException

SignalWithStartWorkflowExecution is used to ensure sending signal to a workflow. If the workflow is running, this results in WorkflowExecutionSignaled event being recorded in the history and a decision task being created for the execution. If the workflow is not running or not found, this results in WorkflowExecutionStarted and WorkflowExecutionSignaled events being recorded in history, and a decision task being created for the execution

Parameters:: signalWithStartRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; DomainNotActiveError; LimitExceededError; WorkflowExecutionAlreadyStartedError; ClientVersionNotSupportedError; org.apache.thrift.TException

ResetWorkflowExecution

ResetWorkflowExecutionResponse ResetWorkflowExecution(ResetWorkflowExecutionRequest resetRequest)
                                               throws BadRequestError,
                                                      InternalServiceError,
                                                      EntityNotExistsError,
                                                      ServiceBusyError,
                                                      DomainNotActiveError,
                                                      LimitExceededError,
                                                      ClientVersionNotSupportedError,
                                                      org.apache.thrift.TException

ResetWorkflowExecution reset an existing workflow execution to DecisionTaskCompleted event(exclusive). And it will immediately terminating the current execution instance.

Parameters:: resetRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; DomainNotActiveError; LimitExceededError; ClientVersionNotSupportedError; org.apache.thrift.TException

TerminateWorkflowExecution

void TerminateWorkflowExecution(TerminateWorkflowExecutionRequest terminateRequest)
                         throws BadRequestError,
                                InternalServiceError,
                                EntityNotExistsError,
                                ServiceBusyError,
                                DomainNotActiveError,
                                LimitExceededError,
                                ClientVersionNotSupportedError,
                                org.apache.thrift.TException

TerminateWorkflowExecution terminates an existing workflow execution by recording WorkflowExecutionTerminated event in the history and immediately terminating the execution instance.

Parameters:: terminateRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; DomainNotActiveError; LimitExceededError; ClientVersionNotSupportedError; org.apache.thrift.TException

ListOpenWorkflowExecutions

ListOpenWorkflowExecutionsResponse ListOpenWorkflowExecutions(ListOpenWorkflowExecutionsRequest listRequest)
                                                       throws BadRequestError,
                                                              InternalServiceError,
                                                              EntityNotExistsError,
                                                              ServiceBusyError,
                                                              LimitExceededError,
                                                              ClientVersionNotSupportedError,
                                                              org.apache.thrift.TException

ListOpenWorkflowExecutions is a visibility API to list the open executions in a specific domain.

Parameters:: listRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; LimitExceededError; ClientVersionNotSupportedError; org.apache.thrift.TException

ListClosedWorkflowExecutions

ListClosedWorkflowExecutionsResponse ListClosedWorkflowExecutions(ListClosedWorkflowExecutionsRequest listRequest)
                                                           throws BadRequestError,
                                                                  InternalServiceError,
                                                                  EntityNotExistsError,
                                                                  ServiceBusyError,
                                                                  ClientVersionNotSupportedError,
                                                                  org.apache.thrift.TException

ListClosedWorkflowExecutions is a visibility API to list the closed executions in a specific domain.

Parameters:: listRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

ListWorkflowExecutions

ListWorkflowExecutionsResponse ListWorkflowExecutions(ListWorkflowExecutionsRequest listRequest)
                                               throws BadRequestError,
                                                      InternalServiceError,
                                                      EntityNotExistsError,
                                                      ServiceBusyError,
                                                      ClientVersionNotSupportedError,
                                                      org.apache.thrift.TException

ListWorkflowExecutions is a visibility API to list workflow executions in a specific domain.

Parameters:: listRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

ScanWorkflowExecutions

ListWorkflowExecutionsResponse ScanWorkflowExecutions(ListWorkflowExecutionsRequest listRequest)
                                               throws BadRequestError,
                                                      InternalServiceError,
                                                      EntityNotExistsError,
                                                      ServiceBusyError,
                                                      ClientVersionNotSupportedError,
                                                      org.apache.thrift.TException

ScanWorkflowExecutions is a visibility API to list large amount of workflow executions in a specific domain without order.

Parameters:: listRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

CountWorkflowExecutions

CountWorkflowExecutionsResponse CountWorkflowExecutions(CountWorkflowExecutionsRequest countRequest)
                                                 throws BadRequestError,
                                                        InternalServiceError,
                                                        EntityNotExistsError,
                                                        ServiceBusyError,
                                                        ClientVersionNotSupportedError,
                                                        org.apache.thrift.TException

CountWorkflowExecutions is a visibility API to count of workflow executions in a specific domain.

Parameters:: countRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

GetSearchAttributes

GetSearchAttributesResponse GetSearchAttributes()
                                         throws InternalServiceError,
                                                ServiceBusyError,
                                                ClientVersionNotSupportedError,
                                                org.apache.thrift.TException

GetSearchAttributes is a visibility API to get all legal keys that could be used in list APIs

Throws:: InternalServiceError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

RespondQueryTaskCompleted

void RespondQueryTaskCompleted(RespondQueryTaskCompletedRequest completeRequest)
                        throws BadRequestError,
                               InternalServiceError,
                               EntityNotExistsError,
                               LimitExceededError,
                               ServiceBusyError,
                               DomainNotActiveError,
                               ClientVersionNotSupportedError,
                               org.apache.thrift.TException

RespondQueryTaskCompleted is called by application worker to complete a QueryTask (which is a DecisionTask for query) as a result of 'PollForDecisionTask' API call. Completing a QueryTask will unblock the client call to 'QueryWorkflow' API and return the query result to client as a response to 'QueryWorkflow' API call.

Parameters:: completeRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; LimitExceededError; ServiceBusyError; DomainNotActiveError; ClientVersionNotSupportedError; org.apache.thrift.TException

ResetStickyTaskList

ResetStickyTaskListResponse ResetStickyTaskList(ResetStickyTaskListRequest resetRequest)
                                         throws BadRequestError,
                                                InternalServiceError,
                                                EntityNotExistsError,
                                                LimitExceededError,
                                                ServiceBusyError,
                                                DomainNotActiveError,
                                                ClientVersionNotSupportedError,
                                                org.apache.thrift.TException

Reset the sticky tasklist related information in mutable state of a given workflow. Things cleared are: 1. StickyTaskList 2. StickyScheduleToStartTimeout 3. ClientLibraryVersion 4. ClientFeatureVersion 5. ClientImpl

Parameters:: resetRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; LimitExceededError; ServiceBusyError; DomainNotActiveError; ClientVersionNotSupportedError; org.apache.thrift.TException

QueryWorkflow

QueryWorkflowResponse QueryWorkflow(QueryWorkflowRequest queryRequest)
                             throws BadRequestError,
                                    InternalServiceError,
                                    EntityNotExistsError,
                                    QueryFailedError,
                                    LimitExceededError,
                                    ServiceBusyError,
                                    ClientVersionNotSupportedError,
                                    org.apache.thrift.TException

QueryWorkflow returns query result for a specified workflow execution

Parameters:: queryRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; QueryFailedError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

DescribeWorkflowExecution

DescribeWorkflowExecutionResponse DescribeWorkflowExecution(DescribeWorkflowExecutionRequest describeRequest)
                                                     throws BadRequestError,
                                                            InternalServiceError,
                                                            EntityNotExistsError,
                                                            LimitExceededError,
                                                            ServiceBusyError,
                                                            ClientVersionNotSupportedError,
                                                            org.apache.thrift.TException

DescribeWorkflowExecution returns information about the specified workflow execution.

Parameters:: describeRequest -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

DescribeTaskList

DescribeTaskListResponse DescribeTaskList(DescribeTaskListRequest request)
                                   throws BadRequestError,
                                          InternalServiceError,
                                          EntityNotExistsError,
                                          LimitExceededError,
                                          ServiceBusyError,
                                          ClientVersionNotSupportedError,
                                          org.apache.thrift.TException

DescribeTaskList returns information about the target tasklist, right now this API returns the pollers which polled this tasklist in last few minutes.

Parameters:: request -
Throws:: BadRequestError; InternalServiceError; EntityNotExistsError; LimitExceededError; ServiceBusyError; ClientVersionNotSupportedError; org.apache.thrift.TException

Interface WorkflowService.Iface