---
title: "POST /#X-Amz-Target=AmazonAthena.GetCalculationExecution"
method: POST
path: "/#X-Amz-Target=AmazonAthena.GetCalculationExecution"
---

# POST /#X-Amz-Target=AmazonAthena.GetCalculationExecution

`POST /#X-Amz-Target=AmazonAthena.GetCalculationExecution`

Describes a previously submitted calculation execution.

## Headers

- `X-Amz-Target` 'AmazonAthena.GetCalculationExecution', required

## Request body

- GetCalculationExecutionRequest
  - `CalculationExecutionId` string, required — The calculation execution UUID.

## Response `200`

Success

- GetCalculationExecutionResponse
  - `CalculationExecutionId` string — The calculation execution UUID.
  - `SessionId` string — The session ID that the calculation ran in.
  - `Description` string — The description of the calculation execution.
  - `WorkingDirectory` string — The Amazon S3 location in which calculation results are stored.
  - `Status` object — Contains information about the status of the calculation.
    - `SubmissionDateTime` string, date-time — The date and time the calculation was submitted for processing.
    - `CompletionDateTime` string, date-time — The date and time the calculation completed processing.
    - `State` 'CREATING' | 'CREATED' | 'QUEUED' | 'RUNNING' | 'CANCELING' | 'CANCELED' | 'COMPLETED' | 'FAILED' — <p>The state of the calculation execution. A description of each state follows.</p> <p> <code>CREATING</code> - The calculation is in the process of being created.</p> <p> <code>CREATED</code> - The calculation has been created and is ready to run.</p> <p> <code>QUEUED</code> - The calculation has been queued for processing.</p> <p> <code>RUNNING</code> - The calculation is running.</p> <p> <code>CANCELING</code> - A request to cancel the calculation has been received and the system is working to stop it.</p> <p> <code>CANCELED</code> - The calculation is no longer running as the result of a cancel request.</p> <p> <code>COMPLETED</code> - The calculation has completed without error.</p> <p> <code>FAILED</code> - The calculation failed and is no longer running.</p>
    - `StateChangeReason` string — The reason for the calculation state change (for example, the calculation was canceled because the session was terminated).
  - `Statistics` object — Contains information about the data processing unit (DPU) execution time and progress. This field is populated only when statistics are available.
    - `DpuExecutionInMillis` integer — The data processing unit execution time in milliseconds for the calculation.
    - `Progress` string — The progress of the calculation.
  - `Result` object — Contains result information. This field is populated only if the calculation is completed.
    - `StdOutS3Uri` string — The Amazon S3 location of the <code>stdout</code> file for the calculation.
    - `StdErrorS3Uri` string — The Amazon S3 location of the <code>stderr</code> error messages file for the calculation.
    - `ResultS3Uri` string — The Amazon S3 location of the folder for the calculation results.
    - `ResultType` string — The data format of the calculation result.

## Other responses

- `480` — InternalServerException
- `481` — InvalidRequestException
- `482` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/athena.md) · [All operations](https://skmtc.net/aws/apis/athena/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/athena/versions/0aec8c61283d/schema)