get_annotation_import_job

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