@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAWSStepFunctions extends Object implements AWSStepFunctions
AWSStepFunctions
. Convenient method forms pass through to the corresponding
overload that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier | Constructor and Description |
---|---|
protected |
AbstractAWSStepFunctions() |
Modifier and Type | Method and Description |
---|---|
CreateActivityResult |
createActivity(CreateActivityRequest request)
Creates an activity.
|
CreateStateMachineResult |
createStateMachine(CreateStateMachineRequest request)
Creates a state machine.
|
DeleteActivityResult |
deleteActivity(DeleteActivityRequest request)
Deletes an activity.
|
DeleteStateMachineResult |
deleteStateMachine(DeleteStateMachineRequest request)
Deletes a state machine.
|
DescribeActivityResult |
describeActivity(DescribeActivityRequest request)
Describes an activity.
|
DescribeExecutionResult |
describeExecution(DescribeExecutionRequest request)
Describes an execution.
|
DescribeStateMachineResult |
describeStateMachine(DescribeStateMachineRequest request)
Describes a state machine.
|
DescribeStateMachineForExecutionResult |
describeStateMachineForExecution(DescribeStateMachineForExecutionRequest request)
Describes the state machine associated with a specific execution.
|
GetActivityTaskResult |
getActivityTask(GetActivityTaskRequest request)
Used by workers to retrieve a task (with the specified activity ARN) which has been scheduled for execution by a
running state machine.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetExecutionHistoryResult |
getExecutionHistory(GetExecutionHistoryRequest request)
Returns the history of the specified execution as a list of events.
|
ListActivitiesResult |
listActivities(ListActivitiesRequest request)
Lists the existing activities.
|
ListExecutionsResult |
listExecutions(ListExecutionsRequest request)
Lists the executions of a state machine that meet the filtering criteria.
|
ListStateMachinesResult |
listStateMachines(ListStateMachinesRequest request)
Lists the existing state machines.
|
SendTaskFailureResult |
sendTaskFailure(SendTaskFailureRequest request)
Used by workers to report that the task identified by the
taskToken failed. |
SendTaskHeartbeatResult |
sendTaskHeartbeat(SendTaskHeartbeatRequest request)
Used by workers to report to the service that the task represented by the specified
taskToken is
still making progress. |
SendTaskSuccessResult |
sendTaskSuccess(SendTaskSuccessRequest request)
Used by workers to report that the task identified by the
taskToken completed successfully. |
void |
setEndpoint(String endpoint)
Overrides the default endpoint for this client ("states.us-east-1.amazonaws.com").
|
void |
setRegion(Region region)
An alternative to
AWSStepFunctions.setEndpoint(String) , sets the regional endpoint for this client's
service calls. |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartExecutionResult |
startExecution(StartExecutionRequest request)
Starts a state machine execution.
|
StopExecutionResult |
stopExecution(StopExecutionRequest request)
Stops an execution.
|
UpdateStateMachineResult |
updateStateMachine(UpdateStateMachineRequest request)
Updates an existing state machine by modifying its
definition and/or roleArn . |
public void setEndpoint(String endpoint)
AWSStepFunctions
Callers can pass in just the endpoint (ex: "states.us-east-1.amazonaws.com") or a full URL, including the
protocol (ex: "states.us-east-1.amazonaws.com"). If the protocol is not specified here, the default protocol from
this client's ClientConfiguration
will be used, which by default is HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-region-selection.html#region-selection- choose-endpoint
This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
setEndpoint
in interface AWSStepFunctions
endpoint
- The endpoint (ex: "states.us-east-1.amazonaws.com") or a full URL, including the protocol (ex:
"states.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will communicate with.public void setRegion(Region region)
AWSStepFunctions
AWSStepFunctions.setEndpoint(String)
, sets the regional endpoint for this client's
service calls. Callers can use this method to control which AWS region they want to work with.
By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the
ClientConfiguration
supplied at construction.
This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
setRegion
in interface AWSStepFunctions
region
- The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions)
for accessing a given region. Must not be null and must be a region where the service is available.Region.getRegion(com.amazonaws.regions.Regions)
,
Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
,
Region.isServiceSupported(String)
public CreateActivityResult createActivity(CreateActivityRequest request)
AWSStepFunctions
Creates an activity. An activity is a task which you write in any programming language and host on any machine
which has access to AWS Step Functions. Activities must poll Step Functions using the
GetActivityTask
API action and respond using SendTask*
API actions. This function lets
Step Functions know the existence of your activity and returns an identifier for use in a state machine and when
polling from the activity.
createActivity
in interface AWSStepFunctions
public CreateStateMachineResult createStateMachine(CreateStateMachineRequest request)
AWSStepFunctions
Creates a state machine. A state machine consists of a collection of states that can do work (Task
states), determine to which states to transition next (Choice
states), stop an execution with an
error (Fail
states), and so on. State machines are specified using a JSON-based, structured
language.
createStateMachine
in interface AWSStepFunctions
public DeleteActivityResult deleteActivity(DeleteActivityRequest request)
AWSStepFunctions
Deletes an activity.
deleteActivity
in interface AWSStepFunctions
public DeleteStateMachineResult deleteStateMachine(DeleteStateMachineRequest request)
AWSStepFunctions
Deletes a state machine. This is an asynchronous operation: It sets the state machine's status to
DELETING
and begins the deletion process. Each state machine execution is deleted the next time it
makes a state transition.
The state machine itself is deleted after all executions are completed or deleted.
deleteStateMachine
in interface AWSStepFunctions
public DescribeActivityResult describeActivity(DescribeActivityRequest request)
AWSStepFunctions
Describes an activity.
describeActivity
in interface AWSStepFunctions
public DescribeExecutionResult describeExecution(DescribeExecutionRequest request)
AWSStepFunctions
Describes an execution.
describeExecution
in interface AWSStepFunctions
public DescribeStateMachineResult describeStateMachine(DescribeStateMachineRequest request)
AWSStepFunctions
Describes a state machine.
describeStateMachine
in interface AWSStepFunctions
public DescribeStateMachineForExecutionResult describeStateMachineForExecution(DescribeStateMachineForExecutionRequest request)
AWSStepFunctions
Describes the state machine associated with a specific execution.
describeStateMachineForExecution
in interface AWSStepFunctions
public GetActivityTaskResult getActivityTask(GetActivityTaskRequest request)
AWSStepFunctions
Used by workers to retrieve a task (with the specified activity ARN) which has been scheduled for execution by a
running state machine. This initiates a long poll, where the service holds the HTTP connection open and responds
as soon as a task becomes available (i.e. an execution of a task of this type is needed.) The maximum time the
service holds on to the request before responding is 60 seconds. If no task is available within 60 seconds, the
poll returns a taskToken
with a null string.
Workers should set their client side socket timeout to at least 65 seconds (5 seconds higher than the maximum time the service may hold the poll request).
getActivityTask
in interface AWSStepFunctions
public GetExecutionHistoryResult getExecutionHistory(GetExecutionHistoryRequest request)
AWSStepFunctions
Returns the history of the specified execution as a list of events. By default, the results are returned in
ascending order of the timeStamp
of the events. Use the reverseOrder
parameter to get
the latest events first.
If a nextToken
is returned by a previous call, there are more results available. To retrieve the
next page of results, make the call again using the returned token in nextToken
. Keep all other
arguments unchanged.
getExecutionHistory
in interface AWSStepFunctions
public ListActivitiesResult listActivities(ListActivitiesRequest request)
AWSStepFunctions
Lists the existing activities.
If a nextToken
is returned by a previous call, there are more results available. To retrieve the
next page of results, make the call again using the returned token in nextToken
. Keep all other
arguments unchanged.
listActivities
in interface AWSStepFunctions
public ListExecutionsResult listExecutions(ListExecutionsRequest request)
AWSStepFunctions
Lists the executions of a state machine that meet the filtering criteria.
If a nextToken
is returned by a previous call, there are more results available. To retrieve the
next page of results, make the call again using the returned token in nextToken
. Keep all other
arguments unchanged.
listExecutions
in interface AWSStepFunctions
public ListStateMachinesResult listStateMachines(ListStateMachinesRequest request)
AWSStepFunctions
Lists the existing state machines.
If a nextToken
is returned by a previous call, there are more results available. To retrieve the
next page of results, make the call again using the returned token in nextToken
. Keep all other
arguments unchanged.
listStateMachines
in interface AWSStepFunctions
public SendTaskFailureResult sendTaskFailure(SendTaskFailureRequest request)
AWSStepFunctions
Used by workers to report that the task identified by the taskToken
failed.
sendTaskFailure
in interface AWSStepFunctions
public SendTaskHeartbeatResult sendTaskHeartbeat(SendTaskHeartbeatRequest request)
AWSStepFunctions
Used by workers to report to the service that the task represented by the specified taskToken
is
still making progress. This action resets the Heartbeat
clock. The Heartbeat
threshold
is specified in the state machine's Amazon States Language definition. This action does not in itself create an
event in the execution history. However, if the task times out, the execution history contains an
ActivityTimedOut
event.
The Timeout
of a task, defined in the state machine's Amazon States Language definition, is its
maximum allowed duration, regardless of the number of SendTaskHeartbeat requests received.
This operation is only useful for long-lived tasks to report the liveliness of the task.
sendTaskHeartbeat
in interface AWSStepFunctions
public SendTaskSuccessResult sendTaskSuccess(SendTaskSuccessRequest request)
AWSStepFunctions
Used by workers to report that the task identified by the taskToken
completed successfully.
sendTaskSuccess
in interface AWSStepFunctions
public StartExecutionResult startExecution(StartExecutionRequest request)
AWSStepFunctions
Starts a state machine execution.
startExecution
in interface AWSStepFunctions
public StopExecutionResult stopExecution(StopExecutionRequest request)
AWSStepFunctions
Stops an execution.
stopExecution
in interface AWSStepFunctions
public UpdateStateMachineResult updateStateMachine(UpdateStateMachineRequest request)
AWSStepFunctions
Updates an existing state machine by modifying its definition
and/or roleArn
. Running
executions will continue to use the previous definition
and roleArn
.
All StartExecution
calls within a few seconds will use the updated definition
and
roleArn
. Executions started immediately after calling UpdateStateMachine
may use the
previous state machine definition
and roleArn
. You must include at least one of
definition
or roleArn
or you will receive a MissingRequiredParameter
error.
updateStateMachine
in interface AWSStepFunctions
public void shutdown()
AWSStepFunctions
shutdown
in interface AWSStepFunctions
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AWSStepFunctions
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AWSStepFunctions
request
- The originally executed request.Copyright © 2018. All rights reserved.