import { SFNClient } from "./SFNClient"; import { CreateActivityInput } from "./types/CreateActivityInput"; import { CreateActivityOutput } from "./types/CreateActivityOutput"; import { CreateStateMachineInput } from "./types/CreateStateMachineInput"; import { CreateStateMachineOutput } from "./types/CreateStateMachineOutput"; import { DeleteActivityInput } from "./types/DeleteActivityInput"; import { DeleteActivityOutput } from "./types/DeleteActivityOutput"; import { DeleteStateMachineInput } from "./types/DeleteStateMachineInput"; import { DeleteStateMachineOutput } from "./types/DeleteStateMachineOutput"; import { DescribeActivityInput } from "./types/DescribeActivityInput"; import { DescribeActivityOutput } from "./types/DescribeActivityOutput"; import { DescribeExecutionInput } from "./types/DescribeExecutionInput"; import { DescribeExecutionOutput } from "./types/DescribeExecutionOutput"; import { DescribeStateMachineForExecutionInput } from "./types/DescribeStateMachineForExecutionInput"; import { DescribeStateMachineForExecutionOutput } from "./types/DescribeStateMachineForExecutionOutput"; import { DescribeStateMachineInput } from "./types/DescribeStateMachineInput"; import { DescribeStateMachineOutput } from "./types/DescribeStateMachineOutput"; import { GetActivityTaskInput } from "./types/GetActivityTaskInput"; import { GetActivityTaskOutput } from "./types/GetActivityTaskOutput"; import { GetExecutionHistoryInput } from "./types/GetExecutionHistoryInput"; import { GetExecutionHistoryOutput } from "./types/GetExecutionHistoryOutput"; import { ListActivitiesInput } from "./types/ListActivitiesInput"; import { ListActivitiesOutput } from "./types/ListActivitiesOutput"; import { ListExecutionsInput } from "./types/ListExecutionsInput"; import { ListExecutionsOutput } from "./types/ListExecutionsOutput"; import { ListStateMachinesInput } from "./types/ListStateMachinesInput"; import { ListStateMachinesOutput } from "./types/ListStateMachinesOutput"; import { ListTagsForResourceInput } from "./types/ListTagsForResourceInput"; import { ListTagsForResourceOutput } from "./types/ListTagsForResourceOutput"; import { SendTaskFailureInput } from "./types/SendTaskFailureInput"; import { SendTaskFailureOutput } from "./types/SendTaskFailureOutput"; import { SendTaskHeartbeatInput } from "./types/SendTaskHeartbeatInput"; import { SendTaskHeartbeatOutput } from "./types/SendTaskHeartbeatOutput"; import { SendTaskSuccessInput } from "./types/SendTaskSuccessInput"; import { SendTaskSuccessOutput } from "./types/SendTaskSuccessOutput"; import { StartExecutionInput } from "./types/StartExecutionInput"; import { StartExecutionOutput } from "./types/StartExecutionOutput"; import { StopExecutionInput } from "./types/StopExecutionInput"; import { StopExecutionOutput } from "./types/StopExecutionOutput"; import { TagResourceInput } from "./types/TagResourceInput"; import { TagResourceOutput } from "./types/TagResourceOutput"; import { UntagResourceInput } from "./types/UntagResourceInput"; import { UntagResourceOutput } from "./types/UntagResourceOutput"; import { UpdateStateMachineInput } from "./types/UpdateStateMachineInput"; import { UpdateStateMachineOutput } from "./types/UpdateStateMachineOutput"; export declare class SFN extends SFNClient { /** *
Creates an activity. An activity is a task that you write in any programming language and host on any machine that 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.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The maximum number of activities has been reached. Existing activities must be deleted before a new activity can be created.
* - {InvalidName}The provided name is invalid.
* - {TooManyTags}You've exceeded the number of tags allowed for a resource. See the Limits Topic in the AWS Step Functions Developer Guide.
* - {Error} An error originating from the SDK or customizations rather than the service */ createActivity(args: CreateActivityInput): PromiseCreates 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.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The provided Amazon Resource Name (ARN) is invalid.
* - {InvalidDefinition}The provided Amazon States Language definition is invalid.
* - {InvalidName}The provided name is invalid.
* - {StateMachineAlreadyExists}A state machine with the same name but a different definition or role ARN already exists.
* - {StateMachineDeleting}The specified state machine is being deleted.
* - {StateMachineLimitExceeded}The maximum number of state machines has been reached. Existing state machines must be deleted before a new state machine can be created.
* - {TooManyTags}You've exceeded the number of tags allowed for a resource. See the Limits Topic in the AWS Step Functions Developer Guide.
* - {Error} An error originating from the SDK or customizations rather than the service */ createStateMachine(args: CreateStateMachineInput): PromiseDeletes an activity.
* * This operation may fail with one of the following errors: * - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ deleteActivity(args: DeleteActivityInput): PromiseDeletes 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.
The provided Amazon Resource Name (ARN) is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ deleteStateMachine(args: DeleteStateMachineInput): PromiseDescribes an activity.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The specified activity does not exist.
* - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ describeActivity(args: DescribeActivityInput): PromiseDescribes an execution.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The specified execution does not exist.
* - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ describeExecution(args: DescribeExecutionInput): PromiseDescribes a state machine.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The provided Amazon Resource Name (ARN) is invalid.
* - {StateMachineDoesNotExist}The specified state machine does not exist.
* - {Error} An error originating from the SDK or customizations rather than the service */ describeStateMachine(args: DescribeStateMachineInput): PromiseDescribes the state machine associated with a specific execution.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The specified execution does not exist.
* - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ describeStateMachineForExecution(args: DescribeStateMachineForExecutionInput): PromiseUsed 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).
Polling with GetActivityTask can cause latency in some implementations. See Avoid Latency When Polling for Activity Tasks in the Step Functions Developer Guide.
The specified activity does not exist.
* - {ActivityWorkerLimitExceeded}The maximum number of workers concurrently polling for activity tasks has been reached.
* - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ getActivityTask(args: GetActivityTaskInput): PromiseReturns 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 nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.
The specified execution does not exist.
* - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {InvalidToken}The provided token is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ getExecutionHistory(args: GetExecutionHistoryInput): PromiseLists the existing activities.
If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The provided token is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ listActivities(args: ListActivitiesInput): PromiseLists the executions of a state machine that meet the filtering criteria. Results are sorted by time, with the most recent execution first.
If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The provided Amazon Resource Name (ARN) is invalid.
* - {InvalidToken}The provided token is invalid.
* - {StateMachineDoesNotExist}The specified state machine does not exist.
* - {Error} An error originating from the SDK or customizations rather than the service */ listExecutions(args: ListExecutionsInput): PromiseLists the existing state machines.
If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.
This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.
The provided token is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ listStateMachines(args: ListStateMachinesInput): PromiseList tags for a given resource.
* * This operation may fail with one of the following errors: * - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {ResourceNotFound}Could not fine the referenced resource. Only state machine and activity ARNs are supported.
* - {Error} An error originating from the SDK or customizations rather than the service */ listTagsForResource(args: ListTagsForResourceInput): PromiseUsed by workers to report that the task identified by the taskToken failed.
The provided token is invalid.
* - {TaskTimedOut} TaskTimedOut shape * - {Error} An error originating from the SDK or customizations rather than the service */ sendTaskFailure(args: SendTaskFailureInput): PromiseUsed 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.
The provided token is invalid.
* - {TaskTimedOut} TaskTimedOut shape * - {Error} An error originating from the SDK or customizations rather than the service */ sendTaskHeartbeat(args: SendTaskHeartbeatInput): PromiseUsed by workers to report that the task identified by the taskToken completed successfully.
The provided JSON output data is invalid.
* - {InvalidToken}The provided token is invalid.
* - {TaskTimedOut} TaskTimedOut shape * - {Error} An error originating from the SDK or customizations rather than the service */ sendTaskSuccess(args: SendTaskSuccessInput): PromiseStarts a state machine execution.
StartExecution is idempotent. If StartExecution is called with the same name and input as a running execution, the call will succeed and return the same response as the original request. If the execution is closed or if the input is different, it will return a 400 ExecutionAlreadyExists error. Names can be reused after 90 days.
The maximum number of running executions has been reached. Running executions must end or be stopped before a new execution can be started.
* - {ExecutionAlreadyExists}The execution has the same name as another execution (but a different input).
Executions with the same name and input are considered idempotent.
The provided Amazon Resource Name (ARN) is invalid.
* - {InvalidExecutionInput}The provided JSON input data is invalid.
* - {InvalidName}The provided name is invalid.
* - {StateMachineDoesNotExist}The specified state machine does not exist.
* - {StateMachineDeleting}The specified state machine is being deleted.
* - {Error} An error originating from the SDK or customizations rather than the service */ startExecution(args: StartExecutionInput): PromiseStops an execution.
* * This operation may fail with one of the following errors: * - {ExecutionDoesNotExist}The specified execution does not exist.
* - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {Error} An error originating from the SDK or customizations rather than the service */ stopExecution(args: StopExecutionInput): PromiseAdd a tag to a Step Functions resource.
* * This operation may fail with one of the following errors: * - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {ResourceNotFound}Could not fine the referenced resource. Only state machine and activity ARNs are supported.
* - {TooManyTags}You've exceeded the number of tags allowed for a resource. See the Limits Topic in the AWS Step Functions Developer Guide.
* - {Error} An error originating from the SDK or customizations rather than the service */ tagResource(args: TagResourceInput): PromiseRemove a tag from a Step Functions resource
* * This operation may fail with one of the following errors: * - {InvalidArn}The provided Amazon Resource Name (ARN) is invalid.
* - {ResourceNotFound}Could not fine the referenced resource. Only state machine and activity ARNs are supported.
* - {Error} An error originating from the SDK or customizations rather than the service */ untagResource(args: UntagResourceInput): PromiseUpdates an existing state machine by modifying its definition and/or roleArn. Running executions will continue to use the previous definition and roleArn. You must include at least one of definition or roleArn or you will receive a MissingRequiredParameter error.
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.
The provided Amazon Resource Name (ARN) is invalid.
* - {InvalidDefinition}The provided Amazon States Language definition is invalid.
* - {MissingRequiredParameter}Request is missing a required parameter. This error occurs if both definition and roleArn are not specified.
The specified state machine is being deleted.
* - {StateMachineDoesNotExist}The specified state machine does not exist.
* - {Error} An error originating from the SDK or customizations rather than the service */ updateStateMachine(args: UpdateStateMachineInput): Promise