:doc:`IoTAnalytics <../../iotanalytics>` / Client / get_dataset_content

*******************
get_dataset_content
*******************



.. py:method:: IoTAnalytics.Client.get_dataset_content(**kwargs)

  

  Retrieves the contents of a dataset as presigned URIs.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iotanalytics-2017-11-27/GetDatasetContent>`_  


  **Request Syntax**
  ::

    response = client.get_dataset_content(
        datasetName='string',
        versionId='string'
    )
    
  :type datasetName: string
  :param datasetName: **[REQUIRED]** 

    The name of the dataset whose contents are retrieved.

    

  
  :type versionId: string
  :param versionId: 

    The version of the dataset whose contents are retrieved. You can also use the strings "$LATEST" or "$LATEST_SUCCEEDED" to retrieve the contents of the latest or latest successfully completed dataset. If not specified, "$LATEST_SUCCEEDED" is the default.

    

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

    
    ::

      {
          'entries': [
              {
                  'entryName': 'string',
                  'dataURI': 'string'
              },
          ],
          'timestamp': datetime(2015, 1, 1),
          'status': {
              'state': 'CREATING'|'SUCCEEDED'|'FAILED',
              'reason': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **entries** *(list) --* 

        A list of ``DatasetEntry`` objects.

        
        

        - *(dict) --* 

          The reference to a dataset entry.

          
          

          - **entryName** *(string) --* 

            The name of the dataset item.

            
          

          - **dataURI** *(string) --* 

            The presigned URI of the dataset item.

            
      
    
      

      - **timestamp** *(datetime) --* 

        The time when the request was made.

        
      

      - **status** *(dict) --* 

        The status of the dataset content.

        
        

        - **state** *(string) --* 

          The state of the dataset contents. Can be one of READY, CREATING, SUCCEEDED, or FAILED.

          
        

        - **reason** *(string) --* 

          The reason the dataset contents are in this state.

          
    
  
  **Exceptions**
  
  *   :py:class:`IoTAnalytics.Client.exceptions.InvalidRequestException`

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

  
  *   :py:class:`IoTAnalytics.Client.exceptions.InternalFailureException`

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

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

  