Class: Aws::States::Types::StartExecutionInput

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-states/types.rb

Overview

Note:

When making an API call, you may pass StartExecutionInput data as a hash:

{
  state_machine_arn: "Arn", # required
  name: "Name",
  input: "SensitiveData",
  trace_header: "TraceHeader",
}

Constant Summary collapse

SENSITIVE =
[:input]

Instance Attribute Summary collapse

Instance Attribute Details

#inputString

The string that contains the JSON input data for the execution, for example:

‘“input”: “: ”test“”`

<note markdown=“1”> If you don’t include any JSON input data, you still must include the two braces, for example: ‘“input”: “{}”`

</note>

Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.

Returns:

  • (String)


2172
2173
2174
2175
2176
2177
2178
2179
# File 'lib/aws-sdk-states/types.rb', line 2172

class StartExecutionInput < Struct.new(
  :state_machine_arn,
  :name,
  :input,
  :trace_header)
  SENSITIVE = [:input]
  include Aws::Structure
end

#nameString

The name of the execution. This name must be unique for your AWS account, region, and state machine for 90 days. For more information, see [ Limits Related to State Machine Executions] in the *AWS Step Functions Developer Guide*.

A name must not contain:

  • white space

  • brackets ‘< > { } [ ]`

  • wildcard characters ‘? *`

  • special characters “ “ # % \ ^ | ~ ‘ $ & , ; : / “

  • control characters (‘U+0000-001F`, `U+007F-009F`)

To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

[1]: docs.aws.amazon.com/step-functions/latest/dg/limits.html#service-limits-state-machine-executions

Returns:

  • (String)


2172
2173
2174
2175
2176
2177
2178
2179
# File 'lib/aws-sdk-states/types.rb', line 2172

class StartExecutionInput < Struct.new(
  :state_machine_arn,
  :name,
  :input,
  :trace_header)
  SENSITIVE = [:input]
  include Aws::Structure
end

#state_machine_arnString

The Amazon Resource Name (ARN) of the state machine to execute.

Returns:

  • (String)


2172
2173
2174
2175
2176
2177
2178
2179
# File 'lib/aws-sdk-states/types.rb', line 2172

class StartExecutionInput < Struct.new(
  :state_machine_arn,
  :name,
  :input,
  :trace_header)
  SENSITIVE = [:input]
  include Aws::Structure
end

#trace_headerString

Passes the AWS X-Ray trace header. The trace header can also be passed in the request payload.

Returns:

  • (String)


2172
2173
2174
2175
2176
2177
2178
2179
# File 'lib/aws-sdk-states/types.rb', line 2172

class StartExecutionInput < Struct.new(
  :state_machine_arn,
  :name,
  :input,
  :trace_header)
  SENSITIVE = [:input]
  include Aws::Structure
end