start_reference_import_job

Omics.Client.start_reference_import_job(**kwargs)

Starts a reference import job.

See also: AWS API Documentation

Request Syntax

response = client.start_reference_import_job(
    clientToken='string',
    referenceStoreId='string',
    roleArn='string',
    sources=[
        {
            'description': 'string',
            'name': 'string',
            'sourceFile': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ]
)
Parameters
  • clientToken (string) -- To ensure that jobs don't run multiple times, specify a unique token for each job.
  • referenceStoreId (string) --

    [REQUIRED]

    The job's reference store ID.

  • roleArn (string) --

    [REQUIRED]

    A service role for the job.

  • sources (list) --

    [REQUIRED]

    The job's source files.

    • (dict) --

      A source for a reference import job.

      • description (string) --

        The source's description.

      • name (string) -- [REQUIRED]

        The source's name.

      • sourceFile (string) -- [REQUIRED]

        The source file's location in Amazon S3.

      • tags (dict) --

        The source's tags.

        • (string) --
          • (string) --
Return type

dict

Returns

Response Syntax

{
    'creationTime': datetime(2015, 1, 1),
    'id': 'string',
    'referenceStoreId': 'string',
    'roleArn': 'string',
    'status': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLING'|'CANCELLED'|'FAILED'|'COMPLETED'|'COMPLETED_WITH_FAILURES'
}

Response Structure

  • (dict) --

    • creationTime (datetime) --

      When the job was created.

    • id (string) --

      The job's ID.

    • referenceStoreId (string) --

      The job's reference store ID.

    • roleArn (string) --

      The job's service role ARN.

    • status (string) --

      The job's status.

Exceptions

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