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.
Updates the configuration of an existing state machine alias
by modifying its description
or routingConfiguration
.
You must specify at least one of the description
or routingConfiguration
parameters to update a state machine alias.
UpdateStateMachineAlias
is an idempotent API. Step Functions bases the idempotency
check on the stateMachineAliasArn
, description
, and routingConfiguration
parameters. Requests with the same parameters return an idempotent response.
This operation is eventually consistent. All StartExecution requests made within
a few seconds use the latest alias configuration. Executions started immediately after
calling UpdateStateMachineAlias
may use the previous routing configuration.
Related operations:
For .NET Core this operation is only available in asynchronous form. Please refer to UpdateStateMachineAliasAsync.
Namespace: Amazon.StepFunctions
Assembly: AWSSDK.StepFunctions.dll
Version: 3.x.y.z
public abstract UpdateStateMachineAliasResponse UpdateStateMachineAlias( UpdateStateMachineAliasRequest request )
Container for the necessary parameters to execute the UpdateStateMachineAlias service method.
Exception | Condition |
---|---|
ConflictException | Updating or deleting a resource can cause an inconsistent state. This error occurs when there're concurrent requests for DeleteStateMachineVersion, PublishStateMachineVersion, or UpdateStateMachine with the publish parameter set to true. HTTP Status Code: 409 |
InvalidArnException | The provided Amazon Resource Name (ARN) is not valid. |
ResourceNotFoundException | Could not find the referenced resource. |
StateMachineDeletingException | The specified state machine is being deleted. |
ValidationException | The input does not satisfy the constraints specified by an Amazon Web Services service. |
.NET Framework:
Supported in: 4.5 and newer, 3.5