There are more AWS SDK examples available in the [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub repo.
# Use `CreateStateMachine` with an AWS SDK
The following code examples show how to use `CreateStateMachine`.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in context in the following code examples:
+ [Learn the basics](sfn_example_sfn_Scenario_GetStartedStateMachines_section.md)
+ [Getting started with Step Functions](sfn_example_iam_GettingStarted_080_section.md)
------
#### [ .NET ]
**SDK for .NET**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/StepFunctions#code-examples).
```
///
/// Create a Step Functions state machine.
///
/// Name for the new Step Functions state
/// machine.
/// A JSON string that defines the Step Functions
/// state machine.
/// The Amazon Resource Name (ARN) of the role.
///
public async Task CreateStateMachine(string stateMachineName, string definition, string roleArn)
{
var request = new CreateStateMachineRequest
{
Name = stateMachineName,
Definition = definition,
RoleArn = roleArn
};
var response =
await _amazonStepFunctions.CreateStateMachineAsync(request);
return response.StateMachineArn;
}
```
+ For API details, see [CreateStateMachine](https://docs.aws.amazon.com/goto/DotNetSDKV3/states-2016-11-23/CreateStateMachine) in *AWS SDK for .NET API Reference*.
------
#### [ Java ]
**SDK for Java 2.x**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/stepfunctions#code-examples).
```
public static String createMachine(SfnClient sfnClient, String roleARN, String stateMachineName, String json) {
try {
CreateStateMachineRequest machineRequest = CreateStateMachineRequest.builder()
.definition(json)
.name(stateMachineName)
.roleArn(roleARN)
.type(StateMachineType.STANDARD)
.build();
CreateStateMachineResponse response = sfnClient.createStateMachine(machineRequest);
return response.stateMachineArn();
} catch (SfnException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return "";
}
```
+ For API details, see [CreateStateMachine](https://docs.aws.amazon.com/goto/SdkForJavaV2/states-2016-11-23/CreateStateMachine) in *AWS SDK for Java 2.x API Reference*.
------
#### [ Kotlin ]
**SDK for Kotlin**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/stepfunctions#code-examples).
```
suspend fun createMachine(
roleARNVal: String?,
stateMachineName: String?,
jsonVal: String?,
): String? {
val machineRequest =
CreateStateMachineRequest {
definition = jsonVal
name = stateMachineName
roleArn = roleARNVal
type = StateMachineType.Standard
}
SfnClient.fromEnvironment { region = "us-east-1" }.use { sfnClient ->
val response = sfnClient.createStateMachine(machineRequest)
return response.stateMachineArn
}
}
```
+ For API details, see [CreateStateMachine](https://sdk.amazonaws.com/kotlin/api/latest/index.html) in *AWS SDK for Kotlin API reference*.
------
#### [ Python ]
**SDK for Python (Boto3)**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/stepfunctions#code-examples).
```
class StateMachine:
"""Encapsulates Step Functions state machine actions."""
def __init__(self, stepfunctions_client):
"""
:param stepfunctions_client: A Boto3 Step Functions client.
"""
self.stepfunctions_client = stepfunctions_client
def create(self, name, definition, role_arn):
"""
Creates a state machine with the specific definition. The state machine assumes
the provided role before it starts a run.
:param name: The name to give the state machine.
:param definition: The Amazon States Language definition of the steps in the
the state machine.
:param role_arn: The Amazon Resource Name (ARN) of the role that is assumed by
Step Functions when the state machine is run.
:return: The ARN of the newly created state machine.
"""
try:
response = self.stepfunctions_client.create_state_machine(
name=name, definition=definition, roleArn=role_arn
)
except ClientError as err:
logger.error(
"Couldn't create state machine %s. Here's why: %s: %s",
name,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return response["stateMachineArn"]
```
+ For API details, see [CreateStateMachine](https://docs.aws.amazon.com/goto/boto3/states-2016-11-23/CreateStateMachine) in *AWS SDK for Python (Boto3) API Reference*.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/sfn#code-examples).
```
TRY.
DATA(lo_result) = lo_sfn->createstatemachine(
iv_name = iv_name
iv_definition = iv_definition
iv_rolearn = iv_role_arn
).
ov_state_machine_arn = lo_result->get_statemachinearn( ).
MESSAGE 'State machine created successfully.' TYPE 'I'.
CATCH /aws1/cx_sfnstatemachinealrex.
MESSAGE 'State machine already exists.' TYPE 'E'.
CATCH /aws1/cx_sfninvaliddefinition.
MESSAGE 'Invalid state machine definition.' TYPE 'E'.
CATCH /aws1/cx_sfninvalidname.
MESSAGE 'Invalid state machine name.' TYPE 'E'.
CATCH /aws1/cx_sfninvalidarn.
MESSAGE 'Invalid role ARN.' TYPE 'E'.
ENDTRY.
```
+ For API details, see [CreateStateMachine](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP API reference*.
------