Omics / Client / start_annotation_import_job

start_annotation_import_job

Omics.Client.start_annotation_import_job(**kwargs)

Warning

Amazon Web Services HealthOmics variant stores and annotation stores will no longer be open to new customers starting November 7, 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 Amazon Web Services HealthOmics variant store and annotation store availability change.

Starts an annotation import job.

See also: AWS API Documentation

Request Syntax

response = client.start_annotation_import_job(
    destinationName='string',
    roleArn='string',
    items=[
        {
            'source': 'string'
        },
    ],
    versionName='string',
    formatOptions={
        'tsvOptions': {
            'readOptions': {
                'sep': 'string',
                'encoding': 'string',
                'quote': 'string',
                'quoteAll': True|False,
                'escape': 'string',
                'escapeQuotes': True|False,
                'comment': 'string',
                'header': True|False,
                'lineSep': 'string'
            }
        },
        'vcfOptions': {
            'ignoreQualField': True|False,
            'ignoreFilterField': True|False
        }
    },
    runLeftNormalization=True|False,
    annotationFields={
        'string': 'string'
    }
)
Parameters:

  • destinationName (string) –

    [REQUIRED]

    A destination annotation store for the job.

  • roleArn (string) –

    [REQUIRED]

    A service role for the job.

  • items (list) –

    [REQUIRED]

    Items to import.

    • (dict) –

      A source for an annotation import job.

      • source (string) – [REQUIRED]

        The source file’s location in Amazon S3.

  • versionName (string) – The name of the annotation store version.

  • formatOptions (dict) –

    Formatting options for the annotation file.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: tsvOptions, vcfOptions.

    • tsvOptions (dict) –

      Options for a TSV file.

      • readOptions (dict) –

        The file’s read options.

        • sep (string) –

          The file’s field separator.

        • encoding (string) –

          The file’s encoding.

        • quote (string) –

          The file’s quote character.

        • quoteAll (boolean) –

          Whether all values need to be quoted, or just those that contain quotes.

        • escape (string) –

          A character for escaping quotes in the file.

        • escapeQuotes (boolean) –

          Whether quotes need to be escaped in the file.

        • comment (string) –

          The file’s comment character.

        • header (boolean) –

          Whether the file has a header row.

        • lineSep (string) –

          A line separator for the file.

    • vcfOptions (dict) –

      Options for a VCF file.

      • ignoreQualField (boolean) –

        The file’s ignore qual field setting.

      • ignoreFilterField (boolean) –

        The file’s ignore filter field setting.

  • runLeftNormalization (boolean) – The job’s left normalization setting.

  • annotationFields (dict) –

    The annotation schema generated by the parsed annotation data.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'jobId': 'string'
}

Response Structure

  • (dict) –

    • jobId (string) –

      The job’s ID.

Exceptions