Omics / Client / get_annotation_import_job

get_annotation_import_job

Omics.Client.get_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.

Gets information about an annotation import job.

See also: AWS API Documentation

Request Syntax

response = client.get_annotation_import_job(
    jobId='string'
)

Parameters:

jobId (string) –

[REQUIRED]

The job’s ID.

Return type:

dict

Returns:

Response Syntax

{
    'id': 'string',
    'destinationName': 'string',
    'versionName': 'string',
    'roleArn': 'string',
    'status': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLED'|'COMPLETED'|'FAILED'|'COMPLETED_WITH_FAILURES',
    'statusMessage': 'string',
    'creationTime': datetime(2015, 1, 1),
    'updateTime': datetime(2015, 1, 1),
    'completionTime': datetime(2015, 1, 1),
    'items': [
        {
            'source': 'string',
            'jobStatus': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLED'|'COMPLETED'|'FAILED'|'COMPLETED_WITH_FAILURES'
        },
    ],
    'runLeftNormalization': True|False,
    '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
        }
    },
    'annotationFields': {
        'string': 'string'
    }
}

Response Structure

• (dict) –

  • id (string) –

    The job’s ID.

  • destinationName (string) –

    The job’s destination annotation store.

  • versionName (string) –

    The name of the annotation store version.

  • roleArn (string) –

    The job’s service role ARN.

  • status (string) –

    The job’s status.

  • statusMessage (string) –

    The job’s status message.

  • creationTime (datetime) –

    When the job was created.

  • updateTime (datetime) –

    When the job was updated.

  • completionTime (datetime) –

    When the job completed.

  • items (list) –

    The job’s imported items.

    • (dict) –

      Details about an imported annotation item.

      • source (string) –

        The source file’s location in Amazon S3.

      • jobStatus (string) –

        The item’s job status.

  • runLeftNormalization (boolean) –

    The job’s left normalization setting.

  • formatOptions (dict) –

    Formatting options for a file.

    Note

    This is a Tagged Union structure. Only one of the following top level keys will be set: tsvOptions, vcfOptions. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

    'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
    

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

  • annotationFields (dict) –

    The annotation schema generated by the parsed annotation data.

    • (string) –

      • (string) –

Exceptions

• Omics.Client.exceptions.InternalServerException

• Omics.Client.exceptions.ThrottlingException

• Omics.Client.exceptions.ValidationException

• Omics.Client.exceptions.ResourceNotFoundException

• Omics.Client.exceptions.AccessDeniedException