amazonka-stepfunctions-2.0: Amazon Step Functions SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.StepFunctions.Lens

Contents

Description

 
Synopsis

Operations

CreateActivity

createActivity_tags :: Lens' CreateActivity (Maybe [Tag]) Source #

The list of tags to add to a resource.

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: _ . : / = + - @.

createActivity_name :: Lens' CreateActivity Text Source #

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:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

createActivityResponse_activityArn :: Lens' CreateActivityResponse Text Source #

The Amazon Resource Name (ARN) that identifies the created activity.

CreateStateMachine

createStateMachine_loggingConfiguration :: Lens' CreateStateMachine (Maybe LoggingConfiguration) Source #

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.

createStateMachine_tags :: Lens' CreateStateMachine (Maybe [Tag]) Source #

Tags to be added when creating a state machine.

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: _ . : / = + - @.

createStateMachine_type :: Lens' CreateStateMachine (Maybe StateMachineType) Source #

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.

createStateMachine_name :: Lens' CreateStateMachine Text Source #

The name of the state machine.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

createStateMachine_definition :: Lens' CreateStateMachine Text Source #

The Amazon States Language definition of the state machine. See Amazon States Language.

createStateMachine_roleArn :: Lens' CreateStateMachine Text Source #

The Amazon Resource Name (ARN) of the IAM role to use for this state machine.

createStateMachineResponse_stateMachineArn :: Lens' CreateStateMachineResponse Text Source #

The Amazon Resource Name (ARN) that identifies the created state machine.

DeleteActivity

deleteActivity_activityArn :: Lens' DeleteActivity Text Source #

The Amazon Resource Name (ARN) of the activity to delete.

DeleteStateMachine

deleteStateMachine_stateMachineArn :: Lens' DeleteStateMachine Text Source #

The Amazon Resource Name (ARN) of the state machine to delete.

DescribeActivity

describeActivity_activityArn :: Lens' DescribeActivity Text Source #

The Amazon Resource Name (ARN) of the activity to describe.

describeActivityResponse_activityArn :: Lens' DescribeActivityResponse Text Source #

The Amazon Resource Name (ARN) that identifies the activity.

describeActivityResponse_name :: Lens' DescribeActivityResponse Text Source #

The name of the activity.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

DescribeExecution

describeExecution_executionArn :: Lens' DescribeExecution Text Source #

The Amazon Resource Name (ARN) of the execution to describe.

describeExecutionResponse_cause :: Lens' DescribeExecutionResponse (Maybe Text) Source #

The cause string if the state machine execution failed.

describeExecutionResponse_error :: Lens' DescribeExecutionResponse (Maybe Text) Source #

The error string if the state machine execution failed.

describeExecutionResponse_input :: Lens' DescribeExecutionResponse (Maybe Text) Source #

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.

describeExecutionResponse_mapRunArn :: Lens' DescribeExecutionResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) that identifies a Map Run, which dispatched this execution.

describeExecutionResponse_name :: Lens' DescribeExecutionResponse (Maybe Text) Source #

The name of the execution.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

describeExecutionResponse_output :: Lens' DescribeExecutionResponse (Maybe Text) Source #

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.

describeExecutionResponse_stopDate :: Lens' DescribeExecutionResponse (Maybe UTCTime) Source #

If the execution has already ended, the date the execution stopped.

describeExecutionResponse_traceHeader :: Lens' DescribeExecutionResponse (Maybe Text) Source #

The X-Ray trace header that was passed to the execution.

describeExecutionResponse_executionArn :: Lens' DescribeExecutionResponse Text Source #

The Amazon Resource Name (ARN) that identifies the execution.

describeExecutionResponse_stateMachineArn :: Lens' DescribeExecutionResponse Text Source #

The Amazon Resource Name (ARN) of the executed stated machine.

DescribeMapRun

describeMapRun_mapRunArn :: Lens' DescribeMapRun Text Source #

The Amazon Resource Name (ARN) that identifies a Map Run.

describeMapRunResponse_mapRunArn :: Lens' DescribeMapRunResponse Text Source #

The Amazon Resource Name (ARN) that identifies a Map Run.

describeMapRunResponse_executionArn :: Lens' DescribeMapRunResponse Text Source #

