:doc:`MainframeModernization <../../m2>` / Client / list_data_sets

**************
list_data_sets
**************



.. py:method:: MainframeModernization.Client.list_data_sets(**kwargs)

  

  Lists the data sets imported for a specific application. In Amazon Web Services Mainframe Modernization, data sets are associated with applications deployed on runtime environments. This is known as importing data sets. Currently, Amazon Web Services Mainframe Modernization can import data sets into catalogs using `CreateDataSetImportTask <https://docs.aws.amazon.com/m2/latest/APIReference/API_CreateDataSetImportTask.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/m2-2021-04-28/ListDataSets>`_  


  **Request Syntax**
  ::

    response = client.list_data_sets(
        applicationId='string',
        maxResults=123,
        nameFilter='string',
        nextToken='string',
        prefix='string'
    )
    
  :type applicationId: string
  :param applicationId: **[REQUIRED]** 

    The unique identifier of the application for which you want to list the associated data sets.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of objects to return.

    

  
  :type nameFilter: string
  :param nameFilter: 

    Filter dataset name matching the specified pattern. Can use * and % as wild cards.

    

  
  :type nextToken: string
  :param nextToken: 

    A pagination token returned from a previous call to this operation. This specifies the next item to return. To return to the beginning of the list, exclude this parameter.

    

  
  :type prefix: string
  :param prefix: 

    The prefix of the data set name, which you can use to filter the list of data sets.

    

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

    
    ::

      {
          'dataSets': [
              {
                  'creationTime': datetime(2015, 1, 1),
                  'dataSetName': 'string',
                  'dataSetOrg': 'string',
                  'format': 'string',
                  'lastReferencedTime': datetime(2015, 1, 1),
                  'lastUpdatedTime': datetime(2015, 1, 1)
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **dataSets** *(list) --* 

        The list of data sets, containing information including the creation time, the data set name, the data set organization, the data set format, and the last time the data set was referenced or updated.

        
        

        - *(dict) --* 

          A subset of the possible data set attributes.

          
          

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

            The timestamp when the data set was created.

            
          

          - **dataSetName** *(string) --* 

            The name of the data set.

            
          

          - **dataSetOrg** *(string) --* 

            The type of data set. The only supported value is VSAM.

            
          

          - **format** *(string) --* 

            The format of the data set.

            
          

          - **lastReferencedTime** *(datetime) --* 

            The last time the data set was referenced.

            
          

          - **lastUpdatedTime** *(datetime) --* 

            The last time the data set was updated.

            
      
    
      

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

        If there are more items to return, this contains a token that is passed to a subsequent call to this operation to retrieve the next set of items.

        
  
  **Exceptions**
  
  *   :py:class:`MainframeModernization.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`MainframeModernization.Client.exceptions.ExecutionTimeoutException`

  
  *   :py:class:`MainframeModernization.Client.exceptions.ServiceUnavailableException`

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

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

  
  *   :py:class:`MainframeModernization.Client.exceptions.ConflictException`

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

  
  *   :py:class:`MainframeModernization.Client.exceptions.InternalServerException`

  