AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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 .NET Core and PCL this operation is only available in asynchronous form. Please refer to CreateStateMachineAsync.

Namespace: Amazon.StepFunctions
Assembly: AWSSDK.StepFunctions.dll
Version: 3.x.y.z


public abstract CreateStateMachineResponse CreateStateMachine(
         CreateStateMachineRequest request
Type: Amazon.StepFunctions.Model.CreateStateMachineRequest

Container for the necessary parameters to execute the CreateStateMachine service method.

Return Value
The response from the CreateStateMachine service method, as returned by StepFunctions.


InvalidArnException The provided Amazon Resource Name (ARN) is invalid.
InvalidDefinitionException The provided Amazon States Language definition is invalid.
InvalidNameException The provided name is invalid.
StateMachineAlreadyExistsException A state machine with the same name but a different definition or role ARN already exists.
StateMachineDeletingException The specified state machine is being deleted.
StateMachineLimitExceededException The maximum number of state machines has been reached. Existing state machines must be deleted before a new state machine can be created.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also