Using HealthOmics runs - AWS HealthOmics

AWS HealthOmics variant stores and annotation stores will no longer be open to new customers starting November 7th, 2025. If you would like to use variant stores or annotation stores, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see AWS HealthOmics variant store and annotation store availability change.

Using HealthOmics runs

After you create a workflow, you can start runs using the workflow.

When you start a run, HealthOmics allocates temporary run storage for the workflow engine to use during the run. To ensure data isolation and security, HealthOmics provisions the storage at the start of each run, and deprovisions it at the end of the run.

HealthOmics provides several quotas related to workflow runs and tasks. Default values are intentionally conservative, to help you avoid unexpected cost overruns. You can request an increase in these quotas. For more information, see HealthOmics service quotas.

When you start a run, HealthOmics assigns a run ID and a run uuid to the run. Runs in an account have unique run IDs. However, HealthOmics reuses deleted run IDs, so a run and a deleted run can have the same run ID. Also, it's rare but possible for a shared workflow to have the same run ID as a run in your account.

The run uuid is a Globally Unique Identifier (guid) that you can use to identify runs across accounts or to distinguish between two runs in your account that have the same run ID.

Note

For data provenance purposes, we recommend that you use the run uuid to uniquely identify runs. The run uuid is also the best identifier to link to your internal lab information management system (LIMs) or sample tracking system.

You can use Amazon Q CLI to optimize your runs and analyze run performance. For more information, see Example prompts for Amazon Q CLI and the HealthOmics Agentic generative AI tutorial on GitHub.