# StateMachineInput

Represents the input for the StateMachine.

- Source: [`aws-codepipeline-actions/lib/stepfunctions/invoke-action.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-codepipeline-actions/lib/stepfunctions/invoke-action.ts#L11)

## Example

```ts
import * as stepfunctions from 'aws-cdk-lib/aws-stepfunctions';
const pipeline = new codepipeline.Pipeline(this, 'MyPipeline');
const startState = new stepfunctions.Pass(this, 'StartState');
const simpleStateMachine  = new stepfunctions.StateMachine(this, 'SimpleStateMachine', {
  definition: startState,
});
const stepFunctionAction = new codepipeline_actions.StepFunctionInvokeAction({
  actionName: 'Invoke',
  stateMachine: simpleStateMachine,
  stateMachineInput: codepipeline_actions.StateMachineInput.literal({ IsHelloWorldExample: true }),
});
pipeline.addStage({
  stageName: 'StepFunctions',
  actions: [stepFunctionAction],
});
```

## Properties

- `input`: any = none — When InputType is set to Literal (default), the Input field is used directly as the input for the state machine execution.

  Otherwise, the state machine is invoked with an empty JSON object {}.

  When InputType is set to FilePath, this field is required.
  An input artifact is also required when InputType is set to FilePath.

- `inputArtifact`: [Artifact](/cdk/api/v2/docs/aws-cdk-lib.aws_codepipeline.Artifact.html) — The optional input Artifact of the Action.

  **Default:** the Action will not have any inputs

  If InputType is set to FilePath, this artifact is required
  and is used to source the input for the state machine execution.

- `inputType`: string = Literal — Optional StateMachine InputType InputType can be Literal or FilePath.

## Methods

- `filePath(inputFile: ArtifactPath): StateMachineInput // chainable` (static) — When the input type is FilePath, input artifact and filepath must be specified.

- `literal(object: json): StateMachineInput // chainable` (static) — When the input type is Literal, input value is passed directly to the state machine input.