Omics / Client / create_workflow

create_workflow

Omics.Client.create_workflow(**kwargs)

Creates a private workflow.Private workflows depend on a variety of resources that you create and configure before creating the workflow:

  • Input data: Input data for the workflow, stored in an S3 bucket or a Amazon Web Services HealthOmics sequence store.

  • Workflow definition files: Define your workflow in one or more workflow definition files, written in WDL, Nextflow, or CWL. The workflow definition specifies the inputs and outputs for runs that use the workflow. It also includes specifications for the runs and run tasks for your workflow, including compute and memory requirements.

  • Parameter template files: Define run parameters using a parameter template file (written in JSON).

  • ECR container images: Create one or more container images for the workflow. Store the images in a private ECR repository.

  • (Optional) Sentieon licenses: Request a Sentieon license if you plan to use Sentieon software in a private workflow.

For more information, see Creating or updating a private workflow in Amazon Web Services HealthOmics in the Amazon Web Services HealthOmics User Guide.

See also: AWS API Documentation

Request Syntax

response = client.create_workflow(
    name='string',
    description='string',
    engine='WDL'|'NEXTFLOW'|'CWL',
    definitionZip=b'bytes',
    definitionUri='string',
    main='string',
    parameterTemplate={
        'string': {
            'description': 'string',
            'optional': True|False
        }
    },
    storageCapacity=123,
    tags={
        'string': 'string'
    },
    requestId='string',
    accelerators='GPU',
    storageType='STATIC'|'DYNAMIC'
)
Parameters:

  • name (string) – A name for the workflow.

  • description (string) – A description for the workflow.

  • engine (string) – The workflow engine for the workflow.

  • definitionZip (bytes) – A ZIP archive for the workflow.

  • definitionUri (string) – The URI of a definition for the workflow.

  • main (string) – The path of the main definition file for the workflow.

  • parameterTemplate (dict) –

    A parameter template for the workflow.

    • (string) –

      • (dict) –

        A workflow parameter.

        • description (string) –

          The parameter’s description.

        • optional (boolean) –

          Whether the parameter is optional.

  • storageCapacity (integer) – The default static storage capacity (in gibibytes) for runs that use this workflow or workflow version.

  • tags (dict) –

    Tags for the workflow.

    • (string) –

      • (string) –

  • requestId (string) –

    [REQUIRED]

    To ensure that requests don’t run multiple times, specify a unique ID for each request.

    This field is autopopulated if not provided.

  • accelerators (string) – The computational accelerator specified to run the workflow.

  • storageType (string) – The default storage type for runs that use this workflow. STATIC storage allocates a fixed amount of storage. DYNAMIC storage dynamically scales the storage up or down, based on file system utilization. For more information about static and dynamic storage, see Running workflows in the Amazon Web Services HealthOmics User Guide.

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'id': 'string',
    'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETED'|'FAILED'|'INACTIVE',
    'tags': {
        'string': 'string'
    },
    'uuid': 'string'
}

Response Structure

  • (dict) –

    • arn (string) –

      The workflow’s ARN.

    • id (string) –

      The workflow’s ID.

    • status (string) –

      The workflow’s status.

    • tags (dict) –

      The workflow’s tags.

      • (string) –

        • (string) –

    • uuid (string) –

      The universally unique identifier (UUID) value for this workflow.

Exceptions