The Amazon Resource Name (ARN) that identifies the execution in which the Map Run was started.

describeMapRunResponse_maxConcurrency :: Lens' DescribeMapRunResponse Natural Source #

The maximum number of child workflow executions configured to run in parallel for the Map Run at the same time.

describeMapRunResponse_toleratedFailurePercentage :: Lens' DescribeMapRunResponse Double Source #

The maximum percentage of failed child workflow executions before the Map Run fails.

describeMapRunResponse_toleratedFailureCount :: Lens' DescribeMapRunResponse Natural Source #

The maximum number of failed child workflow executions before the Map Run fails.

describeMapRunResponse_itemCounts :: Lens' DescribeMapRunResponse MapRunItemCounts Source #

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.

describeMapRunResponse_executionCounts :: Lens' DescribeMapRunResponse MapRunExecutionCounts Source #

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.

DescribeStateMachine

describeStateMachine_stateMachineArn :: Lens' DescribeStateMachine Text Source #

The Amazon Resource Name (ARN) of the state machine to describe.

describeStateMachineResponse_label :: Lens' DescribeStateMachineResponse (Maybe Text) Source #

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.

describeStateMachineResponse_stateMachineArn :: Lens' DescribeStateMachineResponse Text Source #

The Amazon Resource Name (ARN) that identifies the state machine.

describeStateMachineResponse_name :: Lens' DescribeStateMachineResponse Text Source #

The name of the state machine.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

describeStateMachineResponse_definition :: Lens' DescribeStateMachineResponse Text Source #

The Amazon States Language definition of the state machine. See Amazon States Language.

describeStateMachineResponse_roleArn :: Lens' DescribeStateMachineResponse Text Source #

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.)

describeStateMachineResponse_type :: Lens' DescribeStateMachineResponse StateMachineType Source #

The type of the state machine (STANDARD or EXPRESS).

DescribeStateMachineForExecution

describeStateMachineForExecution_executionArn :: Lens' DescribeStateMachineForExecution Text Source #

The Amazon Resource Name (ARN) of the execution you want state machine information for.

describeStateMachineForExecutionResponse_label :: Lens' DescribeStateMachineForExecutionResponse (Maybe Text) Source #

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.

describeStateMachineForExecutionResponse_mapRunArn :: Lens' DescribeStateMachineForExecutionResponse (Maybe Text) Source #

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.

describeStateMachineForExecutionResponse_stateMachineArn :: Lens' DescribeStateMachineForExecutionResponse Text Source #

The Amazon Resource Name (ARN) of the state machine associated with the execution.

describeStateMachineForExecutionResponse_name :: Lens' DescribeStateMachineForExecutionResponse Text Source #

The name of the state machine associated with the execution.

describeStateMachineForExecutionResponse_roleArn :: Lens' DescribeStateMachineForExecutionResponse Text Source #

The Amazon Resource Name (ARN) of the IAM role of the State Machine for the execution.

describeStateMachineForExecutionResponse_updateDate :: Lens' DescribeStateMachineForExecutionResponse UTCTime Source #

The date and time the state machine associated with an execution was updated. For a newly created state machine, this is the creation date.

GetActivityTask

getActivityTask_workerName :: Lens' GetActivityTask (Maybe Text) Source #

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.

getActivityTask_activityArn :: Lens' GetActivityTask Text Source #

The Amazon Resource Name (ARN) of the activity to retrieve tasks from (assigned when you create the task using CreateActivity.)

getActivityTaskResponse_input :: Lens' GetActivityTaskResponse (Maybe Text) Source #

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.

getActivityTaskResponse_taskToken :: Lens' GetActivityTaskResponse (Maybe Text) Source #

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.

GetExecutionHistory

getExecutionHistory_includeExecutionData :: Lens' GetExecutionHistory (Maybe Bool) Source #

You can select whether execution data (input or output of a history event) is returned. The default is true.

getExecutionHistory_maxResults :: Lens' GetExecutionHistory (Maybe Natural) Source #

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.

getExecutionHistory_nextToken :: Lens' GetExecutionHistory (Maybe Text) Source #

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.

getExecutionHistory_reverseOrder :: Lens' GetExecutionHistory (Maybe Bool) Source #

