Package software.amazon.awscdk.cfnpropertymixins.services.stepfunctions

Interface CfnStateMachineMixinProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnStateMachineMixinProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.127.0 (build 2117ad5)",
           date="2026-03-11T13:20:05.783Z")
@Stability(Stable)
public interface CfnStateMachineMixinProps
extends software.amazon.jsii.JsiiSerializable

Properties for CfnStateMachinePropsMixin.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.cfnpropertymixins.services.stepfunctions.*;
 Object definition;
 CfnStateMachineMixinProps cfnStateMachineMixinProps = CfnStateMachineMixinProps.builder()
         .definition(definition)
         .definitionS3Location(S3LocationProperty.builder()
                 .bucket("bucket")
                 .key("key")
                 .version("version")
                 .build())
         .definitionString("definitionString")
         .definitionSubstitutions(Map.of(
                 "definitionSubstitutionsKey", "definitionSubstitutions"))
         .encryptionConfiguration(EncryptionConfigurationProperty.builder()
                 .kmsDataKeyReusePeriodSeconds(123)
                 .kmsKeyId("kmsKeyId")
                 .type("type")
                 .build())
         .loggingConfiguration(LoggingConfigurationProperty.builder()
                 .destinations(List.of(LogDestinationProperty.builder()
                         .cloudWatchLogsLogGroup(CloudWatchLogsLogGroupProperty.builder()
                                 .logGroupArn("logGroupArn")
                                 .build())
                         .build()))
                 .includeExecutionData(false)
                 .level("level")
                 .build())
         .roleArn("roleArn")
         .stateMachineName("stateMachineName")
         .stateMachineType("stateMachineType")
         .tags(List.of(TagsEntryProperty.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .tracingConfiguration(TracingConfigurationProperty.builder()
                 .enabled(false)
                 .build())
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnStateMachineMixinProps.Builder	A builder for CfnStateMachineMixinProps
static final class	CfnStateMachineMixinProps.Jsii$Proxy	An implementation for CfnStateMachineMixinProps

Method Summary

Modifier and Type	Method	Description
static CfnStateMachineMixinProps.Builder	builder()
default Object	getDefinition()	The Amazon States Language definition of the state machine.
default Object	getDefinitionS3Location()	The name of the S3 bucket where the state machine definition is stored.
default Object	getDefinitionString()	The Amazon States Language definition of the state machine.
default Object	getDefinitionSubstitutions()	A map (string to string) that specifies the mappings for placeholder variables in the state machine definition.
default Object	getEncryptionConfiguration()	Encryption configuration for the state machine.
default Object	getLoggingConfiguration()	Defines what execution history events are logged and where they are logged.
default Object	getRoleArn()	The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
default String	getStateMachineName()	The name of the state machine.
default String	getStateMachineType()	Determines whether a STANDARD or EXPRESS state machine is created.
default List<CfnStateMachinePropsMixin.TagsEntryProperty>	getTags()	The list of tags to add to a resource.
default Object	getTracingConfiguration()	Selects whether or not the state machine's AWS X-Ray tracing is enabled.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getDefinition

@Stability(Stable)
@Nullable
default Object getDefinition()

The Amazon States Language definition of the state machine.

The state machine definition must be in JSON or YAML, and the format of the object must match the format of your CloudFormation template file. See Amazon States Language .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definition

getDefinitionS3Location

@Stability(Stable)
@Nullable
default Object getDefinitionS3Location()

The name of the S3 bucket where the state machine definition is stored.

The state machine definition must be a JSON or YAML file.

Returns union: either IResolvable or CfnStateMachinePropsMixin.S3LocationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definitions3location

getDefinitionString

@Stability(Stable)
@Nullable
default Object getDefinitionString()

The Amazon States Language definition of the state machine.

The state machine definition must be in JSON. See Amazon States Language .

Returns union: either String or ITableRef or ITaskDefinitionRef or IFunctionRef or IVersionRef or ITopicRef or IQueueRef

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definitionstring

getDefinitionSubstitutions

@Stability(Stable)
@Nullable
default Object getDefinitionSubstitutions()

A map (string to string) that specifies the mappings for placeholder variables in the state machine definition.

This enables the customer to inject values obtained at runtime, for example from intrinsic functions, in the state machine definition. Variables can be template parameter names, resource logical IDs, resource attributes, or a variable in a key-value map.

Substitutions must follow the syntax: ${key_name} or ${variable_1,variable_2,...} .

Returns union: either Mapinvalid input: '<'String, String> or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-definitionsubstitutions

getEncryptionConfiguration

@Stability(Stable)
@Nullable
default Object getEncryptionConfiguration()

Encryption configuration for the state machine.

Returns union: either IResolvable or CfnStateMachinePropsMixin.EncryptionConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-encryptionconfiguration

getLoggingConfiguration

@Stability(Stable)
@Nullable
default Object getLoggingConfiguration()

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 AWS Step Functions User Guide.

Returns union: either IResolvable or CfnStateMachinePropsMixin.LoggingConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-loggingconfiguration

getRoleArn

@Stability(Stable)
@Nullable
default Object getRoleArn()

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

Returns union: either String or IRoleRef

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-rolearn

getStateMachineName

@Stability(Stable)
@Nullable
default String getStateMachineName()

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 )

If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-statemachinename

getStateMachineType

@Stability(Stable)
@Nullable
default String getStateMachineType()

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. For more information on STANDARD and EXPRESS workflows, see Standard Versus Express Workflows in the AWS Step Functions Developer Guide.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-statemachinetype

getTags

@Stability(Stable)
@Nullable
default List<CfnStateMachinePropsMixin.TagsEntryProperty> getTags()

The list of tags to add to a resource.

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

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-tags

getTracingConfiguration

@Stability(Stable)
@Nullable
default Object getTracingConfiguration()

Selects whether or not the state machine's AWS X-Ray tracing is enabled.

Returns union: either IResolvable or CfnStateMachinePropsMixin.TracingConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html#cfn-stepfunctions-statemachine-tracingconfiguration

builder

@Stability(Stable)
static CfnStateMachineMixinProps.Builder builder()

Returns:

a CfnStateMachineMixinProps.Builder of CfnStateMachineMixinProps