There are more AWS SDK examples available in the [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub repo.
# Use `DescribeExecution` with an AWS SDK
The following code examples show how to use `DescribeExecution`.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in context in the following code examples:
+ [Learn the basics](sfn_example_sfn_Scenario_GetStartedStateMachines_section.md)
+ [Getting started with Step Functions](sfn_example_iam_GettingStarted_080_section.md)
------
#### [ .NET ]
**SDK for .NET**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/StepFunctions#code-examples).
```
///
/// Retrieve information about the specified Step Functions execution.
///
/// The Amazon Resource Name (ARN) of the
/// Step Functions execution.
/// The API response returned by the API.
public async Task DescribeExecutionAsync(string executionArn)
{
var response = await _amazonStepFunctions.DescribeExecutionAsync(new DescribeExecutionRequest { ExecutionArn = executionArn });
return response;
}
```
+ For API details, see [DescribeExecution](https://docs.aws.amazon.com/goto/DotNetSDKV3/states-2016-11-23/DescribeExecution) in *AWS SDK for .NET API Reference*.
------
#### [ Java ]
**SDK for Java 2.x**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/stepfunctions#code-examples).
```
public static void describeExe(SfnClient sfnClient, String executionArn) {
try {
DescribeExecutionRequest executionRequest = DescribeExecutionRequest.builder()
.executionArn(executionArn)
.build();
String status = "";
boolean hasSucceeded = false;
while (!hasSucceeded) {
DescribeExecutionResponse response = sfnClient.describeExecution(executionRequest);
status = response.statusAsString();
if (status.compareTo("RUNNING") == 0) {
System.out.println("The state machine is still running, let's wait for it to finish.");
Thread.sleep(2000);
} else if (status.compareTo("SUCCEEDED") == 0) {
System.out.println("The Step Function workflow has succeeded");
hasSucceeded = true;
} else {
System.out.println("The Status is neither running or succeeded");
}
}
System.out.println("The Status is " + status);
} catch (SfnException | InterruptedException e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ For API details, see [DescribeExecution](https://docs.aws.amazon.com/goto/SdkForJavaV2/states-2016-11-23/DescribeExecution) in *AWS SDK for Java 2.x API Reference*.
------
#### [ Kotlin ]
**SDK for Kotlin**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/stepfunctions#code-examples).
```
suspend fun describeExe(executionArnVal: String?) {
val executionRequest =
DescribeExecutionRequest {
executionArn = executionArnVal
}
var status = ""
var hasSucceeded = false
while (!hasSucceeded) {
SfnClient.fromEnvironment { region = "us-east-1" }.use { sfnClient ->
val response = sfnClient.describeExecution(executionRequest)
status = response.status.toString()
if (status.compareTo("Running") == 0) {
println("The state machine is still running, let's wait for it to finish.")
Thread.sleep(2000)
} else if (status.compareTo("Succeeded") == 0) {
println("The Step Function workflow has succeeded")
hasSucceeded = true
} else {
println("The Status is $status")
}
}
}
println("The Status is $status")
}
```
+ For API details, see [DescribeExecution](https://sdk.amazonaws.com/kotlin/api/latest/index.html) in *AWS SDK for Kotlin API reference*.
------
#### [ Python ]
**SDK for Python (Boto3)**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/stepfunctions#code-examples).
```
def describe_run(self, run_arn):
"""
Get data about a state machine run, such as its current status or final output.
:param run_arn: The ARN of the run to look up.
:return: The retrieved run data.
"""
try:
response = self.stepfunctions_client.describe_execution(
executionArn=run_arn
)
except ClientError as err:
logger.error(
"Couldn't describe run %s. Here's why: %s: %s",
run_arn,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return response
```
+ For API details, see [DescribeExecution](https://docs.aws.amazon.com/goto/boto3/states-2016-11-23/DescribeExecution) in *AWS SDK for Python (Boto3) API Reference*.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/sfn#code-examples).
```
TRY.
oo_result = lo_sfn->describeexecution(
iv_executionarn = iv_execution_arn
).
MESSAGE 'Execution described successfully.' TYPE 'I'.
CATCH /aws1/cx_sfnexecdoesnotexist.
MESSAGE 'Execution does not exist.' TYPE 'E'.
CATCH /aws1/cx_sfninvalidarn.
MESSAGE 'Invalid execution ARN.' TYPE 'E'.
ENDTRY.
```
+ For API details, see [DescribeExecution](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP API reference*.
------