Lists events in descending order of their timeStamp.

getExecutionHistory_executionArn :: Lens' GetExecutionHistory Text Source #

The Amazon Resource Name (ARN) of the execution.

getExecutionHistoryResponse_nextToken :: Lens' GetExecutionHistoryResponse (Maybe Text) Source #

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.

getExecutionHistoryResponse_events :: Lens' GetExecutionHistoryResponse [HistoryEvent] Source #

The list of events that occurred in the execution.

ListActivities

listActivities_maxResults :: Lens' ListActivities (Maybe Natural) Source #

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.

listActivities_nextToken :: Lens' ListActivities (Maybe Text) Source #

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.

listActivitiesResponse_nextToken :: Lens' ListActivitiesResponse (Maybe Text) Source #

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.

ListExecutions

listExecutions_mapRunArn :: Lens' ListExecutions (Maybe Text) Source #

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.

listExecutions_maxResults :: Lens' ListExecutions (Maybe Natural) Source #

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.

listExecutions_nextToken :: Lens' ListExecutions (Maybe Text) Source #

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.

listExecutions_stateMachineArn :: Lens' ListExecutions (Maybe Text) Source #

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.

listExecutions_statusFilter :: Lens' ListExecutions (Maybe ExecutionStatus) Source #

If specified, only list the executions whose current execution status matches the given filter.

listExecutionsResponse_nextToken :: Lens' ListExecutionsResponse (Maybe Text) Source #

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.

ListMapRuns

listMapRuns_maxResults :: Lens' ListMapRuns (Maybe Natural) Source #

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.

listMapRuns_nextToken :: Lens' ListMapRuns (Maybe Text) Source #

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.

listMapRuns_executionArn :: Lens' ListMapRuns Text Source #

The Amazon Resource Name (ARN) of the execution for which the Map Runs must be listed.

listMapRunsResponse_nextToken :: Lens' ListMapRunsResponse (Maybe Text) Source #

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.

listMapRunsResponse_mapRuns :: Lens' ListMapRunsResponse [MapRunListItem] Source #

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.

ListStateMachines

listStateMachines_maxResults :: Lens' ListStateMachines (Maybe Natural) Source #

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.

listStateMachines_nextToken :: Lens' ListStateMachines (Maybe Text) Source #

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.

listStateMachinesResponse_nextToken :: Lens' ListStateMachinesResponse (Maybe Text) Source #

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.

ListTagsForResource

listTagsForResource_resourceArn :: Lens' ListTagsForResource Text Source #

The Amazon Resource Name (ARN) for the Step Functions state machine or activity.

listTagsForResourceResponse_tags :: Lens' ListTagsForResourceResponse (Maybe [Tag]) Source #

An array of tags associated with the resource.

SendTaskFailure

sendTaskFailure_cause :: Lens' SendTaskFailure (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

sendTaskFailure_error :: Lens' SendTaskFailure (Maybe Text) Source #

The error code of the failure.

sendTaskFailure_taskToken :: Lens' SendTaskFailure Text Source #

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.

SendTaskHeartbeat

sendTaskHeartbeat_taskToken :: Lens' SendTaskHeartbeat Text Source #

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.

SendTaskSuccess

sendTaskSuccess_taskToken :: Lens' SendTaskSuccess Text Source #

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.

sendTaskSuccess_output :: Lens' SendTaskSuccess Text Source #

The JSON output of the task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

StartExecution

startExecution_input :: Lens' StartExecution (Maybe Text) Source #

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.

startExecution_name :: Lens' StartExecution (Maybe Text) Source #

The 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.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

startExecution_traceHeader :: Lens' StartExecution (Maybe Text) Source #

Passes the X-Ray trace header. The trace header can also be passed in the request payload.

startExecution_stateMachineArn :: Lens' StartExecution Text Source #

The Amazon Resource Name (ARN) of the state machine to execute.

startExecutionResponse_executionArn :: Lens' StartExecutionResponse Text Source #

The Amazon Resource Name (ARN) that identifies the execution.

StartSyncExecution

startSyncExecution_input :: Lens' StartSyncExecution (Maybe Text) Source #

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.

startSyncExecution_traceHeader :: Lens' StartSyncExecution (Maybe Text) Source #

