---
title: "GET /run/{id}"
method: GET
path: "/run/{id}"
---

# GET /run/{id}

`GET /run/{id}`

Gets detailed information about a specific run using its ID.

Amazon Web Services HealthOmics stores a configurable number of runs, as determined by service limits, that are available to the console and API. If `GetRun` does not return the requested run, you can find all run logs in the CloudWatch logs. For more information about viewing the run logs, see [CloudWatch logs](https://docs.aws.amazon.com/omics/latest/dev/monitoring-cloudwatch-logs.html) in the _Amazon Web Services HealthOmics User Guide_.

## Path parameters

- `id` string, required

## Query parameters

- `export` RunExport[]

## Response `200`

Success

- GetRunResponse
  - `arn` string — The run's ARN.
  - `id` string — The run's ID.
  - `cacheId` string — The run cache associated with the run.
  - `cacheBehavior` 'CACHE_ON_FAILURE' | 'CACHE_ALWAYS' — The run cache behavior for the run.
  - `engineVersion` string — The actual Nextflow engine version that Amazon Web Services HealthOmics used for the run. The other workflow definition languages don't provide a value for this field.
  - `status` 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'COMPLETED' | 'DELETED' | 'CANCELLED' | 'FAILED' — The run's status.
  - `workflowId` string — The run's workflow ID.
  - `workflowType` 'PRIVATE' | 'READY2RUN' — The run's workflow type.
  - `runId` string — The run's ID.
  - `roleArn` string — The run's service role ARN.
  - `name` string — The run's name.
  - `runGroupId` string — The run's group ID.
  - `batchId` string — The run's batch ID.
  - `priority` integer — The run's priority.
  - `definition` string — The run's definition.
  - `digest` string — The run's digest.
  - `parameters` object — The run's parameters.
  - `storageCapacity` integer — The run's storage capacity in gibibytes. For dynamic storage, after the run has completed, this value is the maximum amount of storage used during the run.
  - `outputUri` string — The run's output URI.
  - `logLevel` 'OFF' | 'FATAL' | 'ERROR' | 'ALL' — The run's log level.
  - `resourceDigests` object — The run's resource digests.
  - `startedBy` string — Who started the run.
  - `creationTime` string, date-time — When the run was created.
  - `startTime` string, date-time — When the run started.
  - `stopTime` string, date-time — The run's stop time.
  - `statusMessage` string — The run's status message.
  - `tags` object — The run's tags.
  - `accelerators` 'GPU' — The computational accelerator used to run the workflow.
  - `retentionMode` 'RETAIN' | 'REMOVE' — The run's retention mode.
  - `failureReason` string — The reason a run has failed.
  - `logLocation` object — The location of the run log.
    - `engineLogStream` string — The log stream ARN for the engine log.
    - `runLogStream` string — The log stream ARN for the run log.
  - `uuid` string — The universally unique identifier for a run.
  - `runOutputUri` string — The destination for workflow outputs.
  - `storageType` 'STATIC' | 'DYNAMIC' — The run's storage type.
  - `workflowOwnerId` string — The ID of the workflow owner.
  - `workflowVersionName` string — The workflow version name.
  - `workflowUuid` string — The universally unique identifier (UUID) value for the workflow.
  - `networkingMode` 'RESTRICTED' | 'VPC' — Configuration for run networking behavior. If absent, this will default to RESTRICTED.
  - `scratchStorageMode` 'LOCAL' | 'SHARED' — Optional configuration for enabling scratch ephemeral storage mounted at /tmp. If absent, this will default to SHARED. This configuration is applicable only for CPU tasks. For tasks using GPUs, scratch storage is always LOCAL.
  - `configuration` object — Configuration details for the workflow run.
    - `name` string — User-friendly name for the configuration.
    - `arn` string — Unique resource identifier for the configuration.
    - `uuid` string — Unique identifier for the configuration.
  - `vpcConfig` object — VPC configuration for the workflow run.
    - `securityGroupIds` SecurityGroupId[] — List of security group IDs.
    - `subnetIds` SubnetId[] — List of subnet IDs.
    - `vpcId` string — VPC ID computed from the provided subnet IDs.
  - `engineSettings` object — The engine-specific settings for the workflow run.

## Other responses

- `480` — InternalServerException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ConflictException
- `485` — ResourceNotFoundException
- `486` — AccessDeniedException
- `487` — RequestTimeoutException

---

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