Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

get_annotation_import_job

get_annotation_import_job(**kwargs)

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
{
    'completionTime': datetime(2015, 1, 1),
    'creationTime': datetime(2015, 1, 1),
    'destinationName': 'string',
    'formatOptions': {
        'tsvOptions': {
            'readOptions': {
                'comment': 'string',
                'encoding': 'string',
                'escape': 'string',
                'escapeQuotes': True|False,
                'header': True|False,
                'lineSep': 'string',
                'quote': 'string',
                'quoteAll': True|False,
                'sep': 'string'
            }
        },
        'vcfOptions': {
            'ignoreFilterField': True|False,
            'ignoreQualField': True|False
        }
    },
    'id': 'string',
    'items': [
        {
            'jobStatus': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLED'|'COMPLETED'|'FAILED'|'COMPLETED_WITH_FAILURES',
            'source': 'string'
        },
    ],
    'roleArn': 'string',
    'runLeftNormalization': True|False,
    'status': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLED'|'COMPLETED'|'FAILED'|'COMPLETED_WITH_FAILURES',
    'statusMessage': 'string',
    'updateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --
    • completionTime (datetime) --

      When the job completed.

    • creationTime (datetime) --

      When the job was created.

    • destinationName (string) --

      The job's destination annotation store.

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

          • comment (string) --

            The file's comment character.

          • encoding (string) --

            The file's encoding.

          • escape (string) --

            A character for escaping quotes in the file.

          • escapeQuotes (boolean) --

            Whether quotes need to be escaped in the file.

          • header (boolean) --

            Whether the file has a header row.

          • lineSep (string) --

            A line separator for the file.

          • quote (string) --

            The file's quote character.

          • quoteAll (boolean) --

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

          • sep (string) --

            The file's field separator.

      • vcfOptions (dict) --

        Options for a VCF file.

        • ignoreFilterField (boolean) --

          The file's ignore filter field setting.

        • ignoreQualField (boolean) --

          The file's ignore qual field setting.

    • id (string) --

      The job's ID.

    • items (list) --

      The job's imported items.

      • (dict) --

        Details about an imported annotation item.

        • jobStatus (string) --

          The item's job status.

        • source (string) --

          The source file's location in Amazon S3.

    • roleArn (string) --

      The job's service role ARN.

    • runLeftNormalization (boolean) --

      The job's left normalization setting.

    • status (string) --

      The job's status.

    • statusMessage (string) --

      The job's status message.

    • updateTime (datetime) --

      When the job was updated.

Exceptions

  • Omics.Client.exceptions.InternalServerException
  • Omics.Client.exceptions.ThrottlingException
  • Omics.Client.exceptions.ValidationException
  • Omics.Client.exceptions.ResourceNotFoundException
  • Omics.Client.exceptions.AccessDeniedException