Passes the X-Ray trace header. The trace header can also be passed in the request payload.

startSyncExecution_stateMachineArn :: Lens' StartSyncExecution Text Source #

The Amazon Resource Name (ARN) of the state machine to execute.

startSyncExecutionResponse_billingDetails :: Lens' StartSyncExecutionResponse (Maybe BillingDetails) Source #

An object that describes workflow billing details, including billed duration and memory use.

startSyncExecutionResponse_cause :: Lens' StartSyncExecutionResponse (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

startSyncExecutionResponse_input :: Lens' StartSyncExecutionResponse (Maybe Text) Source #

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.

startSyncExecutionResponse_output :: Lens' StartSyncExecutionResponse (Maybe Text) Source #

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.

startSyncExecutionResponse_stateMachineArn :: Lens' StartSyncExecutionResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) that identifies the state machine.

startSyncExecutionResponse_traceHeader :: Lens' StartSyncExecutionResponse (Maybe Text) Source #

The X-Ray trace header that was passed to the execution.

startSyncExecutionResponse_executionArn :: Lens' StartSyncExecutionResponse Text Source #

The Amazon Resource Name (ARN) that identifies the execution.

startSyncExecutionResponse_stopDate :: Lens' StartSyncExecutionResponse UTCTime Source #

If the execution has already ended, the date the execution stopped.

StopExecution

stopExecution_cause :: Lens' StopExecution (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

stopExecution_error :: Lens' StopExecution (Maybe Text) Source #

The error code of the failure.

stopExecution_executionArn :: Lens' StopExecution Text Source #

The Amazon Resource Name (ARN) of the execution to stop.

TagResource

tagResource_resourceArn :: Lens' TagResource Text Source #

The Amazon Resource Name (ARN) for the Step Functions state machine or activity.

tagResource_tags :: Lens' TagResource [Tag] Source #

The list of tags to add to a resource.

Tags may only contain Unicode letters, digits, white space, or these symbols: _ . : / = + - @.

UntagResource

untagResource_resourceArn :: Lens' UntagResource Text Source #

The Amazon Resource Name (ARN) for the Step Functions state machine or activity.

untagResource_tagKeys :: Lens' UntagResource [Text] Source #

The list of tags to remove from the resource.

UpdateMapRun

updateMapRun_maxConcurrency :: Lens' UpdateMapRun (Maybe Natural) Source #

The maximum number of child workflow executions that can be specified to run in parallel for the Map Run at the same time.

updateMapRun_toleratedFailureCount :: Lens' UpdateMapRun (Maybe Natural) Source #

The maximum number of failed items before the Map Run fails.

updateMapRun_toleratedFailurePercentage :: Lens' UpdateMapRun (Maybe Double) Source #

The maximum percentage of failed items before the Map Run fails.

updateMapRun_mapRunArn :: Lens' UpdateMapRun Text Source #

The Amazon Resource Name (ARN) of a Map Run.

UpdateStateMachine

updateStateMachine_definition :: Lens' UpdateStateMachine (Maybe Text) Source #

The Amazon States Language definition of the state machine. See Amazon States Language.

updateStateMachine_loggingConfiguration :: Lens' UpdateStateMachine (Maybe LoggingConfiguration) Source #

The LoggingConfiguration data type is used to set CloudWatch Logs options.

updateStateMachine_roleArn :: Lens' UpdateStateMachine (Maybe Text) Source #

The Amazon Resource Name (ARN) of the IAM role of the state machine.

updateStateMachine_stateMachineArn :: Lens' UpdateStateMachine Text Source #

The Amazon Resource Name (ARN) of the state machine.

updateStateMachineResponse_updateDate :: Lens' UpdateStateMachineResponse UTCTime Source #

The date and time the state machine was updated.

Types

ActivityFailedEventDetails

activityFailedEventDetails_cause :: Lens' ActivityFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

ActivityListItem

activityListItem_activityArn :: Lens' ActivityListItem Text Source #

The Amazon Resource Name (ARN) that identifies the activity.

activityListItem_name :: Lens' ActivityListItem Text Source #

The name of the activity.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

ActivityScheduleFailedEventDetails

