Bases: CfnResource
A CloudFormation AWS::StepFunctions::StateMachine
.
Provisions 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.
AWS::StepFunctions::StateMachine
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_stepfunctions as stepfunctions
# definition: Any
# definition_substitutions: Any
cfn_state_machine = stepfunctions.CfnStateMachine(self, "MyCfnStateMachine",
role_arn="roleArn",
# the properties below are optional
definition=definition,
definition_s3_location=stepfunctions.CfnStateMachine.S3LocationProperty(
bucket="bucket",
key="key",
# the properties below are optional
version="version"
),
definition_string="definitionString",
definition_substitutions={
"definition_substitutions_key": definition_substitutions
},
logging_configuration=stepfunctions.CfnStateMachine.LoggingConfigurationProperty(
destinations=[stepfunctions.CfnStateMachine.LogDestinationProperty(
cloud_watch_logs_log_group=stepfunctions.CfnStateMachine.CloudWatchLogsLogGroupProperty(
log_group_arn="logGroupArn"
)
)],
include_execution_data=False,
level="level"
),
state_machine_name="stateMachineName",
state_machine_type="stateMachineType",
tags=[stepfunctions.CfnStateMachine.TagsEntryProperty(
key="key",
value="value"
)],
tracing_configuration=stepfunctions.CfnStateMachine.TracingConfigurationProperty(
enabled=False
)
)
Create a new AWS::StepFunctions::StateMachine
.
scope (Construct
) –
scope in which this resource is defined.
id (str
) –
scoped id of the resource.
role_arn (str
) – The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
definition (Optional
[Any
]) – 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 AWS Step Functions template file. See Amazon States Language .
definition_s3_location (Union
[IResolvable
, S3LocationProperty
, Dict
[str
, Any
], None
]) – The name of the S3 bucket where the state machine definition is stored. The state machine definition must be a JSON or YAML file.
definition_string (Optional
[str
]) –
The Amazon States Language definition of the state machine. The state machine definition must be in JSON. See Amazon States Language .
definition_substitutions (Union
[IResolvable
, Mapping
[str
, Any
], None
]) – 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.
logging_configuration (Union
[IResolvable
, LoggingConfigurationProperty
, Dict
[str
, Any
], None
]) – Defines what execution history events are logged and where they are logged. .. epigraph:: By default, the level
is set to OFF
. For more information see Log Levels in the AWS Step Functions User Guide.
state_machine_name (Optional
[str
]) – 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
) .. epigraph:: 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.
state_machine_type (Optional
[str
]) – 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.
tags (Optional
[Sequence
[Union
[TagsEntryProperty
, Dict
[str
, Any
]]]]) – The list of tags to add to a resource. Tags may only contain Unicode letters, digits, white space, or these symbols: _ . : / = + - @
.
tracing_configuration (Union
[IResolvable
, TracingConfigurationProperty
, Dict
[str
, Any
], None
]) – Selects whether or not the state machine’s AWS X-Ray tracing is enabled.
Methods
Syntactic sugar for addOverride(path, undefined)
.
path (str
) – The path of the value to delete.
None
Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
This can be used for resources across stacks (or nested stack) boundaries and the dependency will automatically be transferred to the relevant scope.
target (CfnResource
)
None
Add a value to the CloudFormation Resource Metadata.
key (str
)
value (Any
)
None
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html
Note that this is a different set of metadata from CDK node metadata; this metadata ends up in the stack template under the resource, whereas CDK node metadata ends up in the Cloud Assembly.
Adds an override to the synthesized CloudFormation resource.
To add a
property override, either use addPropertyOverride
or prefix path
with
“Properties.” (i.e. Properties.TopicName
).
If the override is nested, separate each nested level using a dot (.) in the path parameter. If there is an array as part of the nesting, specify the index in the path.
To include a literal .
in the property name, prefix with a \
. In most
programming languages you will need to write this as "\\."
because the
\
itself will need to be escaped.
For example:
cfn_resource.add_override("Properties.GlobalSecondaryIndexes.0.Projection.NonKeyAttributes", ["myattribute"])
cfn_resource.add_override("Properties.GlobalSecondaryIndexes.1.ProjectionType", "INCLUDE")
would add the overrides Example:
"Properties": {
"GlobalSecondaryIndexes": [
{
"Projection": {
"NonKeyAttributes": [ "myattribute" ]
...
}
...
},
{
"ProjectionType": "INCLUDE"
...
},
]
...
}
The value
argument to addOverride
will not be processed or translated
in any way. Pass raw JSON values in here with the correct capitalization
for CloudFormation. If you pass CDK classes or structs, they will be
rendered with lowercased key names, and CloudFormation will reject the
template.
path (str
) –
The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
value (Any
) –
The value. Could be primitive or complex.
None
Adds an override that deletes the value of a property from the resource definition.
property_path (str
) – The path to the property.
None
Adds an override to a resource property.
Syntactic sugar for addOverride("Properties.<...>", value)
.
property_path (str
) – The path of the property.
value (Any
) – The value.
None
Sets the deletion policy of the resource based on the removal policy specified.
The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you’ve removed it from the CDK application or because you’ve made a change that requires the resource to be replaced.
The resource can be deleted (RemovalPolicy.DESTROY
), or left in your AWS
account for data recovery and cleanup later (RemovalPolicy.RETAIN
).
policy (Optional
[RemovalPolicy
])
apply_to_update_replace_policy (Optional
[bool
]) – Apply the same deletion policy to the resource’s “UpdateReplacePolicy”. Default: true
default (Optional
[RemovalPolicy
]) – The default policy to apply in case the removal policy is not defined. Default: - Default value is resource specific. To determine the default value for a resoure, please consult that specific resource’s documentation.
None
Returns a token for an runtime attribute of this resource.
Ideally, use generated attribute accessors (e.g. resource.arn
), but this can be used for future compatibility
in case there is no generated attribute.
attribute_name (str
) – The name of the attribute.
Retrieve a value value from the CloudFormation Resource Metadata.
key (str
)
Any
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html
Note that this is a different set of metadata from CDK node metadata; this metadata ends up in the stack template under the resource, whereas CDK node metadata ends up in the Cloud Assembly.
Examines the CloudFormation resource and discloses attributes.
inspector (TreeInspector
) –
tree inspector to collect and process attributes.
None
Overrides the auto-generated logical ID with a specific ID.
new_logical_id (str
) – The new logical ID to use for this stack element.
None
Returns a string representation of this construct.
str
a string representation of this resource
Attributes
Arn
cloudformationAttribute
.
{ "Fn::GetAtt": ["MyStateMachine", "Name"] }
Returns the name of your state machine:
HelloWorld-StateMachine
If you did not specify the name it will be similar to the following:
MyStateMachine-1234abcdefgh
For more information about using Fn::GetAtt
, see Fn::GetAtt .
Name
Returns the name of the state machine. For example
StateMachineRevisionId
cloudformationAttribute
Options for this resource, such as condition, update policy etc.
AWS resource type.
return:
the stack trace of the point where this Resource was created from, sourced from the +metadata+ entry typed +aws:cdk:logicalId+, and with the bottom-most node +internal+ entries filtered.
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 AWS Step Functions template file. See Amazon States Language .
The name of the S3 bucket where the state machine definition is stored.
The state machine definition must be a JSON or YAML file.
The Amazon States Language definition of the state machine.
The state machine definition must be in JSON. See Amazon States Language .
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.
Defines what execution history events are logged and where they are logged.
By default, the
level
is set toOFF
. For more information see Log Levels in the AWS Step Functions User Guide.
The logical ID for this CloudFormation stack element.
The logical ID of the element is calculated from the path of the resource node in the construct tree.
To override this value, use overrideLogicalId(newLogicalId)
.
the logical ID as a stringified token. This value will only get resolved during synthesis.
The construct tree node associated with this construct.
Return a string that will be resolved to a CloudFormation { Ref }
for this element.
If, by any chance, the intrinsic reference of a resource is not a string, you could
coerce it to an IResolvable through Lazy.any({ produce: resource.ref })
.
The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
The stack in which this element is defined.
CfnElements must be defined within a stack scope (directly or indirectly).
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.
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.
The list of tags to add to a resource.
Tags may only contain Unicode letters, digits, white space, or these symbols: _ . : / = + - @
.
Selects whether or not the state machine’s AWS X-Ray tracing is enabled.
Static Methods
Returns true
if a construct is a stack element (i.e. part of the synthesized cloudformation template).
Uses duck-typing instead of instanceof
to allow stack elements from different
versions of this library to be included in the same stack.
x (Any
)
bool
The construct as a stack element or undefined if it is not a stack element.
Check whether the given construct is a CfnResource.
construct (IConstruct
)
bool
Return whether the given object is a Construct.
x (Any
)
bool
Bases: object
Defines a CloudWatch log group.
For more information see Standard Versus Express Workflows in the AWS Step Functions Developer Guide.
log_group_arn (Optional
[str
]) – The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with :*
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_stepfunctions as stepfunctions
cloud_watch_logs_log_group_property = stepfunctions.CfnStateMachine.CloudWatchLogsLogGroupProperty(
log_group_arn="logGroupArn"
)
Attributes
The ARN of the the CloudWatch log group to which you want your logs emitted to.
The ARN must end with :*
Bases: object
Defines a destination for LoggingConfiguration
.
For more information on logging with
EXPRESS
workflows, see Logging Express Workflows Using CloudWatch Logs .
cloud_watch_logs_log_group (Union
[IResolvable
, CloudWatchLogsLogGroupProperty
, Dict
[str
, Any
], None
]) – An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_stepfunctions as stepfunctions
log_destination_property = stepfunctions.CfnStateMachine.LogDestinationProperty(
cloud_watch_logs_log_group=stepfunctions.CfnStateMachine.CloudWatchLogsLogGroupProperty(
log_group_arn="logGroupArn"
)
)
Attributes
An object describing a CloudWatch log group.
For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
Bases: object
Defines what execution history events are logged and where they are logged.
By default, the
level
is set toOFF
. For more information see Log Levels in the AWS Step Functions User Guide.
destinations (Union
[IResolvable
, Sequence
[Union
[IResolvable
, LogDestinationProperty
, Dict
[str
, Any
]]], None
]) – 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
.
include_execution_data (Union
[bool
, IResolvable
, None
]) – Determines whether execution data is included in your log. When set to false
, data is excluded.
level (Optional
[str
]) – Defines which category of execution history events are logged.
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_stepfunctions as stepfunctions
logging_configuration_property = stepfunctions.CfnStateMachine.LoggingConfigurationProperty(
destinations=[stepfunctions.CfnStateMachine.LogDestinationProperty(
cloud_watch_logs_log_group=stepfunctions.CfnStateMachine.CloudWatchLogsLogGroupProperty(
log_group_arn="logGroupArn"
)
)],
include_execution_data=False,
level="level"
)
Attributes
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
.
Determines whether execution data is included in your log.
When set to false
, data is excluded.
Defines which category of execution history events are logged.
Bases: object
Defines the S3 bucket location where a state machine definition is stored.
The state machine definition must be a JSON or YAML file.
bucket (str
) – The name of the S3 bucket where the state machine definition JSON or YAML file is stored.
key (str
) – The name of the state machine definition file (Amazon S3 object name).
version (Optional
[str
]) – For versioning-enabled buckets, a specific version of the state machine definition.
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_stepfunctions as stepfunctions
s3_location_property = stepfunctions.CfnStateMachine.S3LocationProperty(
bucket="bucket",
key="key",
# the properties below are optional
version="version"
)
Attributes
The name of the S3 bucket where the state machine definition JSON or YAML file is stored.
The name of the state machine definition file (Amazon S3 object name).
For versioning-enabled buckets, a specific version of the state machine definition.
Bases: object
Selects whether or not the state machine’s AWS X-Ray tracing is enabled.
To configure your state machine to send trace data to X-Ray, set Enabled
to true
.
enabled (Union
[bool
, IResolvable
, None
]) – When set to true
, X-Ray tracing is enabled.
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_stepfunctions as stepfunctions
tracing_configuration_property = stepfunctions.CfnStateMachine.TracingConfigurationProperty(
enabled=False
)
Attributes
When set to true
, X-Ray tracing is enabled.