Omics / Client / start_reference_import_job

start_reference_import_job#

Omics.Client.start_reference_import_job(**kwargs)#

Starts a reference import job.

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