activityScheduleFailedEventDetails_cause :: Lens' ActivityScheduleFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

ActivityScheduledEventDetails

activityScheduledEventDetails_heartbeatInSeconds :: Lens' ActivityScheduledEventDetails (Maybe Integer) Source #

The maximum allowed duration between two heartbeats for the activity task.

activityScheduledEventDetails_input :: Lens' ActivityScheduledEventDetails (Maybe Text) Source #

The JSON data input to the activity task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

activityScheduledEventDetails_resource :: Lens' ActivityScheduledEventDetails Text Source #

The Amazon Resource Name (ARN) of the scheduled activity.

ActivityStartedEventDetails

activityStartedEventDetails_workerName :: Lens' ActivityStartedEventDetails (Maybe Text) Source #

The name of the worker that the task is assigned to. These names are provided by the workers when calling GetActivityTask.

ActivitySucceededEventDetails

activitySucceededEventDetails_output :: Lens' ActivitySucceededEventDetails (Maybe Text) Source #

The JSON data output by the activity task. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

ActivityTimedOutEventDetails

activityTimedOutEventDetails_cause :: Lens' ActivityTimedOutEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the timeout.

BillingDetails

billingDetails_billedDurationInMilliseconds :: Lens' BillingDetails (Maybe Natural) Source #

Billed duration of your workflow, in milliseconds.

billingDetails_billedMemoryUsedInMB :: Lens' BillingDetails (Maybe Natural) Source #

Billed memory consumption of your workflow, in MB.

CloudWatchEventsExecutionDataDetails

cloudWatchEventsExecutionDataDetails_included :: Lens' CloudWatchEventsExecutionDataDetails (Maybe Bool) Source #

Indicates whether input or output was included in the response. Always true for API calls.

CloudWatchLogsLogGroup

cloudWatchLogsLogGroup_logGroupArn :: Lens' CloudWatchLogsLogGroup (Maybe Text) Source #

The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with :*

ExecutionAbortedEventDetails

executionAbortedEventDetails_cause :: Lens' ExecutionAbortedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

ExecutionFailedEventDetails

executionFailedEventDetails_cause :: Lens' ExecutionFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

ExecutionListItem

executionListItem_itemCount :: Lens' ExecutionListItem (Maybe Natural) Source #

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.

executionListItem_mapRunArn :: Lens' ExecutionListItem (Maybe Text) Source #

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.

executionListItem_stopDate :: Lens' ExecutionListItem (Maybe UTCTime) Source #

If the execution already ended, the date the execution stopped.

executionListItem_executionArn :: Lens' ExecutionListItem Text Source #

The Amazon Resource Name (ARN) that identifies the execution.

executionListItem_stateMachineArn :: Lens' ExecutionListItem Text Source #

The Amazon Resource Name (ARN) of the executed state machine.

executionListItem_name :: Lens' ExecutionListItem Text Source #

The name of the execution.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

ExecutionStartedEventDetails

executionStartedEventDetails_input :: Lens' ExecutionStartedEventDetails (Maybe Text) Source #

The JSON data input to the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

executionStartedEventDetails_roleArn :: Lens' ExecutionStartedEventDetails (Maybe Text) Source #

The Amazon Resource Name (ARN) of the IAM role used for executing Lambda tasks.

ExecutionSucceededEventDetails

executionSucceededEventDetails_output :: Lens' ExecutionSucceededEventDetails (Maybe Text) Source #

The JSON data output by the execution. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

ExecutionTimedOutEventDetails

executionTimedOutEventDetails_cause :: Lens' ExecutionTimedOutEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the timeout.

HistoryEvent

historyEvent_activityScheduleFailedEventDetails :: Lens' HistoryEvent (Maybe ActivityScheduleFailedEventDetails) Source #

Contains details about an activity schedule event that failed during an execution.

historyEvent_lambdaFunctionStartFailedEventDetails :: Lens' HistoryEvent (Maybe LambdaFunctionStartFailedEventDetails) Source #

Contains details about a lambda function that failed to start during an execution.

historyEvent_lambdaFunctionSucceededEventDetails :: Lens' HistoryEvent (Maybe LambdaFunctionSucceededEventDetails) Source #

Contains details about a Lambda function that terminated successfully during an execution.

