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

***************************
list_annotation_import_jobs
***************************



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

  

  

  .. warning::

    

    Amazon Web Services HealthOmics variant stores and annotation stores will no longer be open to new customers starting November 7, 2025. If you would like to use variant stores or annotation stores, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see `Amazon Web Services HealthOmics variant store and annotation store availability change <https://docs.aws.amazon.com/omics/latest/dev/variant-store-availability-change.html>`__.

    

   

  Retrieves a list of annotation import jobs.

  

  

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


  **Request Syntax**
  ::

    response = client.list_annotation_import_jobs(
        maxResults=123,
        ids=[
            'string',
        ],
        nextToken='string',
        filter={
            'status': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLED'|'COMPLETED'|'FAILED'|'COMPLETED_WITH_FAILURES',
            'storeName': 'string'
        }
    )
    
  :type maxResults: integer
  :param maxResults: 

    The maximum number of jobs to return in one page of results.

    

  
  :type ids: list
  :param ids: 

    IDs of annotation import jobs to retrieve.

    

  
    - *(string) --* 

    

  :type nextToken: string
  :param nextToken: 

    Specifies the pagination token from a previous request to retrieve the next page of results.

    

  
  :type filter: dict
  :param filter: 

    A filter to apply to the list.

    

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

      A status to filter on.

      

    
    - **storeName** *(string) --* 

      A store name to filter on.

      

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

    
    ::

      {
          'annotationImportJobs': [
              {
                  'id': 'string',
                  'destinationName': 'string',
                  'versionName': 'string',
                  'roleArn': 'string',
                  'status': 'SUBMITTED'|'IN_PROGRESS'|'CANCELLED'|'COMPLETED'|'FAILED'|'COMPLETED_WITH_FAILURES',
                  'creationTime': datetime(2015, 1, 1),
                  'updateTime': datetime(2015, 1, 1),
                  'completionTime': datetime(2015, 1, 1),
                  'runLeftNormalization': True|False,
                  'annotationFields': {
                      'string': 'string'
                  }
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **annotationImportJobs** *(list) --* 

        A list of jobs.

        
        

        - *(dict) --* 

          An annotation import job.

          
          

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

            The job's ID.

            
          

          - **destinationName** *(string) --* 

            The job's destination annotation store.

            
          

          - **versionName** *(string) --* 

            The name of the annotation store version.

            
          

          - **roleArn** *(string) --* 

            The job's service role ARN.

            
          

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

            The job's status.

            
          

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

            When the job was created.

            
          

          - **updateTime** *(datetime) --* 

            When the job was updated.

            
          

          - **completionTime** *(datetime) --* 

            When the job completed.

            
          

          - **runLeftNormalization** *(boolean) --* 

            The job's left normalization setting.

            
          

          - **annotationFields** *(dict) --* 

            The annotation schema generated by the parsed annotation data.

            
            

            - *(string) --* 
              

              - *(string) --* 
        
      
      
    
      

      - **nextToken** *(string) --* 

        Specifies the pagination token from a previous request to retrieve the next page of results.

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

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

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

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

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

  