:doc:`Omics <../../omics>` / Client / start_read_set_activation_job

*****************************
start_read_set_activation_job
*****************************



.. py:method:: Omics.Client.start_read_set_activation_job(**kwargs)

  

  Activates an archived read set and returns its metadata in a JSON formatted output. AWS HealthOmics automatically archives unused read sets after 30 days. To monitor the status of your read set activation job, use the ``GetReadSetActivationJob`` operation.

   

  To learn more, see `Activating read sets <https://docs.aws.amazon.com/omics/latest/dev/activating-read-sets.html>`__ in the *Amazon Web Services HealthOmics User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/omics-2022-11-28/StartReadSetActivationJob>`_  


  **Request Syntax**
  ::

    response = client.start_read_set_activation_job(
        sequenceStoreId='string',
        clientToken='string',
        sources=[
            {
                'readSetId': 'string'
            },
        ]
    )
    
  :type sequenceStoreId: string
  :param sequenceStoreId: **[REQUIRED]** 

    The read set's sequence store ID.

    

  
  :type clientToken: string
  :param clientToken: 

    To ensure that jobs don't run multiple times, specify a unique token for each job.

    

  
  :type sources: list
  :param sources: **[REQUIRED]** 

    The job's source files.

    

  
    - *(dict) --* 

      A source for a read set activation job.

      

    
      - **readSetId** *(string) --* **[REQUIRED]** 

        The source's read set ID.

        

      
    

  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'id': 'string',
          'sequenceStoreId': 'string',
          'status': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLING'|'CANCELLED'|'FAILED'|'COMPLETED'|'COMPLETED_WITH_FAILURES',
          'creationTime': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **id** *(string) --* 

        The job's ID.

        
      

      - **sequenceStoreId** *(string) --* 

        The read set's sequence store ID.

        
      

      - **status** *(string) --* 

        The job's status.

        
      

      - **creationTime** *(datetime) --* 

        When the job was created.

        
  
  **Exceptions**
  
  *   :py:class:`Omics.Client.exceptions.InternalServerException`

  
  *   :py:class:`Omics.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`Omics.Client.exceptions.ThrottlingException`

  
  *   :py:class:`Omics.Client.exceptions.ValidationException`

  
  *   :py:class:`Omics.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`Omics.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Omics.Client.exceptions.RequestTimeoutException`

  