historyEvent_mapIterationAbortedEventDetails :: Lens' HistoryEvent (Maybe MapIterationEventDetails) Source #

Contains details about an iteration of a Map state that was aborted.

historyEvent_mapIterationFailedEventDetails :: Lens' HistoryEvent (Maybe MapIterationEventDetails) Source #

Contains details about an iteration of a Map state that failed.

historyEvent_mapIterationStartedEventDetails :: Lens' HistoryEvent (Maybe MapIterationEventDetails) Source #

Contains details about an iteration of a Map state that was started.

historyEvent_mapIterationSucceededEventDetails :: Lens' HistoryEvent (Maybe MapIterationEventDetails) Source #

Contains details about an iteration of a Map state that succeeded.

historyEvent_mapRunFailedEventDetails :: Lens' HistoryEvent (Maybe MapRunFailedEventDetails) Source #

Contains error and cause details about a Map Run that failed.

historyEvent_mapRunStartedEventDetails :: Lens' HistoryEvent (Maybe MapRunStartedEventDetails) Source #

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.

historyEvent_taskSubmitFailedEventDetails :: Lens' HistoryEvent (Maybe TaskSubmitFailedEventDetails) Source #

Contains details about a task that where the submit failed.

historyEvent_timestamp :: Lens' HistoryEvent UTCTime Source #

The date and time the event occurred.

historyEvent_id :: Lens' HistoryEvent Integer Source #

The id of the event. Events are numbered sequentially, starting at one.

HistoryEventExecutionDataDetails

historyEventExecutionDataDetails_truncated :: Lens' HistoryEventExecutionDataDetails (Maybe Bool) Source #

Indicates whether input or output was truncated in the response. Always false for API calls.

LambdaFunctionFailedEventDetails

lambdaFunctionFailedEventDetails_cause :: Lens' LambdaFunctionFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

LambdaFunctionScheduleFailedEventDetails

LambdaFunctionScheduledEventDetails

lambdaFunctionScheduledEventDetails_input :: Lens' LambdaFunctionScheduledEventDetails (Maybe Text) Source #

The JSON data input to the Lambda function. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

lambdaFunctionScheduledEventDetails_resource :: Lens' LambdaFunctionScheduledEventDetails Text Source #

The Amazon Resource Name (ARN) of the scheduled Lambda function.

LambdaFunctionStartFailedEventDetails

LambdaFunctionSucceededEventDetails

lambdaFunctionSucceededEventDetails_output :: Lens' LambdaFunctionSucceededEventDetails (Maybe Text) Source #

The JSON data output by the Lambda function. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

LambdaFunctionTimedOutEventDetails

lambdaFunctionTimedOutEventDetails_cause :: Lens' LambdaFunctionTimedOutEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the timeout.

LogDestination

logDestination_cloudWatchLogsLogGroup :: Lens' LogDestination (Maybe CloudWatchLogsLogGroup) Source #

An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the CloudFormation User Guide.

LoggingConfiguration

loggingConfiguration_destinations :: Lens' LoggingConfiguration (Maybe [LogDestination]) Source #

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.

loggingConfiguration_includeExecutionData :: Lens' LoggingConfiguration (Maybe Bool) Source #

Determines whether execution data is included in your log. When set to false, data is excluded.

loggingConfiguration_level :: Lens' LoggingConfiguration (Maybe LogLevel) Source #

Defines which category of execution history events are logged.

MapIterationEventDetails

mapIterationEventDetails_index :: Lens' MapIterationEventDetails (Maybe Natural) Source #

The index of the array belonging to the Map state iteration.

mapIterationEventDetails_name :: Lens' MapIterationEventDetails (Maybe Text) Source #

The name of the iteration’s parent Map state.

MapRunExecutionCounts

mapRunExecutionCounts_pending :: Lens' MapRunExecutionCounts Natural Source #

The total number of child workflow executions that were started by a Map Run, but haven't started executing yet.

mapRunExecutionCounts_running :: Lens' MapRunExecutionCounts Natural Source #

The total number of child workflow executions that were started by a Map Run and are currently in-progress.

mapRunExecutionCounts_succeeded :: Lens' MapRunExecutionCounts Natural Source #

