Using the AWS Step Functions State Machine task in Bamboo

You can use the AWS Step Functions State Machine task to create or delete an AWS Step Functions state machine and start or stop a state machine execution.

On this page:

1 Configuration
- 1.1 Create State Machine
- 1.2 Update State Machine
- 1.3 Delete State Machine
- 1.4 Start Execution
- 1.5 Start Synchronous Execution
- 1.6 Stop Execution
2 Variables
- 2.1 Create State Machine
- 2.2 Update State Machine
- 2.3 Delete State Machine
- 2.4 Start Execution
- 2.5 Start Synchronous Execution
- 2.6 Stop Execution
3 How-to Articles
4 Frequently Asked Questions (FAQ)

Related Pages:

Configuration

To configure an AWS Step Functions State Machine task:

1 . Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).

2. Click the name of an existing AWS Step Functions State Machine task, or click Add Task and then AWS Step Functions State Machine to create a new task.

3. Complete the following settings:

a. Common to all tasks

b. Actions supported by this task:

Create State Machine

Create State Machine
Name	Specify the state machine name.
Type	Select the type of this state machine.
Role ARN	Specify the Amazon Resource Name (ARN) of the IAM role to use for this state machine.
Definition	Specify the Amazon States Language definition of the state machine. Refer to Amazon States Language for details, and to Sample Projects for Step Functions for more complex examples. Reserved JSON characters in Bamboo variable content need to be escaped at runtime!
Logging Configuration	Specify the logging configuration of the state machine. Refer to Logging Express Workflows Using CloudWatch Logs for details. Reserved JSON characters in Bamboo variable content need to be escaped at runtime!
Update State Machine
State Machine ARN	Specify the Amazon Resource Name (ARN) of the state machine.
Role ARN	see Create State Machine above
Definition	see Create State Machine above
Logging Configuration	see Create State Machine above
Delete State Machine
State Machine ARN	see Update State Machine above
Start Execution
State Machine ARN	see Update State Machine above
Name	(Optional) Specify a name for the execution.
Input	(Optional) Specify the JSON input data for the execution.
Await Execution Result Timeout	Specify how long to await the execution to return a result (seconds, 0 to skip).
Start Synchronous Execution
State Machine ARN	see Update State Machine above
Name	(Optional) Specify a name for the execution.
Input	(Optional) Specify the JSON input data for the execution.
Stop Execution
Execution ARN	Specify the Amazon Resource Name (ARN) of the execution.
Error	(Optional) Specify an arbitrary error code that identifies the cause of the termination.
Cause	(Optional) Specify a more detailed explanation of the cause of the termination.

Variables

Create State Machine

Creating common variables for 1 resources affected by task:
... bamboo.custom.aws.stepfunctions.statemachine.resources: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-1-ubot
Creating resource variables for state machine 'arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-1-ubot':
... bamboo.custom.aws.stepfunctions.statemachine.resources.arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-1-ubot.StateMachineArn: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-1-ubot
... bamboo.custom.aws.stepfunctions.statemachine.resources.arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-1-ubot.CreationDate: 20170216T142255Z
Creating common variables for first resource affected by task:
Creating resource variables for state machine 'arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-1-ubot':
... bamboo.custom.aws.stepfunctions.statemachine.first.StateMachineArn: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-1-ubot
... bamboo.custom.aws.stepfunctions.statemachine.first.CreationDate: 20170216T142255Z

Update State Machine

Creating common variables for 1 resources affected by task:
... bamboo.custom.aws.stepfunctions.statemachine.resources: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-16-ubot
Creating resource variables for state machine 'arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-16-ubot':
... bamboo.custom.aws.stepfunctions.statemachine.resources.arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-16-ubot.StateMachineArn: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-16-ubot
... bamboo.custom.aws.stepfunctions.statemachine.resources.arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-16-ubot.UpdateDate: 20180905T114350Z
Creating common variables for first resource affected by task:
Creating resource variables for state machine 'arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-16-ubot':
... bamboo.custom.aws.stepfunctions.statemachine.first.StateMachineArn: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-16-ubot
... bamboo.custom.aws.stepfunctions.statemachine.first.UpdateDate: 20180905T114350Z

Delete State Machine

N/A

Start Execution

Creating common variables for 1 resources affected by task:
... bamboo.custom.aws.stepfunctions.execution.resources: arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2 (LOCAL)
Creating resource variables for execution 'arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2':
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.ExecutionArn: arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2 (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.Input: {} (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.Name: TAWS-IT2120-SFCSSD-33-execution-2 (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.Output: null (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.StateMachineArn: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-33-ubot-standard (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.Status: RUNNING (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.StartDate: 20210816T195505Z (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.StopDate: null (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.resources.arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2.TraceHeader: null (LOCAL)
Creating common variables for first resource affected by task:
Creating resource variables for execution 'arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2':
... bamboo.custom.aws.stepfunctions.execution.first.ExecutionArn: arn:aws:states:us-east-1:288727192237:execution:taws-it280-33-ubot-standard:TAWS-IT2120-SFCSSD-33-execution-2 (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.Input: {} (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.Name: TAWS-IT2120-SFCSSD-33-execution-2 (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.Output: null (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.StateMachineArn: arn:aws:states:us-east-1:288727192237:stateMachine:taws-it280-33-ubot-standard (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.Status: RUNNING (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.StartDate: 20210816T195505Z (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.StopDate: null (LOCAL)
... bamboo.custom.aws.stepfunctions.execution.first.TraceHeader: null (LOCAL)

Start Synchronous Execution

Stop Execution

See Start above.

How-to Articles

Page:
How to provide temporary AWS credentials to the AWS Command Line Interface (AWS CLI) via Bamboo variables

Frequently Asked Questions (FAQ)