Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AWS Step Functions #X Amz Target=AWSStepFunctions.CreateStateMachine API

The #X Amz Target=AWSStepFunctions.CreateStateMachine API from AWS Step Functions — 1 operation(s) for #x amz target=awsstepfunctions.createstatemachine.

AWS Step Functions #X Amz Target=AWSStepFunctions.CreateStateMachine API is one of 26 APIs that AWS Step Functions publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include #X Amz Target=AWSStepFunctions.CreateStateMachine. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and an API reference.

This API exposes 1 operation across 1 path, and defines 29 schemas. It is described by OpenAPI 3.0.0, at version 2016-11-23.

Requests are made against 4 base URLs: http://states.{region}.amazonaws.com, https://states.{region}.amazonaws.com, http://states.{region}.amazonaws.com.cn, https://states.{region}.amazonaws.com.cn.

1 operations 1 paths 29 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2016-11-23
Base URL
https://states.{region}.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

AWS Step Functions #X Amz Target=AWSStepFunctions.CreateStateMachine API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

#X Amz Target=AWSStepFunctions.CreateStateMachine 1
POST
/#X-Amz-Target=AWSStepFunctions.CreateStateMachine
AWS Step Functions - Create State Machine
CreateStateMachine 8 params body → 200480481482483484485486

Schemas 29

The contract defines 29 schemas that model the data the API accepts and returns. The most detailed are CreateStateMachineInput (7 properties), LoggingConfiguration (3 properties), CreateStateMachineOutput (2 properties), Tag (2 properties). Each schema is shown below with its type and property counts.

Enabled
boolean
InvalidName
StateMachineLimitExceeded
StateMachineTypeNotSupported
TagValue
string
Tag
object
Tags are key-value pairs that can be associated with Step Functions state machines and activities. An array of key-value pairs. For more information, see Using…
2 properties
CreateStateMachineOutput
object
2 properties 2 required
LoggingConfiguration
object
The LoggingConfiguration data type is used to set CloudWatch Logs options.
3 properties
InvalidTracingConfiguration
StateMachineDeleting
InvalidLoggingConfiguration
InvalidDefinition
TracingConfiguration
object
Selects whether or not the state machine's X-Ray tracing is enabled. Default is false
1 property
IncludeExecutionData
boolean
StateMachineType
string
LogLevel
string
CreateStateMachineInput
object
7 properties 3 required
StateMachineAlreadyExists
Arn
string
LogDestination
object
1 property
Timestamp
string
Definition
string
CloudWatchLogsLogGroup
object
1 property
Name
string
TagKey
string
InvalidArn
TooManyTags
TagList
array
LogDestinationList
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aws-step-functions-x-amz-target-awsstepfunctions-createstatemachine-api-openapi.yml Raw ↑

Other APIs AWS Step Functions publishes across the network.

AWS Step Functions #X Amz Target=AWSStepFunctions.CreateActivity API
AWS Step Functions #X Amz Target=AWSStepFunctions.DeleteActivity API
AWS Step Functions #X Amz Target=AWSStepFunctions.DeleteStateMachine API
AWS Step Functions #X Amz Target=AWSStepFunctions.DescribeActivity API
AWS Step Functions #X Amz Target=AWSStepFunctions.DescribeExecution API
AWS Step Functions #X Amz Target=AWSStepFunctions.DescribeMapRun API
AWS Step Functions #X Amz Target=AWSStepFunctions.DescribeStateMachine API
AWS Step Functions #X Amz Target=AWSStepFunctions.DescribeStateMachineForExecution API
AWS Step Functions #X Amz Target=AWSStepFunctions.GetActivityTask API
AWS Step Functions #X Amz Target=AWSStepFunctions.GetExecutionHistory API
AWS Step Functions #X Amz Target=AWSStepFunctions.ListActivities API
AWS Step Functions #X Amz Target=AWSStepFunctions.ListExecutions API