AWS SDK Version 3 for .NET
API Reference

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:

Note:

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

Syntax

C#
public abstract UpdateStateMachineAliasResponse UpdateStateMachineAlias(
         UpdateStateMachineAliasRequest request
)

Parameters

request
Type: Amazon.StepFunctions.Model.UpdateStateMachineAliasRequest

Container for the necessary parameters to execute the UpdateStateMachineAlias service method.

Return Value


The response from the UpdateStateMachineAlias service method, as returned by StepFunctions.

Exceptions

ExceptionCondition
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.

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

See Also