:doc:`Personalize <../../personalize>` / Client / list_dataset_export_jobs

************************
list_dataset_export_jobs
************************



.. py:method:: Personalize.Client.list_dataset_export_jobs(**kwargs)

  

  Returns a list of dataset export jobs that use the given dataset. When a dataset is not specified, all the dataset export jobs associated with the account are listed. The response provides the properties for each dataset export job, including the Amazon Resource Name (ARN). For more information on dataset export jobs, see `CreateDatasetExportJob <https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html>`__. For more information on datasets, see `CreateDataset <https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListDatasetExportJobs>`_  


  **Request Syntax**
  ::

    response = client.list_dataset_export_jobs(
        datasetArn='string',
        nextToken='string',
        maxResults=123
    )
    
  :type datasetArn: string
  :param datasetArn: 

    The Amazon Resource Name (ARN) of the dataset to list the dataset export jobs for.

    

  
  :type nextToken: string
  :param nextToken: 

    A token returned from the previous call to ``ListDatasetExportJobs`` for getting the next set of dataset export jobs (if they exist).

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of dataset export jobs to return.

    

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

    
    ::

      {
          'datasetExportJobs': [
              {
                  'datasetExportJobArn': 'string',
                  'jobName': 'string',
                  'status': 'string',
                  'creationDateTime': datetime(2015, 1, 1),
                  'lastUpdatedDateTime': datetime(2015, 1, 1),
                  'failureReason': 'string'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **datasetExportJobs** *(list) --* 

        The list of dataset export jobs.

        
        

        - *(dict) --* 

          Provides a summary of the properties of a dataset export job. For a complete listing, call the `DescribeDatasetExportJob <https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html>`__ API.

          
          

          - **datasetExportJobArn** *(string) --* 

            The Amazon Resource Name (ARN) of the dataset export job.

            
          

          - **jobName** *(string) --* 

            The name of the dataset export job.

            
          

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

            The status of the dataset export job.

             

            A dataset export job can be in one of the following states:

             

            
            * CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
            

            
          

          - **creationDateTime** *(datetime) --* 

            The date and time (in Unix time) that the dataset export job was created.

            
          

          - **lastUpdatedDateTime** *(datetime) --* 

            The date and time (in Unix time) that the dataset export job status was last updated.

            
          

          - **failureReason** *(string) --* 

            If a dataset export job fails, the reason behind the failure.

            
      
    
      

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

        A token for getting the next set of dataset export jobs (if they exist).

        
  
  **Exceptions**
  
  *   :py:class:`Personalize.Client.exceptions.InvalidInputException`

  
  *   :py:class:`Personalize.Client.exceptions.InvalidNextTokenException`

  