AWS Native is in preview. AWS Classic is fully supported.
aws-native.stepfunctions.getStateMachine
Explore with Pulumi AI
AWS Native is in preview. AWS Classic is fully supported.
Resource schema for StateMachine
Using getStateMachine
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getStateMachine(args: GetStateMachineArgs, opts?: InvokeOptions): Promise<GetStateMachineResult>
function getStateMachineOutput(args: GetStateMachineOutputArgs, opts?: InvokeOptions): Output<GetStateMachineResult>
def get_state_machine(arn: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetStateMachineResult
def get_state_machine_output(arn: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetStateMachineResult]
func LookupStateMachine(ctx *Context, args *LookupStateMachineArgs, opts ...InvokeOption) (*LookupStateMachineResult, error)
func LookupStateMachineOutput(ctx *Context, args *LookupStateMachineOutputArgs, opts ...InvokeOption) LookupStateMachineResultOutput
> Note: This function is named LookupStateMachine
in the Go SDK.
public static class GetStateMachine
{
public static Task<GetStateMachineResult> InvokeAsync(GetStateMachineArgs args, InvokeOptions? opts = null)
public static Output<GetStateMachineResult> Invoke(GetStateMachineInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetStateMachineResult> getStateMachine(GetStateMachineArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:stepfunctions:getStateMachine
arguments:
# arguments dictionary
The following arguments are supported:
- Arn string
- Returns the ARN of the resource.
- Arn string
- Returns the ARN of the resource.
- arn String
- Returns the ARN of the resource.
- arn string
- Returns the ARN of the resource.
- arn str
- Returns the ARN of the resource.
- arn String
- Returns the ARN of the resource.
getStateMachine Result
The following output properties are available:
- Arn string
- Returns the ARN of the resource.
- Definition
String string - The Amazon States Language definition of the state machine. The state machine definition must be in JSON. See Amazon States Language .
- Logging
Configuration Pulumi.Aws Native. Step Functions. Outputs. State Machine Logging Configuration 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.- Name string
Returns the name of the state machine. For example:
{ "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 .- Role
Arn string - The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
- State
Machine stringRevision Id - Identifier for a state machine revision, which is an immutable, read-only snapshot of a state machine’s definition and configuration.
- List<Pulumi.
Aws Native. Outputs. Tag> The list of tags to add to a resource.
Tags may only contain Unicode letters, digits, white space, or these symbols:
_ . : / = + - @
.- Tracing
Configuration Pulumi.Aws Native. Step Functions. Outputs. State Machine Tracing Configuration - Selects whether or not the state machine's AWS X-Ray tracing is enabled.
- Arn string
- Returns the ARN of the resource.
- Definition
String string - The Amazon States Language definition of the state machine. The state machine definition must be in JSON. See Amazon States Language .
- Logging
Configuration StateMachine Logging Configuration 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.- Name string
Returns the name of the state machine. For example:
{ "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 .- Role
Arn string - The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
- State
Machine stringRevision Id - Identifier for a state machine revision, which is an immutable, read-only snapshot of a state machine’s definition and configuration.
- Tag
The list of tags to add to a resource.
Tags may only contain Unicode letters, digits, white space, or these symbols:
_ . : / = + - @
.- Tracing
Configuration StateMachine Tracing Configuration - Selects whether or not the state machine's AWS X-Ray tracing is enabled.
- arn String
- Returns the ARN of the resource.
- definition
String String - The Amazon States Language definition of the state machine. The state machine definition must be in JSON. See Amazon States Language .
- logging
Configuration StateMachine Logging Configuration 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.- name String
Returns the name of the state machine. For example:
{ "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 .- role
Arn String - The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
- state
Machine StringRevision Id - Identifier for a state machine revision, which is an immutable, read-only snapshot of a state machine’s definition and configuration.
- List<Tag>
The list of tags to add to a resource.
Tags may only contain Unicode letters, digits, white space, or these symbols:
_ . : / = + - @
.- tracing
Configuration StateMachine Tracing Configuration - Selects whether or not the state machine's AWS X-Ray tracing is enabled.
- arn string
- Returns the ARN of the resource.
- definition
String string - The Amazon States Language definition of the state machine. The state machine definition must be in JSON. See Amazon States Language .
- logging
Configuration StateMachine Logging Configuration 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.- name string
Returns the name of the state machine. For example:
{ "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 .- role
Arn string - The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
- state
Machine stringRevision Id - Identifier for a state machine revision, which is an immutable, read-only snapshot of a state machine’s definition and configuration.
- Tag[]
The list of tags to add to a resource.
Tags may only contain Unicode letters, digits, white space, or these symbols:
_ . : / = + - @
.- tracing
Configuration StateMachine Tracing Configuration - Selects whether or not the state machine's AWS X-Ray tracing is enabled.
- arn str
- Returns the ARN of the resource.
- definition_
string str - The Amazon States Language definition of the state machine. The state machine definition must be in JSON. See Amazon States Language .
- logging_
configuration StateMachine Logging Configuration 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.- name str
Returns the name of the state machine. For example:
{ "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 .- role_
arn str - The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
- state_
machine_ strrevision_ id - Identifier for a state machine revision, which is an immutable, read-only snapshot of a state machine’s definition and configuration.
- Sequence[root_Tag]
The list of tags to add to a resource.
Tags may only contain Unicode letters, digits, white space, or these symbols:
_ . : / = + - @
.- tracing_
configuration StateMachine Tracing Configuration - Selects whether or not the state machine's AWS X-Ray tracing is enabled.
- arn String
- Returns the ARN of the resource.
- definition
String String - The Amazon States Language definition of the state machine. The state machine definition must be in JSON. See Amazon States Language .
- logging
Configuration Property 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.- name String
Returns the name of the state machine. For example:
{ "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 .- role
Arn String - The Amazon Resource Name (ARN) of the IAM role to use for this state machine.
- state
Machine StringRevision Id - Identifier for a state machine revision, which is an immutable, read-only snapshot of a state machine’s definition and configuration.
- List<Property Map>
The list of tags to add to a resource.
Tags may only contain Unicode letters, digits, white space, or these symbols:
_ . : / = + - @
.- tracing
Configuration Property Map - Selects whether or not the state machine's AWS X-Ray tracing is enabled.
Supporting Types
StateMachineCloudWatchLogsLogGroup
- Log
Group stringArn - The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with
:*
- Log
Group stringArn - The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with
:*
- log
Group StringArn - The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with
:*
- log
Group stringArn - The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with
:*
- log_
group_ strarn - The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with
:*
- log
Group StringArn - The ARN of the the CloudWatch log group to which you want your logs emitted to. The ARN must end with
:*
StateMachineLogDestination
- Cloud
Watch Pulumi.Logs Log Group Aws Native. Step Functions. Inputs. State Machine Cloud Watch Logs Log Group - An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
- Cloud
Watch StateLogs Log Group Machine Cloud Watch Logs Log Group - An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
- cloud
Watch StateLogs Log Group Machine Cloud Watch Logs Log Group - An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
- cloud
Watch StateLogs Log Group Machine Cloud Watch Logs Log Group - An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
- cloud_
watch_ Statelogs_ log_ group Machine Cloud Watch Logs Log Group - An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
- cloud
Watch Property MapLogs Log Group - An object describing a CloudWatch log group. For more information, see AWS::Logs::LogGroup in the AWS CloudFormation User Guide.
StateMachineLoggingConfiguration
- Destinations
List<Pulumi.
Aws Native. Step Functions. Inputs. State Machine Log Destination> - 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 boolData - Determines whether execution data is included in your log. When set to
false
, data is excluded. - Level
Pulumi.
Aws Native. Step Functions. State Machine Logging Configuration Level - Defines which category of execution history events are logged.
- Destinations
[]State
Machine Log Destination - 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 boolData - Determines whether execution data is included in your log. When set to
false
, data is excluded. - Level
State
Machine Logging Configuration Level - Defines which category of execution history events are logged.
- destinations
List<State
Machine Log Destination> - 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 BooleanData - Determines whether execution data is included in your log. When set to
false
, data is excluded. - level
State
Machine Logging Configuration Level - Defines which category of execution history events are logged.
- destinations
State
Machine Log Destination[] - 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 booleanData - Determines whether execution data is included in your log. When set to
false
, data is excluded. - level
State
Machine Logging Configuration Level - Defines which category of execution history events are logged.
- destinations
Sequence[State
Machine Log Destination] - 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_ booldata - Determines whether execution data is included in your log. When set to
false
, data is excluded. - level
State
Machine Logging Configuration Level - Defines which category of execution history events are logged.
- destinations List<Property Map>
- 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 BooleanData - Determines whether execution data is included in your log. When set to
false
, data is excluded. - level "ALL" | "ERROR" | "FATAL" | "OFF"
- Defines which category of execution history events are logged.
StateMachineLoggingConfigurationLevel
StateMachineTracingConfiguration
- Enabled bool
- When set to
true
, X-Ray tracing is enabled.
- Enabled bool
- When set to
true
, X-Ray tracing is enabled.
- enabled Boolean
- When set to
true
, X-Ray tracing is enabled.
- enabled boolean
- When set to
true
, X-Ray tracing is enabled.
- enabled bool
- When set to
true
, X-Ray tracing is enabled.
- enabled Boolean
- When set to
true
, X-Ray tracing is enabled.
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
AWS Native is in preview. AWS Classic is fully supported.