The total number of child workflow executions that were started by a Map Run and have completed successfully.

mapRunExecutionCounts_failed :: Lens' MapRunExecutionCounts Natural Source #

The total number of child workflow executions that were started by a Map Run, but have failed.

mapRunExecutionCounts_timedOut :: Lens' MapRunExecutionCounts Natural Source #

The total number of child workflow executions that were started by a Map Run and have timed out.

mapRunExecutionCounts_aborted :: Lens' MapRunExecutionCounts Natural Source #

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.

mapRunExecutionCounts_total :: Lens' MapRunExecutionCounts Natural Source #

The total number of child workflow executions that were started by a Map Run.

mapRunExecutionCounts_resultsWritten :: Lens' MapRunExecutionCounts Natural Source #

Returns the count of child workflow executions whose results were written by ResultWriter. For more information, see ResultWriter in the Step Functions Developer Guide.

MapRunFailedEventDetails

mapRunFailedEventDetails_cause :: Lens' MapRunFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

MapRunItemCounts

mapRunItemCounts_pending :: Lens' MapRunItemCounts Natural Source #

The total number of items to process in child workflow executions that haven't started running yet.

mapRunItemCounts_running :: Lens' MapRunItemCounts Natural Source #

The total number of items being processed in child workflow executions that are currently in-progress.

mapRunItemCounts_succeeded :: Lens' MapRunItemCounts Natural Source #

The total number of items processed in child workflow executions that have completed successfully.

mapRunItemCounts_failed :: Lens' MapRunItemCounts Natural Source #

The total number of items processed in child workflow executions that have failed.

mapRunItemCounts_timedOut :: Lens' MapRunItemCounts Natural Source #

The total number of items processed in child workflow executions that have timed out.

mapRunItemCounts_aborted :: Lens' MapRunItemCounts Natural Source #

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.

mapRunItemCounts_total :: Lens' MapRunItemCounts Natural Source #

The total number of items processed in all the child workflow executions started by a Map Run.

mapRunItemCounts_resultsWritten :: Lens' MapRunItemCounts Natural Source #

Returns the count of items whose results were written by ResultWriter. For more information, see ResultWriter in the Step Functions Developer Guide.

MapRunListItem

mapRunListItem_stopDate :: Lens' MapRunListItem (Maybe UTCTime) Source #

The date on which the Map Run stopped.

mapRunListItem_executionArn :: Lens' MapRunListItem Text Source #

The executionArn of the execution from which the Map Run was started.

mapRunListItem_mapRunArn :: Lens' MapRunListItem Text Source #

The Amazon Resource Name (ARN) of the Map Run.

mapRunListItem_stateMachineArn :: Lens' MapRunListItem Text Source #

The Amazon Resource Name (ARN) of the executed state machine.

mapRunListItem_startDate :: Lens' MapRunListItem UTCTime Source #

The date on which the Map Run started.

MapRunStartedEventDetails

mapRunStartedEventDetails_mapRunArn :: Lens' MapRunStartedEventDetails (Maybe Text) Source #

The Amazon Resource Name (ARN) of a Map Run that was started.

MapStateStartedEventDetails

mapStateStartedEventDetails_length :: Lens' MapStateStartedEventDetails (Maybe Natural) Source #

The size of the array for Map state iterations.

StateEnteredEventDetails

stateEnteredEventDetails_input :: Lens' StateEnteredEventDetails (Maybe Text) Source #

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.

stateEnteredEventDetails_inputDetails :: Lens' StateEnteredEventDetails (Maybe HistoryEventExecutionDataDetails) Source #

Contains details about the input for an execution history event.

StateExitedEventDetails

stateExitedEventDetails_output :: Lens' StateExitedEventDetails (Maybe Text) Source #

The JSON output data of the state. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

stateExitedEventDetails_outputDetails :: Lens' StateExitedEventDetails (Maybe HistoryEventExecutionDataDetails) Source #

Contains details about the output of an execution history event.

stateExitedEventDetails_name :: Lens' StateExitedEventDetails Text Source #

The name of the state.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

StateMachineListItem

stateMachineListItem_stateMachineArn :: Lens' StateMachineListItem Text Source #

The Amazon Resource Name (ARN) that identifies the state machine.

