Deleting workflows and runs in HealthOmics - AWS HealthOmics

Deleting workflows and runs in HealthOmics

When you no longer need a workflow, run, or run group, you can delete it using the AWS CLI, API, or console. You can delete a workflow when it's listed in ACTIVE or FAILED status and has no active shares. Deleting a workflow doesn't affect any ongoing runs that are using the workflow.

The following example shows how you can use the AWS CLI command to delete a workflow. You won't receive a response. To run the example, replace the workflow id with the ID of the workflow you want to delete.

aws omics delete-workflow --id workflow id

In addition to deleting a run, you can also cancel a run. To cancel a run, its status must be PENDING, STARTING, RUNNING, or STOPPING.

Note

When you cancel a run, HealthOmics doesn't save any of the run outputs.

The following AWS CLI command shows how you can cancel a run. To run the example, replace the run id with the ID of the run you would like to cancel. If successful, there is no response.

aws omics cancel-run --id run id

The following AWS CLI command deletes a run. Runs can only be deleted if they are complete or canceled. To run the example, replace the run id with the ID of the run you want to delete. There is no response if the run is successfully deleted.

aws omics delete-run --id run id

You can also delete run groups. Run groups can only be deleted if there are no runs associated with that run group with the status of PENDING, STARTING, RUNNING, or STOPPING.

The following example shows how you can use the AWS CLI to delete a run group. You will not receive a response. To run the example, replace the run group id with the ID of the run group you want to delete.

aws omics delete-run-group --id run group id