Omics / Client / create_workflow_version

create_workflow_version

Omics.Client.create_workflow_version(**kwargs)

Creates a new workflow version for the workflow that you specify with the workflowId parameter.

When you create a new version of a workflow, you need to specify the configuration for the new version. It doesn’t inherit any configuration values from the workflow.

Provide a version name that is unique for this workflow. You cannot change the name after HealthOmics creates the version.

Note

Don’t include any personally identifiable information (PII) in the version name. Version names appear in the workflow version ARN.

For more information, see Workflow versioning in Amazon Web Services HealthOmics in the Amazon Web Services HealthOmics User Guide.

See also: AWS API Documentation

Request Syntax

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

  • workflowId (string) –

    [REQUIRED]

    The ID of the workflow where you are creating the new version.

  • versionName (string) –

    [REQUIRED]

    A name for the workflow version. Provide a version name that is unique for this workflow. You cannot change the name after HealthOmics creates the version.

    The version name must start with a letter or number and it can include upper-case and lower-case letters, numbers, hyphens, periods and underscores. The maximum length is 64 characters. You can use a simple naming scheme, such as version1, version2, version3. You can also match your workflow versions with your own internal versioning conventions, such as 2.7.0, 2.7.1, 2.7.2.

  • definitionZip (bytes) – A zip archive containing the workflow definition for this workflow version.

  • definitionUri (string) – The URI specifies the location of the workflow definition for this workflow version.

  • accelerators (string) – The computational accelerator for this workflow version.

  • description (string) – A description for this workflow version.

  • engine (string) – The workflow engine for this workflow version.

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

  • parameterTemplate (dict) –

    The parameter template defines the input parameters for runs that use this workflow version.

    • (string) –

      • (dict) –

        A workflow parameter.

        • description (string) –

          The parameter’s description.

        • optional (boolean) –

          Whether the parameter is optional.

  • 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.

  • 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.

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

  • tags (dict) –

    Optional tags to associate with this workflow version.

    • (string) –

      • (string) –

  • workflowBucketOwnerId (string) – Amazon Web Services Id of the owner of the S3 bucket that contains the workflow definition. You need to specify this parameter if your account is not the bucket owner.

Return type:

dict

Returns:

Response Syntax

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

Response Structure

  • (dict) –

    • arn (string) –

      ARN of the workflow version.

    • workflowId (string) –

      The workflow’s ID.

    • versionName (string) –

      The workflow version name.

    • status (string) –

      The workflow version status.

    • tags (dict) –

      The workflow version’s tags.

      • (string) –

        • (string) –

    • uuid (string) –

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

Exceptions