stateMachineListItem_name :: Lens' StateMachineListItem Text Source #

The name of the state machine.

A name must not contain:

  • white space
  • brackets < > { } [ ]
  • wildcard characters ? *
  • special characters " # % \ ^ | ~ ` $ & , ; : /
  • control characters (U+0000-001F, U+007F-009F)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

Tag

tag_key :: Lens' Tag (Maybe Text) Source #

The key of a tag.

tag_value :: Lens' Tag (Maybe Text) Source #

The value of a tag.

TaskCredentials

taskCredentials_roleArn :: Lens' TaskCredentials (Maybe Text) Source #

The ARN of an IAM role that Step Functions assumes for the task. The role can allow cross-account access to resources.

TaskFailedEventDetails

taskFailedEventDetails_cause :: Lens' TaskFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

taskFailedEventDetails_resourceType :: Lens' TaskFailedEventDetails Text Source #

The service name of the resource in a task state.

taskFailedEventDetails_resource :: Lens' TaskFailedEventDetails Text Source #

The action of the resource called by a task state.

TaskScheduledEventDetails

taskScheduledEventDetails_heartbeatInSeconds :: Lens' TaskScheduledEventDetails (Maybe Integer) Source #

The maximum allowed duration between two heartbeats for the task.

taskScheduledEventDetails_resourceType :: Lens' TaskScheduledEventDetails Text Source #

The service name of the resource in a task state.

taskScheduledEventDetails_resource :: Lens' TaskScheduledEventDetails Text Source #

The action of the resource called by a task state.

taskScheduledEventDetails_parameters :: Lens' TaskScheduledEventDetails Text Source #

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.

TaskStartFailedEventDetails

taskStartFailedEventDetails_cause :: Lens' TaskStartFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

taskStartFailedEventDetails_resourceType :: Lens' TaskStartFailedEventDetails Text Source #

The service name of the resource in a task state.

taskStartFailedEventDetails_resource :: Lens' TaskStartFailedEventDetails Text Source #

The action of the resource called by a task state.

TaskStartedEventDetails

taskStartedEventDetails_resourceType :: Lens' TaskStartedEventDetails Text Source #

The service name of the resource in a task state.

taskStartedEventDetails_resource :: Lens' TaskStartedEventDetails Text Source #

The action of the resource called by a task state.

TaskSubmitFailedEventDetails

taskSubmitFailedEventDetails_cause :: Lens' TaskSubmitFailedEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

taskSubmitFailedEventDetails_resourceType :: Lens' TaskSubmitFailedEventDetails Text Source #

The service name of the resource in a task state.

taskSubmitFailedEventDetails_resource :: Lens' TaskSubmitFailedEventDetails Text Source #

The action of the resource called by a task state.

TaskSubmittedEventDetails

taskSubmittedEventDetails_output :: Lens' TaskSubmittedEventDetails (Maybe Text) Source #

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.

taskSubmittedEventDetails_resourceType :: Lens' TaskSubmittedEventDetails Text Source #

The service name of the resource in a task state.

taskSubmittedEventDetails_resource :: Lens' TaskSubmittedEventDetails Text Source #

The action of the resource called by a task state.

TaskSucceededEventDetails

taskSucceededEventDetails_output :: Lens' TaskSucceededEventDetails (Maybe Text) Source #

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.

taskSucceededEventDetails_resourceType :: Lens' TaskSucceededEventDetails Text Source #

The service name of the resource in a task state.

taskSucceededEventDetails_resource :: Lens' TaskSucceededEventDetails Text Source #

The action of the resource called by a task state.

TaskTimedOutEventDetails

taskTimedOutEventDetails_cause :: Lens' TaskTimedOutEventDetails (Maybe Text) Source #

A more detailed explanation of the cause of the failure.

taskTimedOutEventDetails_resourceType :: Lens' TaskTimedOutEventDetails Text Source #

The service name of the resource in a task state.

taskTimedOutEventDetails_resource :: Lens' TaskTimedOutEventDetails Text Source #

The action of the resource called by a task state.

TracingConfiguration

tracingConfiguration_enabled :: Lens' TracingConfiguration (Maybe Bool) Source #

When set to true, X-Ray tracing is enabled.