AWS Step Functions

Validates the syntax of a state machine definition.

You can validate that a state machine definition is correct without creating a state machine resource. Step Functions will implicitly perform the same syntax check when you invoke CreateStateMachine and UpdateStateMachine. State machine definitions are specified using a JSON-based, structured language. For more information on Amazon States Language see Amazon States Language (ASL).

Suggested uses for ValidateStateMachineDefinition:

• Integrate automated checks into your code review or Continuous Integration (CI) process to validate state machine definitions before starting deployments.

• Run the validation from a Git pre-commit hook to check your state machine definitions before committing them to your source repository.

See also: AWS API Documentation

Request Syntax

client.validate_state_machine_definition(
    definition='string',
    type='STANDARD'|'EXPRESS'
)

type definition:

string

param definition:

[REQUIRED]

The Amazon States Language definition of the state machine. For more information, see Amazon States Language (ASL).

type type:

string

param type:

The target type of state machine for this definition. The default is STANDARD.

rtype:

dict

returns:

Response Syntax

{
    'result': 'OK'|'FAIL',
    'diagnostics': [
        {
            'severity': 'ERROR',
            'code': 'string',
            'message': 'string',
            'location': 'string'
        },
    ]
}

Response Structure

• (dict) --

  • result (string) --

    The result value will be OK when no syntax errors are found, or FAIL if the workflow definition does not pass verification.

  • diagnostics (list) --

    If the result is OK, this field will be empty. When there are errors, this field will contain an array of Diagnostic objects to help you troubleshoot.

    • (dict) --

      Describes an error found during validation. Validation errors found in the definition return in the response as diagnostic elements, rather than raise an exception.

      • severity (string) --

        A value of ERROR means that you cannot create or update a state machine with this definition.

      • code (string) --

        Identifying code for the diagnostic.

      • message (string) --

        Message describing the diagnostic condition.

      • location (string) --

        Location of the issue in the state machine, if available.

        For errors specific to a field, the location could be in the format: /States/<StateName>/<FieldName>, for example: /States/FailState/ErrorPath.