Smaws_Client_SFN
SFN client library built on EIO.
val service : Smaws_Lib.Service.descriptor
type nonrec validation_exception = {
reason : validation_exception_reason option;
The input does not satisfy the constraints specified by an Amazon Web Services service.
*)message : string option;
}
The input does not satisfy the constraints specified by an Amazon Web Services service.
type nonrec validate_state_machine_definition_diagnostic = {
location : string option;
Location of the issue in the state machine, if available.
For errors specific to a field, the location could be in the format:
/States//
, for example: /States/FailState/ErrorPath
.
message : string;
Message describing the diagnostic condition.
*)code : string;
Identifying code for the diagnostic.
*)severity : validate_state_machine_definition_severity;
A value of ERROR
means that you cannot create or update a state machine with this definition.
}
Describes an error found during validation. Validation errors found in the definition return in the response as diagnostic elements, rather than raise an exception.
type nonrec validate_state_machine_definition_output = {
diagnostics : validate_state_machine_definition_diagnostic list;
If the result is OK
, this field will be empty. When there are errors, this field will contain an array of Diagnostic objects to help you troubleshoot.
result : validate_state_machine_definition_result_code;
The result value will be OK
when no syntax errors are found, or FAIL
if the workflow definition does not pass verification.
}
type nonrec validate_state_machine_definition_input = {
type_ : state_machine_type option;
The target type of state machine for this definition. The default is STANDARD
.
definition : string;
The Amazon States Language definition of the state machine. For more information, see Amazon States Language (ASL).
*)}
type nonrec update_state_machine_output = {
state_machine_version_arn : string option;
The Amazon Resource Name (ARN) of the published state machine version.
If the publish
parameter isn't set to true
, this field returns null.
revision_id : string option;
The revision identifier for the updated state machine.
*)update_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date and time the state machine was updated.
*)}
type nonrec log_destination = {
cloud_watch_logs_log_group : cloud_watch_logs_log_group option;
An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the CloudFormation User Guide.
*)}
type nonrec logging_configuration = {
destinations : log_destination list option;
An array of objects that describes where your execution history events will be logged. Limited to size 1. Required, if your log level is not set to OFF
.
include_execution_data : bool option;
Determines whether execution data is included in your log. When set to false
, data is excluded.
level : log_level option;
Defines which category of execution history events are logged.
*)}
The LoggingConfiguration
data type is used to set CloudWatch Logs options.
Selects whether or not the state machine's X-Ray tracing is enabled. Default is false
type nonrec update_state_machine_input = {
version_description : string option;
An optional description of the state machine version to publish.
You can only specify the versionDescription
parameter if you've set publish
to true
.
publish : bool option;
Specifies whether the state machine version is published. The default is false
. To publish a version after updating the state machine, set publish
to true
.
tracing_configuration : tracing_configuration option;
Selects whether X-Ray tracing is enabled.
*)logging_configuration : logging_configuration option;
Use the LoggingConfiguration
data type to set CloudWatch Logs options.
role_arn : string option;
The Amazon Resource Name (ARN) of the IAM role of the state machine.
*)definition : string option;
state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine.
*)}
type nonrec routing_configuration_list_item = {
weight : int;
The percentage of traffic you want to route to a state machine version. The sum of the weights in the routing configuration must be equal to 100.
*)state_machine_version_arn : string;
The Amazon Resource Name (ARN) that identifies one or two state machine versions defined in the routing configuration.
If you specify the ARN of a second version, it must belong to the same state machine as the first version.
*)}
Contains details about the routing configuration of a state machine alias. In a routing configuration, you define an array of objects that specify up to two state machine versions. You also specify the percentage of traffic to be routed to each version.
type nonrec update_state_machine_alias_input = {
routing_configuration : routing_configuration_list_item list option;
The routing configuration of the state machine alias.
An array of RoutingConfig
objects that specifies up to two state machine versions that the alias starts executions for.
description : string option;
A description of the state machine alias.
*)state_machine_alias_arn : string;
The Amazon Resource Name (ARN) of the state machine alias.
*)}
The specified state machine is being deleted.
Could not find the referenced resource.
The provided Amazon Resource Name (ARN) is not valid.
Updating or deleting a resource can cause an inconsistent state. This error occurs when there're concurrent requests for DeleteStateMachineVersion
, PublishStateMachineVersion
, or UpdateStateMachine
with the publish
parameter set to true
.
HTTP Status Code: 409
The specified state machine does not exist.
The request would cause a service quota to be exceeded.
HTTP Status Code: 402
Request is missing a required parameter. This error occurs if both definition
and roleArn
are not specified.
Your tracingConfiguration
key does not match, or enabled
has not been set to true
or false
.
The provided Amazon States Language definition is not valid.
type nonrec update_map_run_input = {
tolerated_failure_count : int option;
The maximum number of failed items before the Map Run fails.
*)tolerated_failure_percentage : float option;
The maximum percentage of failed items before the Map Run fails.
*)max_concurrency : int option;
The maximum number of child workflow executions that can be specified to run in parallel for the Map Run at the same time.
*)map_run_arn : string;
The Amazon Resource Name (ARN) of a Map Run.
*)}
You've exceeded the number of tags allowed for a resource. See the Limits Topic in the Step Functions Developer Guide.
type nonrec inspection_data_request = {
body : string option;
The request body for the HTTP request.
*)headers : string option;
The request headers associated with the HTTP request.
*)url : string option;
The API endpoint used for the HTTP request.
*)method_ : string option;
The HTTP method used for the HTTP request.
*)protocol : string option;
The protocol used to make the HTTP request.
*)}
Contains additional details about the state's execution, including its input and output data processing flow, and HTTP request information.
type nonrec inspection_data_response = {
body : string option;
The HTTP response returned.
*)headers : string option;
The response headers associated with the HTTP response.
*)status_message : string option;
The message associated with the HTTP status code.
*)status_code : string option;
The HTTP response status code for the HTTP response.
*)protocol : string option;
The protocol used to return the HTTP response.
*)}
Contains additional details about the state's execution, including its input and output data processing flow, and HTTP response information. The inspectionLevel
request parameter specifies which details are returned.
type nonrec inspection_data = {
response : inspection_data_response option;
The raw HTTP response that is returned when you test an HTTP Task.
*)request : inspection_data_request option;
The raw HTTP request that is sent when you test an HTTP Task.
*)after_result_path : string option;
The effective result combined with the raw state input after Step Functions applies the ResultPath filter.
*)after_result_selector : string option;
result : string option;
The state's raw result.
*)after_parameters : string option;
after_input_path : string option;
input : string option;
The raw state input.
*)}
Contains additional details about the state's execution, including its input and output data processing flow, and HTTP request and response information.
type nonrec test_state_output = {
status : test_execution_status option;
The execution status of the state.
*)next_state : string option;
The name of the next state to transition to. If you haven't defined a next state in your definition or if the execution of the state fails, this field doesn't contain a value.
*)inspection_data : inspection_data option;
Returns additional details about the state's execution, including its input and output data processing flow, and HTTP request and response information. The inspectionLevel
request parameter specifies which details are returned.
cause : string option;
A detailed explanation of the cause for the error when the execution of a state fails.
*)error : string option;
The error returned when the execution of a state fails.
*)output : string option;
The JSON output data of the state. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)}
type nonrec test_state_input = {
reveal_secrets : bool option;
Specifies whether or not to include secret information in the test result. For HTTP Tasks, a secret includes the data that an EventBridge connection adds to modify the HTTP request headers, query parameters, and body. Step Functions doesn't omit any information included in the state definition or the HTTP response.
If you set revealSecrets
to true
, you must make sure that the IAM user that calls the TestState
API has permission for the states:RevealSecrets
action. For an example of IAM policy that sets the states:RevealSecrets
permission, see IAM permissions to test a state. Without this permission, Step Functions throws an access denied error.
By default, revealSecrets
is set to false
.
inspection_level : inspection_level option;
Determines the values to return when a state is tested. You can specify one of the following types:
INFO
: Shows the final state output. By default, Step Functions sets inspectionLevel
to INFO
if you don't specify a level.DEBUG
: Shows the final state output along with the input and output data processing result.TRACE
: Shows the HTTP request and response for an HTTP Task. This level also shows the final state output along with the input and output data processing result.Each of these levels also provide information about the status of the state execution and the next state to transition to.
*)input : string option;
A string that contains the JSON input data for the state.
*)role_arn : string;
The Amazon Resource Name (ARN) of the execution role with the required IAM permissions for the state.
*)definition : string;
}
The provided JSON input data is not valid.
type nonrec task_timed_out_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about a resource timeout that occurred during an execution.
The task token has either expired or the task associated with the token has already been closed.
type nonrec history_event_execution_data_details = {
truncated : bool option;
Indicates whether input or output was truncated in the response. Always false
for API calls.
}
Provides details about input or output in an execution history event.
type nonrec task_succeeded_event_details = {
output_details : history_event_execution_data_details option;
Contains details about the output of an execution history event.
*)output : string option;
The full JSON response from a resource when a task has succeeded. This response becomes the output of the related task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about the successful completion of a task state.
type nonrec task_submitted_event_details = {
output_details : history_event_execution_data_details option;
Contains details about the output of an execution history event.
*)output : string option;
The response from a resource when a task has started. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about a task submitted to a resource .
type nonrec task_submit_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about a task that failed to submit during an execution.
type nonrec task_started_event_details = {
resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about the start of a task during an execution.
type nonrec task_start_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about a task that failed to start during an execution.
type nonrec task_credentials = {
role_arn : string option;
The ARN of an IAM role that Step Functions assumes for the task. The role can allow cross-account access to resources.
*)}
Contains details about the credentials that Step Functions uses for a task.
type nonrec task_scheduled_event_details = {
task_credentials : task_credentials option;
The credentials that Step Functions uses for the task.
*)heartbeat_in_seconds : int option;
The maximum allowed duration between two heartbeats for the task.
*)timeout_in_seconds : int option;
The maximum allowed duration of the task.
*)parameters : string;
The JSON data passed to the resource referenced in a task state. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)region : string;
The region of the scheduled task
*)resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about a task scheduled during an execution.
type nonrec task_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)resource : string;
The action of the resource called by a task state.
*)resource_type : string;
The service name of the resource in a task state.
*)}
Contains details about a task failure event.
Tags are key-value pairs that can be associated with Step Functions state machines and activities.
An array of key-value pairs. For more information, see Using Cost Allocation Tags in the Amazon Web Services Billing and Cost Management User Guide, and Controlling Access Using IAM Tags.
Tags may only contain Unicode letters, digits, white space, or these symbols: _ . : / = + - @
.
The specified execution does not exist.
type nonrec state_machine_version_list_item = {
creation_date : Smaws_Lib.CoreTypes.Timestamp.t;
The creation date of a state machine version.
*)state_machine_version_arn : string;
The Amazon Resource Name (ARN) that identifies a state machine version. The version ARN is a combination of state machine ARN and the version number separated by a colon (:). For example, stateMachineARN:1
.
}
Contains details about a specific state machine version.
type nonrec state_machine_list_item = {
creation_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the state machine is created.
*)type_ : state_machine_type;
name : string;
The name of the state machine.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) that identifies the state machine.
*)}
Contains details about the state machine.
The maximum number of state machines has been reached. Existing state machines must be deleted before a new state machine can be created.
A state machine with the same name but a different definition or role ARN already exists.
type nonrec state_machine_alias_list_item = {
creation_date : Smaws_Lib.CoreTypes.Timestamp.t;
The creation date of a state machine alias.
*)state_machine_alias_arn : string;
The Amazon Resource Name (ARN) that identifies a state machine alias. The alias ARN is a combination of state machine ARN and the alias name separated by a colon (:). For example, stateMachineARN:PROD
.
}
Contains details about a specific state machine alias.
type nonrec state_exited_event_details = {
output_details : history_event_execution_data_details option;
Contains details about the output of an execution history event.
*)output : string option;
The JSON output data of the state. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)name : string;
The name of the state.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)}
Contains details about an exit from a state during an execution.
type nonrec state_entered_event_details = {
input_details : history_event_execution_data_details option;
Contains details about the input for an execution history event.
*)input : string option;
The string that contains the JSON input data for the state. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)name : string;
The name of the state.
*)}
Contains details about a state entered during an execution.
type nonrec cloud_watch_events_execution_data_details = {
included : bool option;
Indicates whether input or output was included in the response. Always true
for API calls.
}
Provides details about execution input or output.
type nonrec billing_details = {
billed_duration_in_milliseconds : int option;
Billed duration of your workflow, in milliseconds.
*)billed_memory_used_in_m_b : int option;
Billed memory consumption of your workflow, in MB.
*)}
An object that describes workflow billing details.
type nonrec start_sync_execution_output = {
billing_details : billing_details option;
An object that describes workflow billing details, including billed duration and memory use.
*)trace_header : string option;
The X-Ray trace header that was passed to the execution.
*)output_details : cloud_watch_events_execution_data_details option;
output : string option;
The JSON output data of the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
This field is set only if the execution succeeds. If the execution fails, this field is null.
*)input_details : cloud_watch_events_execution_data_details option;
input : string option;
The string that contains the JSON input data of the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)status : sync_execution_status;
The current status of the execution.
*)stop_date : Smaws_Lib.CoreTypes.Timestamp.t;
If the execution has already ended, the date the execution stopped.
*)start_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the execution is started.
*)name : string option;
The name of the execution.
*)state_machine_arn : string option;
The Amazon Resource Name (ARN) that identifies the state machine.
*)execution_arn : string;
The Amazon Resource Name (ARN) that identifies the execution.
*)}
type nonrec start_sync_execution_input = {
trace_header : string option;
Passes the X-Ray trace header. The trace header can also be passed in the request payload.
*)input : string option;
The string that contains the JSON input data for the execution, for example:
"input": "{\"first_name\" : \"test\"}"
If you don't include any JSON input data, you still must include the two braces, for example: "input": "{}"
Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)name : string option;
The name of the execution.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine to execute.
*)}
type nonrec start_execution_input = {
trace_header : string option;
Passes the X-Ray trace header. The trace header can also be passed in the request payload.
*)input : string option;
The string that contains the JSON input data for the execution, for example:
"input": "{\"first_name\" : \"test\"}"
If you don't include any JSON input data, you still must include the two braces, for example: "input": "{}"
Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)name : string option;
Optional name of the execution. This name must be unique for your Amazon Web Services account, Region, and state machine for 90 days. For more information, see Limits Related to State Machine Executions in the Step Functions Developer Guide.
If you don't provide a name for the execution, Step Functions automatically generates a universally unique identifier (UUID) as the execution name.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine to execute.
The stateMachineArn
parameter accepts one of the following inputs:
An unqualified state machine ARN – Refers to a state machine ARN that isn't qualified with a version or alias ARN. The following is an example of an unqualified state machine ARN.
arn::states:::stateMachine:
Step Functions doesn't associate state machine executions that you start with an unqualified ARN with a version. This is true even if that version uses the same revision that the execution used.
A state machine version ARN – Refers to a version ARN, which is a combination of state machine ARN and the version number separated by a colon (:). The following is an example of the ARN for version 10.
arn::states:::stateMachine::10
Step Functions doesn't associate executions that you start with a version ARN with any aliases that point to that version.
A state machine alias ARN – Refers to an alias ARN, which is a combination of state machine ARN and the alias name separated by a colon (:). The following is an example of the ARN for an alias named PROD
.
arn::states:::stateMachine:
Step Functions associates executions that you start with an alias ARN with that alias and the state machine version used for that execution.
}
The maximum number of running executions has been reached. Running executions must end or be stopped before a new execution can be started.
The execution has the same name
as another execution (but a different input
).
Executions with the same name
and input
are considered idempotent.
type nonrec send_task_success_input = {
output : string;
The JSON output of the task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)task_token : string;
The token that represents this task. Task tokens are generated by Step Functions when tasks are assigned to a worker, or in the context object when a workflow enters a task state. See GetActivityTaskOutput$taskToken
.
}
type nonrec send_task_heartbeat_input = {
task_token : string;
The token that represents this task. Task tokens are generated by Step Functions when tasks are assigned to a worker, or in the context object when a workflow enters a task state. See GetActivityTaskOutput$taskToken
.
}
type nonrec send_task_failure_input = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)task_token : string;
The token that represents this task. Task tokens are generated by Step Functions when tasks are assigned to a worker, or in the context object when a workflow enters a task state. See GetActivityTaskOutput$taskToken
.
}
type nonrec redrive_execution_input = {
client_token : string option;
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don’t specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The API will return idempotent responses for the last 10 client tokens used to successfully redrive the execution. These client tokens are valid for up to 15 minutes after they are first used.
*)execution_arn : string;
The Amazon Resource Name (ARN) of the execution to be redriven.
*)}
The execution Amazon Resource Name (ARN) that you specified for executionArn
cannot be redriven.
type nonrec publish_state_machine_version_input = {
description : string option;
An optional description of the state machine version.
*)revision_id : string option;
Only publish the state machine version if the current state machine's revision ID matches the specified ID.
Use this option to avoid publishing a version if the state machine changed since you last updated it. If the specified revision ID doesn't match the state machine's current revision ID, the API returns ConflictException
.
To specify an initial revision ID for a state machine with no revision ID assigned, specify the string INITIAL
for the revisionId
parameter. For example, you can specify a revisionID
of INITIAL
when you create a state machine using the CreateStateMachine
API action.
state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine.
*)}
Contains details about a Map Run that was started during a state machine execution.
type nonrec map_run_redriven_event_details = {
redrive_count : int option;
The number of times the Map Run has been redriven at this point in the execution's history including this event. The redrive count for a redriven Map Run is always greater than 0.
*)map_run_arn : string option;
The Amazon Resource Name (ARN) of a Map Run that was redriven.
*)}
Contains details about a Map Run that was redriven.
type nonrec map_run_list_item = {
stop_date : Smaws_Lib.CoreTypes.Timestamp.t option;
The date on which the Map Run stopped.
*)start_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date on which the Map Run started.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) of the executed state machine.
*)map_run_arn : string;
The Amazon Resource Name (ARN) of the Map Run.
*)execution_arn : string;
The executionArn
of the execution from which the Map Run was started.
}
Contains details about a specific Map Run.
type nonrec map_run_item_counts = {
pending_redrive : int option;
The number of unsuccessful items in child workflow executions currently waiting to be redriven.
*)failures_not_redrivable : int option;
The number of FAILED
, ABORTED
, or TIMED_OUT
items in child workflow executions that cannot be redriven because the execution status of those child workflows is terminal. For example, child workflows with an execution status of FAILED
, ABORTED
, or TIMED_OUT
and a redriveStatus
of NOT_REDRIVABLE
.
results_written : int;
Returns the count of items whose results were written by ResultWriter
. For more information, see ResultWriter in the Step Functions Developer Guide.
total : int;
The total number of items processed in all the child workflow executions started by a Map Run.
*)aborted : int;
The total number of items processed in child workflow executions that were either stopped by the user or by Step Functions, because the Map Run failed.
*)timed_out : int;
The total number of items processed in child workflow executions that have timed out.
*)failed : int;
The total number of items processed in child workflow executions that have failed.
*)succeeded : int;
The total number of items processed in child workflow executions that have completed successfully.
*)running : int;
The total number of items being processed in child workflow executions that are currently in-progress.
*)pending : int;
The total number of items to process in child workflow executions that haven't started running yet.
*)}
Contains details about items that were processed in all of the child workflow executions that were started by a Map Run.
type nonrec map_run_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the Map Run failure.
*)}
Contains details about a Map Run failure event that occurred during a state machine execution.
type nonrec map_run_execution_counts = {
pending_redrive : int option;
The number of unsuccessful child workflow executions currently waiting to be redriven. The status of these child workflow executions could be FAILED
, ABORTED
, or TIMED_OUT
in the original execution attempt or a previous redrive attempt.
failures_not_redrivable : int option;
The number of FAILED
, ABORTED
, or TIMED_OUT
child workflow executions that cannot be redriven because their execution status is terminal. For example, child workflows with an execution status of FAILED
, ABORTED
, or TIMED_OUT
and a redriveStatus
of NOT_REDRIVABLE
.
results_written : int;
Returns the count of child workflow executions whose results were written by ResultWriter
. For more information, see ResultWriter in the Step Functions Developer Guide.
total : int;
The total number of child workflow executions that were started by a Map Run.
*)aborted : int;
The total number of child workflow executions that were started by a Map Run and were running, but were either stopped by the user or by Step Functions because the Map Run failed.
*)timed_out : int;
The total number of child workflow executions that were started by a Map Run and have timed out.
*)failed : int;
The total number of child workflow executions that were started by a Map Run, but have failed.
*)succeeded : int;
The total number of child workflow executions that were started by a Map Run and have completed successfully.
*)running : int;
The total number of child workflow executions that were started by a Map Run and are currently in-progress.
*)pending : int;
The total number of child workflow executions that were started by a Map Run, but haven't started executing yet.
*)}
Contains details about all of the child workflow executions started by a Map Run.
type nonrec map_iteration_event_details = {
index : int option;
The index of the array belonging to the Map state iteration.
*)name : string option;
The name of the iteration’s parent Map state.
*)}
Contains details about an iteration of a Map state.
type nonrec list_state_machines_output = {
next_token : string option;
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.
state_machines : state_machine_list_item list;
}
type nonrec list_state_machines_input = {
next_token : string option;
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.
max_results : int option;
The maximum number of results that are returned per call. You can use nextToken
to obtain further pages of results. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.
This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.
*)}
type nonrec list_state_machine_versions_output = {
next_token : string option;
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.
state_machine_versions : state_machine_version_list_item list;
Versions for the state machine.
*)}
type nonrec list_state_machine_versions_input = {
max_results : int option;
The maximum number of results that are returned per call. You can use nextToken
to obtain further pages of results. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.
This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.
*)next_token : string option;
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.
state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine.
*)}
type nonrec list_state_machine_aliases_output = {
next_token : string option;
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.
state_machine_aliases : state_machine_alias_list_item list;
Aliases for the state machine.
*)}
type nonrec list_state_machine_aliases_input = {
max_results : int option;
The maximum number of results that are returned per call. You can use nextToken
to obtain further pages of results. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.
This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.
*)next_token : string option;
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.
state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine for which you want to list aliases.
If you specify a state machine version ARN, this API returns a list of aliases for that version.
*)}
type nonrec list_map_runs_output = {
next_token : string option;
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.
map_runs : map_run_list_item list;
An array that lists information related to a Map Run, such as the Amazon Resource Name (ARN) of the Map Run and the ARN of the state machine that started the Map Run.
*)}
type nonrec list_map_runs_input = {
next_token : string option;
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.
max_results : int option;
The maximum number of results that are returned per call. You can use nextToken
to obtain further pages of results. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.
This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.
*)execution_arn : string;
The Amazon Resource Name (ARN) of the execution for which the Map Runs must be listed.
*)}
type nonrec execution_list_item = {
redrive_date : Smaws_Lib.CoreTypes.Timestamp.t option;
The date the execution was last redriven.
*)redrive_count : int option;
The number of times you've redriven an execution. If you have not yet redriven an execution, the redriveCount
is 0. This count is only updated when you successfully redrive an execution.
state_machine_alias_arn : string option;
The Amazon Resource Name (ARN) of the state machine alias used to start an execution.
If the state machine execution was started with an unqualified ARN or a version ARN, it returns null.
*)state_machine_version_arn : string option;
The Amazon Resource Name (ARN) of the state machine version associated with the execution.
If the state machine execution was started with an unqualified ARN, it returns null.
If the execution was started using a stateMachineAliasArn
, both the stateMachineAliasArn
and stateMachineVersionArn
parameters contain the respective values.
item_count : int option;
The total number of items processed in a child workflow execution. This field is returned only if mapRunArn
was specified in the ListExecutions
API action. If stateMachineArn
was specified in ListExecutions
, the itemCount
field isn't returned.
map_run_arn : string option;
The Amazon Resource Name (ARN) of a Map Run. This field is returned only if mapRunArn
was specified in the ListExecutions
API action. If stateMachineArn
was specified in ListExecutions
, the mapRunArn
isn't returned.
stop_date : Smaws_Lib.CoreTypes.Timestamp.t option;
If the execution already ended, the date the execution stopped.
*)start_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the execution started.
*)status : execution_status;
The current status of the execution.
*)name : string;
The name of the execution.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine that ran the execution.
*)execution_arn : string;
The Amazon Resource Name (ARN) that identifies the execution.
*)}
Contains details about an execution.
type nonrec list_executions_output = {
next_token : string option;
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.
executions : execution_list_item list;
The list of matching executions.
*)}
type nonrec list_executions_input = {
redrive_filter : execution_redrive_filter option;
Sets a filter to list executions based on whether or not they have been redriven.
For a Distributed Map, redriveFilter
sets a filter to list child workflow executions based on whether or not they have been redriven.
If you do not provide a redriveFilter
, Step Functions returns a list of both redriven and non-redriven executions.
If you provide a state machine ARN in redriveFilter
, the API returns a validation exception.
map_run_arn : string option;
The Amazon Resource Name (ARN) of the Map Run that started the child workflow executions. If the mapRunArn
field is specified, a list of all of the child workflow executions started by a Map Run is returned. For more information, see Examining Map Run in the Step Functions Developer Guide.
You can specify either a mapRunArn
or a stateMachineArn
, but not both.
next_token : string option;
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.
max_results : int option;
The maximum number of results that are returned per call. You can use nextToken
to obtain further pages of results. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.
This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.
*)status_filter : execution_status option;
If specified, only list the executions whose current execution status matches the given filter.
*)state_machine_arn : string option;
The Amazon Resource Name (ARN) of the state machine whose executions is listed.
You can specify either a mapRunArn
or a stateMachineArn
, but not both.
You can also return a list of executions associated with a specific alias or version, by specifying an alias ARN or a version ARN in the stateMachineArn
parameter.
}
type nonrec activity_list_item = {
creation_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the activity is created.
*)name : string;
The name of the activity.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)activity_arn : string;
The Amazon Resource Name (ARN) that identifies the activity.
*)}
Contains details about an activity.
type nonrec list_activities_output = {
next_token : string option;
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.
activities : activity_list_item list;
The list of activities.
*)}
type nonrec list_activities_input = {
next_token : string option;
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.
max_results : int option;
The maximum number of results that are returned per call. You can use nextToken
to obtain further pages of results. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.
This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.
*)}
type nonrec lambda_function_timed_out_event_details = {
cause : string option;
A more detailed explanation of the cause of the timeout.
*)error : string option;
The error code of the failure.
*)}
Contains details about a Lambda function timeout that occurred during an execution.
type nonrec lambda_function_succeeded_event_details = {
output_details : history_event_execution_data_details option;
Contains details about the output of an execution history event.
*)output : string option;
The JSON data output by the Lambda function. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)}
Contains details about a Lambda function that successfully terminated during an execution.
type nonrec lambda_function_start_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)}
Contains details about a lambda function that failed to start during an execution.
type nonrec lambda_function_scheduled_event_details = {
task_credentials : task_credentials option;
The credentials that Step Functions uses for the task.
*)timeout_in_seconds : int option;
The maximum allowed duration of the Lambda function.
*)input_details : history_event_execution_data_details option;
Contains details about input for an execution history event.
*)input : string option;
The JSON data input to the Lambda function. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)resource : string;
The Amazon Resource Name (ARN) of the scheduled Lambda function.
*)}
Contains details about a Lambda function scheduled during an execution.
type nonrec lambda_function_schedule_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)}
Contains details about a failed Lambda function schedule event that occurred during an execution.
type nonrec lambda_function_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)}
Contains details about a Lambda function that failed during an execution.
type nonrec history_event_type =
| MapRunRedriven
| ExecutionRedriven
| MapRunSucceeded
| MapRunStarted
| MapRunFailed
| MapRunAborted
| WaitStateExited
| WaitStateEntered
| WaitStateAborted
| TaskTimedOut
| TaskSucceeded
| TaskSubmitted
| TaskSubmitFailed
| TaskStateExited
| TaskStateEntered
| TaskStateAborted
| TaskStartFailed
| TaskStarted
| TaskScheduled
| TaskFailed
| SucceedStateExited
| SucceedStateEntered
| PassStateExited
| PassStateEntered
| ParallelStateSucceeded
| ParallelStateStarted
| ParallelStateFailed
| ParallelStateExited
| ParallelStateEntered
| ParallelStateAborted
| MapStateSucceeded
| MapStateStarted
| MapStateFailed
| MapStateExited
| MapStateEntered
| MapStateAborted
| MapIterationSucceeded
| MapIterationStarted
| MapIterationFailed
| MapIterationAborted
| LambdaFunctionTimedOut
| LambdaFunctionSucceeded
| LambdaFunctionStartFailed
| LambdaFunctionStarted
| LambdaFunctionScheduleFailed
| LambdaFunctionScheduled
| LambdaFunctionFailed
| FailStateEntered
| ExecutionTimedOut
| ExecutionSucceeded
| ExecutionStarted
| ExecutionFailed
| ExecutionAborted
| ChoiceStateExited
| ChoiceStateEntered
| ActivityTimedOut
| ActivitySucceeded
| ActivityStarted
| ActivityScheduleFailed
| ActivityScheduled
| ActivityFailed
type nonrec activity_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)}
Contains details about an activity that failed during an execution.
type nonrec activity_schedule_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)}
Contains details about an activity schedule failure that occurred during an execution.
type nonrec activity_scheduled_event_details = {
heartbeat_in_seconds : int option;
The maximum allowed duration between two heartbeats for the activity task.
*)timeout_in_seconds : int option;
The maximum allowed duration of the activity task.
*)input_details : history_event_execution_data_details option;
Contains details about the input for an execution history event.
*)input : string option;
The JSON data input to the activity task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)resource : string;
The Amazon Resource Name (ARN) of the scheduled activity.
*)}
Contains details about an activity scheduled during an execution.
type nonrec activity_started_event_details = {
worker_name : string option;
The name of the worker that the task is assigned to. These names are provided by the workers when calling GetActivityTask
.
}
Contains details about the start of an activity during an execution.
type nonrec activity_succeeded_event_details = {
output_details : history_event_execution_data_details option;
Contains details about the output of an execution history event.
*)output : string option;
The JSON data output by the activity task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)}
Contains details about an activity that successfully terminated during an execution.
type nonrec activity_timed_out_event_details = {
cause : string option;
A more detailed explanation of the cause of the timeout.
*)error : string option;
The error code of the failure.
*)}
Contains details about an activity timeout that occurred during an execution.
type nonrec execution_failed_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)}
Contains details about an execution failure event.
type nonrec execution_started_event_details = {
state_machine_version_arn : string option;
The Amazon Resource Name (ARN) that identifies a state machine version used for starting the state machine execution.
*)state_machine_alias_arn : string option;
The Amazon Resource Name (ARN) that identifies a state machine alias used for starting the state machine execution.
*)role_arn : string option;
The Amazon Resource Name (ARN) of the IAM role used for executing Lambda tasks.
*)input_details : history_event_execution_data_details option;
Contains details about the input for an execution history event.
*)input : string option;
The JSON data input to the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)}
Contains details about the start of the execution.
type nonrec execution_succeeded_event_details = {
output_details : history_event_execution_data_details option;
Contains details about the output of an execution history event.
*)output : string option;
The JSON data output by the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)}
Contains details about the successful termination of the execution.
type nonrec execution_aborted_event_details = {
cause : string option;
A more detailed explanation of the cause of the failure.
*)error : string option;
The error code of the failure.
*)}
Contains details about an abort of an execution.
type nonrec execution_timed_out_event_details = {
cause : string option;
A more detailed explanation of the cause of the timeout.
*)error : string option;
The error code of the failure.
*)}
Contains details about the execution timeout that occurred during the execution.
type nonrec execution_redriven_event_details = {
redrive_count : int option;
The number of times you've redriven an execution. If you have not yet redriven an execution, the redriveCount
is 0. This count is not updated for redrives that failed to start or are pending to be redriven.
}
Contains details about a redriven execution.
type nonrec history_event = {
map_run_redriven_event_details : map_run_redriven_event_details option;
Contains details about the redrive attempt of a Map Run.
*)map_run_failed_event_details : map_run_failed_event_details option;
Contains error and cause details about a Map Run that failed.
*)map_run_started_event_details : map_run_started_event_details option;
Contains details, such as mapRunArn
, and the start date and time of a Map Run. mapRunArn
is the Amazon Resource Name (ARN) of the Map Run that was started.
state_exited_event_details : state_exited_event_details option;
state_entered_event_details : state_entered_event_details option;
lambda_function_timed_out_event_details : lambda_function_timed_out_event_details
option;
lambda_function_succeeded_event_details : lambda_function_succeeded_event_details
option;
Contains details about a Lambda function that terminated successfully during an execution.
*)lambda_function_start_failed_event_details : lambda_function_start_failed_event_details
option;
Contains details about a lambda function that failed to start during an execution.
*)lambda_function_scheduled_event_details : lambda_function_scheduled_event_details
option;
lambda_function_schedule_failed_event_details : lambda_function_schedule_failed_event_details
option;
lambda_function_failed_event_details : lambda_function_failed_event_details
option;
map_iteration_aborted_event_details : map_iteration_event_details option;
Contains details about an iteration of a Map state that was aborted.
*)map_iteration_failed_event_details : map_iteration_event_details option;
Contains details about an iteration of a Map state that failed.
*)map_iteration_succeeded_event_details : map_iteration_event_details option;
Contains details about an iteration of a Map state that succeeded.
*)map_iteration_started_event_details : map_iteration_event_details option;
Contains details about an iteration of a Map state that was started.
*)map_state_started_event_details : map_state_started_event_details option;
Contains details about Map state that was started.
*)execution_redriven_event_details : execution_redriven_event_details option;
Contains details about the redrive attempt of an execution.
*)execution_timed_out_event_details : execution_timed_out_event_details option;
execution_aborted_event_details : execution_aborted_event_details option;
execution_succeeded_event_details : execution_succeeded_event_details option;
execution_started_event_details : execution_started_event_details option;
execution_failed_event_details : execution_failed_event_details option;
task_timed_out_event_details : task_timed_out_event_details option;
Contains details about a task that timed out.
*)task_succeeded_event_details : task_succeeded_event_details option;
Contains details about a task that succeeded.
*)task_submitted_event_details : task_submitted_event_details option;
Contains details about a submitted task.
*)task_submit_failed_event_details : task_submit_failed_event_details option;
Contains details about a task that where the submit failed.
*)task_started_event_details : task_started_event_details option;
Contains details about a task that was started.
*)task_start_failed_event_details : task_start_failed_event_details option;
Contains details about a task that failed to start.
*)task_scheduled_event_details : task_scheduled_event_details option;
Contains details about a task that was scheduled.
*)task_failed_event_details : task_failed_event_details option;
Contains details about the failure of a task.
*)activity_timed_out_event_details : activity_timed_out_event_details option;
activity_succeeded_event_details : activity_succeeded_event_details option;
activity_started_event_details : activity_started_event_details option;
activity_scheduled_event_details : activity_scheduled_event_details option;
activity_schedule_failed_event_details : activity_schedule_failed_event_details
option;
Contains details about an activity schedule event that failed during an execution.
*)activity_failed_event_details : activity_failed_event_details option;
previous_event_id : int option;
The id of the previous event.
*)id : int;
The id of the event. Events are numbered sequentially, starting at one.
*)type_ : history_event_type;
The type of the event.
*)timestamp_ : Smaws_Lib.CoreTypes.Timestamp.t;
The date and time the event occurred.
*)}
Contains details about the events of an execution.
type nonrec get_execution_history_output = {
next_token : string option;
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.
events : history_event list;
The list of events that occurred in the execution.
*)}
type nonrec get_execution_history_input = {
include_execution_data : bool option;
You can select whether execution data (input or output of a history event) is returned. The default is true
.
next_token : string option;
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.
reverse_order : bool option;
Lists events in descending order of their timeStamp
.
max_results : int option;
The maximum number of results that are returned per call. You can use nextToken
to obtain further pages of results. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.
This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.
*)execution_arn : string;
The Amazon Resource Name (ARN) of the execution.
*)}
type nonrec get_activity_task_output = {
input : string option;
The string that contains the JSON input data for the task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)task_token : string option;
A token that identifies the scheduled task. This token must be copied and included in subsequent calls to SendTaskHeartbeat
, SendTaskSuccess
or SendTaskFailure
in order to report the progress or completion of the task.
}
type nonrec get_activity_task_input = {
worker_name : string option;
You can provide an arbitrary name in order to identify the worker that the task is assigned to. This name is used when it is logged in the execution history.
*)activity_arn : string;
The Amazon Resource Name (ARN) of the activity to retrieve tasks from (assigned when you create the task using CreateActivity
.)
}
The maximum number of workers concurrently polling for activity tasks has been reached.
The specified activity does not exist.
type nonrec describe_state_machine_output = {
description : string option;
The description of the state machine version.
*)revision_id : string option;
The revision identifier for the state machine.
Use the revisionId
parameter to compare between versions of a state machine configuration used for executions without performing a diff of the properties, such as definition
and roleArn
.
label : string option;
A user-defined or an auto-generated string that identifies a Map
state. This parameter is present only if the stateMachineArn
specified in input is a qualified state machine ARN.
tracing_configuration : tracing_configuration option;
Selects whether X-Ray tracing is enabled.
*)logging_configuration : logging_configuration option;
creation_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the state machine is created.
For a state machine version, creationDate
is the date the version was created.
type_ : state_machine_type;
The type
of the state machine (STANDARD
or EXPRESS
).
role_arn : string;
The Amazon Resource Name (ARN) of the IAM role used when creating this state machine. (The IAM role maintains security by granting Step Functions access to Amazon Web Services resources.)
*)definition : string;
status : state_machine_status option;
The current status of the state machine.
*)name : string;
The name of the state machine.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) that identifies the state machine.
If you specified a state machine version ARN in your request, the API returns the version ARN. The version ARN is a combination of state machine ARN and the version number separated by a colon (:). For example, stateMachineARN:1
.
}
type nonrec describe_state_machine_input = {
state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine for which you want the information.
If you specify a state machine version ARN, this API returns details about that version. The version ARN is a combination of state machine ARN and the version number separated by a colon (:). For example, stateMachineARN:1
.
}
type nonrec describe_state_machine_for_execution_output = {
revision_id : string option;
The revision identifier for the state machine. The first revision ID when you create the state machine is null.
Use the state machine revisionId
parameter to compare the revision of a state machine with the configuration of the state machine used for executions without performing a diff of the properties, such as definition
and roleArn
.
label : string option;
A user-defined or an auto-generated string that identifies a Map
state. This field is returned only if the executionArn
is a child workflow execution that was started by a Distributed Map state.
map_run_arn : string option;
The Amazon Resource Name (ARN) of the Map Run that started the child workflow execution. This field is returned only if the executionArn
is a child workflow execution that was started by a Distributed Map state.
tracing_configuration : tracing_configuration option;
Selects whether X-Ray tracing is enabled.
*)logging_configuration : logging_configuration option;
update_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date and time the state machine associated with an execution was updated. For a newly created state machine, this is the creation date.
*)role_arn : string;
The Amazon Resource Name (ARN) of the IAM role of the State Machine for the execution.
*)definition : string;
name : string;
The name of the state machine associated with the execution.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) of the state machine associated with the execution.
*)}
type nonrec describe_state_machine_alias_output = {
update_date : Smaws_Lib.CoreTypes.Timestamp.t option;
The date the state machine alias was last updated.
For a newly created state machine, this is the same as the creation date.
*)creation_date : Smaws_Lib.CoreTypes.Timestamp.t option;
The date the state machine alias was created.
*)routing_configuration : routing_configuration_list_item list option;
The routing configuration of the alias.
*)description : string option;
A description of the alias.
*)name : string option;
The name of the state machine alias.
*)state_machine_alias_arn : string option;
The Amazon Resource Name (ARN) of the state machine alias.
*)}
type nonrec describe_map_run_output = {
redrive_date : Smaws_Lib.CoreTypes.Timestamp.t option;
The date a Map Run was last redriven. If you have not yet redriven a Map Run, the redriveDate
is null.
redrive_count : int option;
The number of times you've redriven a Map Run. If you have not yet redriven a Map Run, the redriveCount
is 0. This count is only updated if you successfully redrive a Map Run.
execution_counts : map_run_execution_counts;
A JSON object that contains information about the total number of child workflow executions for the Map Run, and the count of child workflow executions for each status, such as failed
and succeeded
.
item_counts : map_run_item_counts;
A JSON object that contains information about the total number of items, and the item count for each processing status, such as pending
and failed
.
tolerated_failure_count : int;
The maximum number of failed child workflow executions before the Map Run fails.
*)tolerated_failure_percentage : float;
The maximum percentage of failed child workflow executions before the Map Run fails.
*)max_concurrency : int;
The maximum number of child workflow executions configured to run in parallel for the Map Run at the same time.
*)stop_date : Smaws_Lib.CoreTypes.Timestamp.t option;
The date when the Map Run was stopped.
*)start_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date when the Map Run was started.
*)status : map_run_status;
The current status of the Map Run.
*)execution_arn : string;
The Amazon Resource Name (ARN) that identifies the execution in which the Map Run was started.
*)map_run_arn : string;
The Amazon Resource Name (ARN) that identifies a Map Run.
*)}
type nonrec describe_execution_output = {
redrive_status_reason : string option;
When redriveStatus
is NOT_REDRIVABLE
, redriveStatusReason
specifies the reason why an execution cannot be redriven.
For executions of type STANDARD
, or for a Distributed Map that includes child workflows of type STANDARD
, redriveStatusReason
can include one of the following reasons:
State machine is in DELETING status
.Execution is RUNNING and cannot be redriven
.Execution is SUCCEEDED and cannot be redriven
.Execution was started before the launch of RedriveExecution
.Execution history event limit exceeded
.Execution has exceeded the max execution time
.Execution redrivable period exceeded
.EXPRESS
, redriveStatusReason
is only returned if the child workflows are not redrivable. This happens when the child workflow executions have completed successfully.redrive_status : execution_redrive_status option;
Indicates whether or not an execution can be redriven at a given point in time.
STANDARD
, redriveStatus
is NOT_REDRIVABLE
if calling the RedriveExecution
API action would return the ExecutionNotRedrivable
error.STANDARD
, redriveStatus
indicates whether or not the Map Run can redrive child workflow executions.For a Distributed Map that includes child workflows of type EXPRESS
, redriveStatus
indicates whether or not the Map Run can redrive child workflow executions.
You can redrive failed or timed out EXPRESS
workflows only if they're a part of a Map Run. When you redrive the Map Run, these workflows are restarted using the StartExecution
API action.
redrive_date : Smaws_Lib.CoreTypes.Timestamp.t option;
The date the execution was last redriven. If you have not yet redriven an execution, the redriveDate
is null.
The redriveDate
is unavailable if you redrive a Map Run that starts child workflow executions of type EXPRESS
.
redrive_count : int option;
The number of times you've redriven an execution. If you have not yet redriven an execution, the redriveCount
is 0. This count is only updated if you successfully redrive an execution.
state_machine_alias_arn : string option;
The Amazon Resource Name (ARN) of the state machine alias associated with the execution. The alias ARN is a combination of state machine ARN and the alias name separated by a colon (:). For example, stateMachineARN:PROD
.
If you start an execution from a StartExecution
request with a state machine version ARN, this field will be null.
state_machine_version_arn : string option;
The Amazon Resource Name (ARN) of the state machine version associated with the execution. The version ARN is a combination of state machine ARN and the version number separated by a colon (:). For example, stateMachineARN:1
.
If you start an execution from a StartExecution
request without specifying a state machine version or alias ARN, Step Functions returns a null value.
cause : string option;
The cause string if the state machine execution failed.
*)error : string option;
The error string if the state machine execution failed.
*)map_run_arn : string option;
The Amazon Resource Name (ARN) that identifies a Map Run, which dispatched this execution.
*)trace_header : string option;
The X-Ray trace header that was passed to the execution.
*)output_details : cloud_watch_events_execution_data_details option;
output : string option;
The JSON output data of the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
This field is set only if the execution succeeds. If the execution fails, this field is null.
*)input_details : cloud_watch_events_execution_data_details option;
input : string option;
The string that contains the JSON input data of the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
*)stop_date : Smaws_Lib.CoreTypes.Timestamp.t option;
If the execution ended, the date the execution stopped.
*)start_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the execution is started.
*)status : execution_status;
The current status of the execution.
*)name : string option;
The name of the execution.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) of the executed stated machine.
*)execution_arn : string;
The Amazon Resource Name (ARN) that identifies the execution.
*)}
type nonrec describe_activity_output = {
creation_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the activity is created.
*)name : string;
The name of the activity.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)activity_arn : string;
The Amazon Resource Name (ARN) that identifies the activity.
*)}
type nonrec create_state_machine_output = {
state_machine_version_arn : string option;
The Amazon Resource Name (ARN) that identifies the created state machine version. If you do not set the publish
parameter to true
, this field returns null value.
creation_date : Smaws_Lib.CoreTypes.Timestamp.t;
The date the state machine is created.
*)state_machine_arn : string;
The Amazon Resource Name (ARN) that identifies the created state machine.
*)}
type nonrec create_state_machine_input = {
version_description : string option;
Sets description about the state machine version. You can only set the description if the publish
parameter is set to true
. Otherwise, if you set versionDescription
, but publish
to false
, this API action throws ValidationException
.
publish : bool option;
Set to true
to publish the first version of the state machine during creation. The default is false
.
tracing_configuration : tracing_configuration option;
Selects whether X-Ray tracing is enabled.
*)logging_configuration : logging_configuration option;
Defines what execution history events are logged and where they are logged.
By default, the level
is set to OFF
. For more information see Log Levels in the Step Functions User Guide.
type_ : state_machine_type option;
Determines whether a Standard or Express state machine is created. The default is STANDARD
. You cannot update the type
of a state machine once it has been created.
role_arn : string;
The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
*)definition : string;
name : string;
The name of the state machine.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)}
type nonrec create_state_machine_alias_input = {
routing_configuration : routing_configuration_list_item list;
The routing configuration of a state machine alias. The routing configuration shifts execution traffic between two state machine versions. routingConfiguration
contains an array of RoutingConfig
objects that specify up to two state machine versions. Step Functions then randomly choses which version to run an execution with based on the weight assigned to each RoutingConfig
.
name : string;
The name of the state machine alias.
To avoid conflict with version ARNs, don't use an integer in the name of the alias.
*)description : string option;
A description for the state machine alias.
*)}
type nonrec create_activity_input = {
name : string;
The name of the activity to create. This name must be unique for your Amazon Web Services account and region for 90 days. For more information, see Limits Related to State Machine Executions in the Step Functions Developer Guide.
A name must not contain:
< > { } [ ]
? *
" # % \ ^ | ~ ` $ & , ; : /
U+0000-001F
, U+007F-009F
)To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
*)}
The maximum number of activities has been reached. Existing activities must be deleted before a new activity can be created.
Builders
val make_validate_state_machine_definition_diagnostic :
?location:string ->
message:string ->
code:string ->
severity:validate_state_machine_definition_severity ->
unit ->
validate_state_machine_definition_diagnostic
val make_validate_state_machine_definition_output :
diagnostics:validate_state_machine_definition_diagnostic list ->
result:validate_state_machine_definition_result_code ->
unit ->
validate_state_machine_definition_output
val make_validate_state_machine_definition_input :
?type_:state_machine_type ->
definition:string ->
unit ->
validate_state_machine_definition_input
val make_update_state_machine_output :
?state_machine_version_arn:string ->
?revision_id:string ->
update_date:Smaws_Lib.CoreTypes.Timestamp.t ->
unit ->
update_state_machine_output
val make_cloud_watch_logs_log_group :
?log_group_arn:string ->
unit ->
cloud_watch_logs_log_group
val make_log_destination :
?cloud_watch_logs_log_group:cloud_watch_logs_log_group ->
unit ->
log_destination
val make_logging_configuration :
?destinations:log_destination list ->
?include_execution_data:bool ->
?level:log_level ->
unit ->
logging_configuration
val make_tracing_configuration : ?enabled:bool -> unit -> tracing_configuration
val make_update_state_machine_input :
?version_description:string ->
?publish:bool ->
?tracing_configuration:tracing_configuration ->
?logging_configuration:logging_configuration ->
?role_arn:string ->
?definition:string ->
state_machine_arn:string ->
unit ->
update_state_machine_input
val make_update_state_machine_alias_output :
update_date:Smaws_Lib.CoreTypes.Timestamp.t ->
unit ->
update_state_machine_alias_output
val make_routing_configuration_list_item :
weight:int ->
state_machine_version_arn:string ->
unit ->
routing_configuration_list_item
val make_update_state_machine_alias_input :
?routing_configuration:routing_configuration_list_item list ->
?description:string ->
state_machine_alias_arn:string ->
unit ->
update_state_machine_alias_input
val make_update_map_run_input :
?tolerated_failure_count:int ->
?tolerated_failure_percentage:float ->
?max_concurrency:int ->
map_run_arn:string ->
unit ->
update_map_run_input
val make_untag_resource_input :
tag_keys:string list ->
resource_arn:string ->
unit ->
untag_resource_input
val make_inspection_data_request :
?body:string ->
?headers:string ->
?url:string ->
?method_:string ->
?protocol:string ->
unit ->
inspection_data_request
val make_inspection_data_response :
?body:string ->
?headers:string ->
?status_message:string ->
?status_code:string ->
?protocol:string ->
unit ->
inspection_data_response
val make_inspection_data :
?response:inspection_data_response ->
?request:inspection_data_request ->
?after_result_path:string ->
?after_result_selector:string ->
?result:string ->
?after_parameters:string ->
?after_input_path:string ->
?input:string ->
unit ->
inspection_data
val make_test_state_output :
?status:test_execution_status ->
?next_state:string ->
?inspection_data:inspection_data ->
?cause:string ->
?error:string ->
?output:string ->
unit ->
test_state_output
val make_test_state_input :
?reveal_secrets:bool ->
?inspection_level:inspection_level ->
?input:string ->
role_arn:string ->
definition:string ->
unit ->
test_state_input
val make_task_timed_out_event_details :
?cause:string ->
?error:string ->
resource:string ->
resource_type:string ->
unit ->
task_timed_out_event_details
val make_history_event_execution_data_details :
?truncated:bool ->
unit ->
history_event_execution_data_details
val make_task_succeeded_event_details :
?output_details:history_event_execution_data_details ->
?output:string ->
resource:string ->
resource_type:string ->
unit ->
task_succeeded_event_details
val make_task_submitted_event_details :
?output_details:history_event_execution_data_details ->
?output:string ->
resource:string ->
resource_type:string ->
unit ->
task_submitted_event_details
val make_task_submit_failed_event_details :
?cause:string ->
?error:string ->
resource:string ->
resource_type:string ->
unit ->
task_submit_failed_event_details
val make_task_started_event_details :
resource:string ->
resource_type:string ->
unit ->
task_started_event_details
val make_task_start_failed_event_details :
?cause:string ->
?error:string ->
resource:string ->
resource_type:string ->
unit ->
task_start_failed_event_details
val make_task_credentials : ?role_arn:string -> unit -> task_credentials
val make_task_scheduled_event_details :
?task_credentials:task_credentials ->
?heartbeat_in_seconds:int ->
?timeout_in_seconds:int ->
parameters:string ->
region:string ->
resource:string ->
resource_type:string ->
unit ->
task_scheduled_event_details
val make_task_failed_event_details :
?cause:string ->
?error:string ->
resource:string ->
resource_type:string ->
unit ->
task_failed_event_details
val make_tag : ?value:string -> ?key:string -> unit -> tag
val make_tag_resource_input :
tags:tag list ->
resource_arn:string ->
unit ->
tag_resource_input
val make_stop_execution_output :
stop_date:Smaws_Lib.CoreTypes.Timestamp.t ->
unit ->
stop_execution_output
val make_stop_execution_input :
?cause:string ->
?error:string ->
execution_arn:string ->
unit ->
stop_execution_input
val make_state_machine_version_list_item :
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
state_machine_version_arn:string ->
unit ->
state_machine_version_list_item
val make_state_machine_list_item :
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
type_:state_machine_type ->
name:string ->
state_machine_arn:string ->
unit ->
state_machine_list_item
val make_state_machine_alias_list_item :
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
state_machine_alias_arn:string ->
unit ->
state_machine_alias_list_item
val make_state_exited_event_details :
?output_details:history_event_execution_data_details ->
?output:string ->
name:string ->
unit ->
state_exited_event_details
val make_state_entered_event_details :
?input_details:history_event_execution_data_details ->
?input:string ->
name:string ->
unit ->
state_entered_event_details
val make_cloud_watch_events_execution_data_details :
?included:bool ->
unit ->
cloud_watch_events_execution_data_details
val make_billing_details :
?billed_duration_in_milliseconds:int ->
?billed_memory_used_in_m_b:int ->
unit ->
billing_details
val make_start_sync_execution_output :
?billing_details:billing_details ->
?trace_header:string ->
?output_details:cloud_watch_events_execution_data_details ->
?output:string ->
?input_details:cloud_watch_events_execution_data_details ->
?input:string ->
?cause:string ->
?error:string ->
?name:string ->
?state_machine_arn:string ->
status:sync_execution_status ->
stop_date:Smaws_Lib.CoreTypes.Timestamp.t ->
start_date:Smaws_Lib.CoreTypes.Timestamp.t ->
execution_arn:string ->
unit ->
start_sync_execution_output
val make_start_sync_execution_input :
?trace_header:string ->
?input:string ->
?name:string ->
state_machine_arn:string ->
unit ->
start_sync_execution_input
val make_start_execution_output :
start_date:Smaws_Lib.CoreTypes.Timestamp.t ->
execution_arn:string ->
unit ->
start_execution_output
val make_start_execution_input :
?trace_header:string ->
?input:string ->
?name:string ->
state_machine_arn:string ->
unit ->
start_execution_input
val make_send_task_success_input :
output:string ->
task_token:string ->
unit ->
send_task_success_input
val make_send_task_heartbeat_input :
task_token:string ->
unit ->
send_task_heartbeat_input
val make_send_task_failure_input :
?cause:string ->
?error:string ->
task_token:string ->
unit ->
send_task_failure_input
val make_redrive_execution_output :
redrive_date:Smaws_Lib.CoreTypes.Timestamp.t ->
unit ->
redrive_execution_output
val make_redrive_execution_input :
?client_token:string ->
execution_arn:string ->
unit ->
redrive_execution_input
val make_publish_state_machine_version_output :
state_machine_version_arn:string ->
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
unit ->
publish_state_machine_version_output
val make_publish_state_machine_version_input :
?description:string ->
?revision_id:string ->
state_machine_arn:string ->
unit ->
publish_state_machine_version_input
val make_map_state_started_event_details :
?length:int ->
unit ->
map_state_started_event_details
val make_map_run_started_event_details :
?map_run_arn:string ->
unit ->
map_run_started_event_details
val make_map_run_redriven_event_details :
?redrive_count:int ->
?map_run_arn:string ->
unit ->
map_run_redriven_event_details
val make_map_run_list_item :
?stop_date:Smaws_Lib.CoreTypes.Timestamp.t ->
start_date:Smaws_Lib.CoreTypes.Timestamp.t ->
state_machine_arn:string ->
map_run_arn:string ->
execution_arn:string ->
unit ->
map_run_list_item
val make_map_run_item_counts :
?pending_redrive:int ->
?failures_not_redrivable:int ->
results_written:int ->
total:int ->
aborted:int ->
timed_out:int ->
failed:int ->
succeeded:int ->
running:int ->
pending:int ->
unit ->
map_run_item_counts
val make_map_run_failed_event_details :
?cause:string ->
?error:string ->
unit ->
map_run_failed_event_details
val make_map_run_execution_counts :
?pending_redrive:int ->
?failures_not_redrivable:int ->
results_written:int ->
total:int ->
aborted:int ->
timed_out:int ->
failed:int ->
succeeded:int ->
running:int ->
pending:int ->
unit ->
map_run_execution_counts
val make_map_iteration_event_details :
?index:int ->
?name:string ->
unit ->
map_iteration_event_details
val make_list_tags_for_resource_output :
?tags:tag list ->
unit ->
list_tags_for_resource_output
val make_list_tags_for_resource_input :
resource_arn:string ->
unit ->
list_tags_for_resource_input
val make_list_state_machines_output :
?next_token:string ->
state_machines:state_machine_list_item list ->
unit ->
list_state_machines_output
val make_list_state_machines_input :
?next_token:string ->
?max_results:int ->
unit ->
list_state_machines_input
val make_list_state_machine_versions_output :
?next_token:string ->
state_machine_versions:state_machine_version_list_item list ->
unit ->
list_state_machine_versions_output
val make_list_state_machine_versions_input :
?max_results:int ->
?next_token:string ->
state_machine_arn:string ->
unit ->
list_state_machine_versions_input
val make_list_state_machine_aliases_output :
?next_token:string ->
state_machine_aliases:state_machine_alias_list_item list ->
unit ->
list_state_machine_aliases_output
val make_list_state_machine_aliases_input :
?max_results:int ->
?next_token:string ->
state_machine_arn:string ->
unit ->
list_state_machine_aliases_input
val make_list_map_runs_output :
?next_token:string ->
map_runs:map_run_list_item list ->
unit ->
list_map_runs_output
val make_list_map_runs_input :
?next_token:string ->
?max_results:int ->
execution_arn:string ->
unit ->
list_map_runs_input
val make_execution_list_item :
?redrive_date:Smaws_Lib.CoreTypes.Timestamp.t ->
?redrive_count:int ->
?state_machine_alias_arn:string ->
?state_machine_version_arn:string ->
?item_count:int ->
?map_run_arn:string ->
?stop_date:Smaws_Lib.CoreTypes.Timestamp.t ->
start_date:Smaws_Lib.CoreTypes.Timestamp.t ->
status:execution_status ->
name:string ->
state_machine_arn:string ->
execution_arn:string ->
unit ->
execution_list_item
val make_list_executions_output :
?next_token:string ->
executions:execution_list_item list ->
unit ->
list_executions_output
val make_list_executions_input :
?redrive_filter:execution_redrive_filter ->
?map_run_arn:string ->
?next_token:string ->
?max_results:int ->
?status_filter:execution_status ->
?state_machine_arn:string ->
unit ->
list_executions_input
val make_activity_list_item :
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
name:string ->
activity_arn:string ->
unit ->
activity_list_item
val make_list_activities_output :
?next_token:string ->
activities:activity_list_item list ->
unit ->
list_activities_output
val make_list_activities_input :
?next_token:string ->
?max_results:int ->
unit ->
list_activities_input
val make_lambda_function_timed_out_event_details :
?cause:string ->
?error:string ->
unit ->
lambda_function_timed_out_event_details
val make_lambda_function_succeeded_event_details :
?output_details:history_event_execution_data_details ->
?output:string ->
unit ->
lambda_function_succeeded_event_details
val make_lambda_function_start_failed_event_details :
?cause:string ->
?error:string ->
unit ->
lambda_function_start_failed_event_details
val make_lambda_function_scheduled_event_details :
?task_credentials:task_credentials ->
?timeout_in_seconds:int ->
?input_details:history_event_execution_data_details ->
?input:string ->
resource:string ->
unit ->
lambda_function_scheduled_event_details
val make_lambda_function_schedule_failed_event_details :
?cause:string ->
?error:string ->
unit ->
lambda_function_schedule_failed_event_details
val make_lambda_function_failed_event_details :
?cause:string ->
?error:string ->
unit ->
lambda_function_failed_event_details
val make_activity_failed_event_details :
?cause:string ->
?error:string ->
unit ->
activity_failed_event_details
val make_activity_schedule_failed_event_details :
?cause:string ->
?error:string ->
unit ->
activity_schedule_failed_event_details
val make_activity_scheduled_event_details :
?heartbeat_in_seconds:int ->
?timeout_in_seconds:int ->
?input_details:history_event_execution_data_details ->
?input:string ->
resource:string ->
unit ->
activity_scheduled_event_details
val make_activity_started_event_details :
?worker_name:string ->
unit ->
activity_started_event_details
val make_activity_succeeded_event_details :
?output_details:history_event_execution_data_details ->
?output:string ->
unit ->
activity_succeeded_event_details
val make_activity_timed_out_event_details :
?cause:string ->
?error:string ->
unit ->
activity_timed_out_event_details
val make_execution_failed_event_details :
?cause:string ->
?error:string ->
unit ->
execution_failed_event_details
val make_execution_started_event_details :
?state_machine_version_arn:string ->
?state_machine_alias_arn:string ->
?role_arn:string ->
?input_details:history_event_execution_data_details ->
?input:string ->
unit ->
execution_started_event_details
val make_execution_succeeded_event_details :
?output_details:history_event_execution_data_details ->
?output:string ->
unit ->
execution_succeeded_event_details
val make_execution_aborted_event_details :
?cause:string ->
?error:string ->
unit ->
execution_aborted_event_details
val make_execution_timed_out_event_details :
?cause:string ->
?error:string ->
unit ->
execution_timed_out_event_details
val make_execution_redriven_event_details :
?redrive_count:int ->
unit ->
execution_redriven_event_details
val make_history_event :
?map_run_redriven_event_details:map_run_redriven_event_details ->
?map_run_failed_event_details:map_run_failed_event_details ->
?map_run_started_event_details:map_run_started_event_details ->
?state_exited_event_details:state_exited_event_details ->
?state_entered_event_details:state_entered_event_details ->
?lambda_function_timed_out_event_details:
lambda_function_timed_out_event_details ->
?lambda_function_succeeded_event_details:
lambda_function_succeeded_event_details ->
?lambda_function_start_failed_event_details:
lambda_function_start_failed_event_details ->
?lambda_function_scheduled_event_details:
lambda_function_scheduled_event_details ->
?lambda_function_schedule_failed_event_details:
lambda_function_schedule_failed_event_details ->
?lambda_function_failed_event_details:lambda_function_failed_event_details ->
?map_iteration_aborted_event_details:map_iteration_event_details ->
?map_iteration_failed_event_details:map_iteration_event_details ->
?map_iteration_succeeded_event_details:map_iteration_event_details ->
?map_iteration_started_event_details:map_iteration_event_details ->
?map_state_started_event_details:map_state_started_event_details ->
?execution_redriven_event_details:execution_redriven_event_details ->
?execution_timed_out_event_details:execution_timed_out_event_details ->
?execution_aborted_event_details:execution_aborted_event_details ->
?execution_succeeded_event_details:execution_succeeded_event_details ->
?execution_started_event_details:execution_started_event_details ->
?execution_failed_event_details:execution_failed_event_details ->
?task_timed_out_event_details:task_timed_out_event_details ->
?task_succeeded_event_details:task_succeeded_event_details ->
?task_submitted_event_details:task_submitted_event_details ->
?task_submit_failed_event_details:task_submit_failed_event_details ->
?task_started_event_details:task_started_event_details ->
?task_start_failed_event_details:task_start_failed_event_details ->
?task_scheduled_event_details:task_scheduled_event_details ->
?task_failed_event_details:task_failed_event_details ->
?activity_timed_out_event_details:activity_timed_out_event_details ->
?activity_succeeded_event_details:activity_succeeded_event_details ->
?activity_started_event_details:activity_started_event_details ->
?activity_scheduled_event_details:activity_scheduled_event_details ->
?activity_schedule_failed_event_details:
activity_schedule_failed_event_details ->
?activity_failed_event_details:activity_failed_event_details ->
?previous_event_id:int ->
id:int ->
type_:history_event_type ->
timestamp_:Smaws_Lib.CoreTypes.Timestamp.t ->
unit ->
history_event
val make_get_execution_history_output :
?next_token:string ->
events:history_event list ->
unit ->
get_execution_history_output
val make_get_execution_history_input :
?include_execution_data:bool ->
?next_token:string ->
?reverse_order:bool ->
?max_results:int ->
execution_arn:string ->
unit ->
get_execution_history_input
val make_get_activity_task_output :
?input:string ->
?task_token:string ->
unit ->
get_activity_task_output
val make_get_activity_task_input :
?worker_name:string ->
activity_arn:string ->
unit ->
get_activity_task_input
val make_describe_state_machine_output :
?description:string ->
?revision_id:string ->
?label:string ->
?tracing_configuration:tracing_configuration ->
?logging_configuration:logging_configuration ->
?status:state_machine_status ->
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
type_:state_machine_type ->
role_arn:string ->
definition:string ->
name:string ->
state_machine_arn:string ->
unit ->
describe_state_machine_output
val make_describe_state_machine_input :
state_machine_arn:string ->
unit ->
describe_state_machine_input
val make_describe_state_machine_for_execution_output :
?revision_id:string ->
?label:string ->
?map_run_arn:string ->
?tracing_configuration:tracing_configuration ->
?logging_configuration:logging_configuration ->
update_date:Smaws_Lib.CoreTypes.Timestamp.t ->
role_arn:string ->
definition:string ->
name:string ->
state_machine_arn:string ->
unit ->
describe_state_machine_for_execution_output
val make_describe_state_machine_for_execution_input :
execution_arn:string ->
unit ->
describe_state_machine_for_execution_input
val make_describe_state_machine_alias_output :
?update_date:Smaws_Lib.CoreTypes.Timestamp.t ->
?creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
?routing_configuration:routing_configuration_list_item list ->
?description:string ->
?name:string ->
?state_machine_alias_arn:string ->
unit ->
describe_state_machine_alias_output
val make_describe_state_machine_alias_input :
state_machine_alias_arn:string ->
unit ->
describe_state_machine_alias_input
val make_describe_map_run_output :
?redrive_date:Smaws_Lib.CoreTypes.Timestamp.t ->
?redrive_count:int ->
?stop_date:Smaws_Lib.CoreTypes.Timestamp.t ->
execution_counts:map_run_execution_counts ->
item_counts:map_run_item_counts ->
tolerated_failure_count:int ->
tolerated_failure_percentage:float ->
max_concurrency:int ->
start_date:Smaws_Lib.CoreTypes.Timestamp.t ->
status:map_run_status ->
execution_arn:string ->
map_run_arn:string ->
unit ->
describe_map_run_output
val make_describe_map_run_input :
map_run_arn:string ->
unit ->
describe_map_run_input
val make_describe_execution_output :
?redrive_status_reason:string ->
?redrive_status:execution_redrive_status ->
?redrive_date:Smaws_Lib.CoreTypes.Timestamp.t ->
?redrive_count:int ->
?state_machine_alias_arn:string ->
?state_machine_version_arn:string ->
?cause:string ->
?error:string ->
?map_run_arn:string ->
?trace_header:string ->
?output_details:cloud_watch_events_execution_data_details ->
?output:string ->
?input_details:cloud_watch_events_execution_data_details ->
?input:string ->
?stop_date:Smaws_Lib.CoreTypes.Timestamp.t ->
?name:string ->
start_date:Smaws_Lib.CoreTypes.Timestamp.t ->
status:execution_status ->
state_machine_arn:string ->
execution_arn:string ->
unit ->
describe_execution_output
val make_describe_execution_input :
execution_arn:string ->
unit ->
describe_execution_input
val make_describe_activity_output :
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
name:string ->
activity_arn:string ->
unit ->
describe_activity_output
val make_describe_activity_input :
activity_arn:string ->
unit ->
describe_activity_input
val make_delete_state_machine_version_input :
state_machine_version_arn:string ->
unit ->
delete_state_machine_version_input
val make_delete_state_machine_input :
state_machine_arn:string ->
unit ->
delete_state_machine_input
val make_delete_state_machine_alias_input :
state_machine_alias_arn:string ->
unit ->
delete_state_machine_alias_input
val make_delete_activity_input :
activity_arn:string ->
unit ->
delete_activity_input
val make_create_state_machine_output :
?state_machine_version_arn:string ->
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
state_machine_arn:string ->
unit ->
create_state_machine_output
val make_create_state_machine_input :
?version_description:string ->
?publish:bool ->
?tracing_configuration:tracing_configuration ->
?tags:tag list ->
?logging_configuration:logging_configuration ->
?type_:state_machine_type ->
role_arn:string ->
definition:string ->
name:string ->
unit ->
create_state_machine_input
val make_create_state_machine_alias_output :
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
state_machine_alias_arn:string ->
unit ->
create_state_machine_alias_output
val make_create_state_machine_alias_input :
?description:string ->
routing_configuration:routing_configuration_list_item list ->
name:string ->
unit ->
create_state_machine_alias_input
val make_create_activity_output :
creation_date:Smaws_Lib.CoreTypes.Timestamp.t ->
activity_arn:string ->
unit ->
create_activity_output
val make_create_activity_input :
?tags:tag list ->
name:string ->
unit ->
create_activity_input
Operations
module CreateActivity : sig ... end
Creates an activity. An activity is a task that you write in any programming language and host on any machine that has access to 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.
module CreateStateMachine : sig ... end
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. For more information, see Amazon States Language in the Step Functions User Guide.
module CreateStateMachineAlias : sig ... end
module DeleteActivity : sig ... end
Deletes an activity.
module DeleteStateMachine : sig ... end
Deletes a state machine. This is an asynchronous operation. It sets the state machine's status to DELETING
and begins the deletion process. A state machine is deleted only when all its executions are completed. On the next state transition, the state machine's executions are terminated.
module DeleteStateMachineAlias : sig ... end
Deletes a state machine alias.
module DeleteStateMachineVersion : sig ... end
module DescribeActivity : sig ... end
Describes an activity.
module DescribeExecution : sig ... end
Provides information about a state machine execution, such as the state machine associated with the execution, the execution input and output, and relevant execution metadata. If you've redriven an execution, you can use this API action to return information about the redrives of that execution. In addition, you can use this API action to return the Map Run Amazon Resource Name (ARN) if the execution was dispatched by a Map Run.
module DescribeMapRun : sig ... end
Provides information about a Map Run's configuration, progress, and results. If you've redriven a Map Run, this API action also returns information about the redrives of that Map Run. For more information, see Examining Map Run in the Step Functions Developer Guide.
module DescribeStateMachine : sig ... end
Provides information about a state machine's definition, its IAM role Amazon Resource Name (ARN), and configuration.
module DescribeStateMachineAlias : sig ... end
Returns details about a state machine alias.
module DescribeStateMachineForExecution : sig ... end
Provides information about a state machine's definition, its execution role ARN, and configuration. If a Map Run dispatched the execution, this action returns the Map Run Amazon Resource Name (ARN) in the response. The state machine returned is the state machine associated with the Map Run.
module GetActivityTask : sig ... end
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.
module GetExecutionHistory : sig ... end
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.
module ListActivities : sig ... end
Lists the existing activities.
module ListExecutions : sig ... end
Lists all executions of a state machine or a Map Run. You can list all executions related to a state machine by specifying a state machine Amazon Resource Name (ARN), or those related to a Map Run by specifying a Map Run ARN. Using this API action, you can also list all redriven executions.
module ListMapRuns : sig ... end
Lists all Map Runs that were started by a given state machine execution. Use this API action to obtain Map Run ARNs, and then call DescribeMapRun
to obtain more information, if needed.
module ListStateMachineAliases : sig ... end
Lists aliases for a specified state machine ARN. Results are sorted by time, with the most recently created aliases listed first.
module ListStateMachineVersions : sig ... end
Lists versions for the specified state machine Amazon Resource Name (ARN).
module ListStateMachines : sig ... end
Lists the existing state machines.
module ListTagsForResource : sig ... end
List tags for a given resource.
module PublishStateMachineVersion : sig ... end
Creates a version from the current revision of a state machine. Use versions to create immutable snapshots of your state machine. You can start executions from versions either directly or with an alias. To create an alias, use CreateStateMachineAlias
.
module RedriveExecution : sig ... end
Restarts unsuccessful executions of Standard workflows that didn't complete successfully in the last 14 days. These include failed, aborted, or timed out executions. When you redrive an execution, it continues the failed execution from the unsuccessful step and uses the same input. Step Functions preserves the results and execution history of the successful steps, and doesn't rerun these steps when you redrive an execution. Redriven executions use the same state machine definition and execution ARN as the original execution attempt.
module SendTaskFailure : sig ... end
module SendTaskHeartbeat : sig ... end
Used by activity workers and Task states using the callback pattern, and optionally Task states using the job run pattern to report to Step Functions 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 (HeartbeatSeconds
). 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
entry for activities, or a TaskTimedOut
entry for tasks using the job run or callback pattern.
module SendTaskSuccess : sig ... end
module StartExecution : sig ... end
Starts a state machine execution.
module StartSyncExecution : sig ... end
Starts a Synchronous Express state machine execution. StartSyncExecution
is not available for STANDARD
workflows.
module StopExecution : sig ... end
Stops an execution.
module TagResource : sig ... end
Add a tag to a Step Functions resource.
module TestState : sig ... end
Accepts the definition of a single state and executes it. You can test a state without creating a state machine or updating an existing state machine. Using this API, you can test the following:
module UntagResource : sig ... end
Remove a tag from a Step Functions resource
module UpdateMapRun : sig ... end
Updates an in-progress Map Run's configuration to include changes to the settings that control maximum concurrency and Map Run failure.
module UpdateStateMachine : sig ... end
Updates an existing state machine by modifying its definition
, roleArn
, or loggingConfiguration
. 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.
module UpdateStateMachineAlias : sig ... end
Updates the configuration of an existing state machine alias by modifying its description
or routingConfiguration
.
module ValidateStateMachineDefinition : sig ... end
Validates the syntax of a state machine definition.