AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Container for the parameters to the StartExecution operation. Starts a state machine execution.
A qualified state machine ARN can either refer to a Distributed Map state defined within a state machine, a version ARN, or an alias ARN.
The following are some examples of qualified and unqualified state machine ARNs:
The following qualified state machine ARN refers to a Distributed Map state
with a label
mapStateLabel in a state machine named
If you provide a qualified state machine ARN that refers to a Distributed Map state,
the request fails with
The following qualified state machine ARN refers to an alias named
If you provide a qualified state machine ARN that refers to a version ARN or an alias ARN, the request starts execution for that version or alias.
The following unqualified state machine ARN refers to a state machine named
If you start an execution with an unqualified state machine ARN, Step Functions uses the latest revision of the state machine for the execution.
StartExecution is idempotent for
STANDARD workflows. For a
workflow, if you call
StartExecution with the same name and input as a running
execution, the call succeeds and return the same response as the original request.
If the execution is closed or if the input is different, it returns a
error. You can reuse names after 90 days.
StartExecution isn't idempotent for
public class StartExecutionRequest : AmazonStepFunctionsRequest IAmazonWebServiceRequest
The StartExecutionRequest type exposes the following members
Gets and sets the property Input.
The string that contains the JSON input data for the execution, for example:
If you don't include any JSON input data, you still must include the two braces, for
Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.
Gets and sets the property Name.
Optional name of the execution. This name must be unique for your Amazon Web Services account, Region, and state machine for 90 days. For more information, see Limits Related to State Machine Executions in the Step Functions Developer Guide.
If you don't provide a name for the execution, Step Functions automatically generates a universally unique identifier (UUID) as the execution name.
A name must not contain:
To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.
Gets and sets the property StateMachineArn.
The Amazon Resource Name (ARN) of the state machine to execute.
Gets and sets the property TraceHeader.
Passes the X-Ray trace header. The trace header can also be passed in the request payload.
.NET Core App:
Supported in: 3.1
Supported in: 2.0
Supported in: 4.5, 4.0, 3.5