:doc:`IoTSiteWise <../../iotsitewise>` / Client / get_asset_property_value_history

********************************
get_asset_property_value_history
********************************



.. py:method:: IoTSiteWise.Client.get_asset_property_value_history(**kwargs)

  

  Gets the history of an asset property's values. For more information, see `Querying historical values <https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#historical-values>`__ in the *IoT SiteWise User Guide*.

   

  To identify an asset property, you must specify one of the following:

   

  
  * The ``assetId`` and ``propertyId`` of an asset property.
   
  * A ``propertyAlias``, which is a data stream alias (for example, ``/company/windfarm/3/turbine/7/temperature``). To define an asset property's alias, see `UpdateAssetProperty <https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html>`__.
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iotsitewise-2019-12-02/GetAssetPropertyValueHistory>`_  


  **Request Syntax**
  ::

    response = client.get_asset_property_value_history(
        assetId='string',
        propertyId='string',
        propertyAlias='string',
        startDate=datetime(2015, 1, 1),
        endDate=datetime(2015, 1, 1),
        qualities=[
            'GOOD'|'BAD'|'UNCERTAIN',
        ],
        timeOrdering='ASCENDING'|'DESCENDING',
        nextToken='string',
        maxResults=123
    )
    
  :type assetId: string
  :param assetId: 

    The ID of the asset, in UUID format.

    

  
  :type propertyId: string
  :param propertyId: 

    The ID of the asset property, in UUID format.

    

  
  :type propertyAlias: string
  :param propertyAlias: 

    The alias that identifies the property, such as an OPC-UA server data stream path (for example, ``/company/windfarm/3/turbine/7/temperature``). For more information, see `Mapping industrial data streams to asset properties <https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html>`__ in the *IoT SiteWise User Guide*.

    

  
  :type startDate: datetime
  :param startDate: 

    The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time.

    

  
  :type endDate: datetime
  :param endDate: 

    The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time.

    

  
  :type qualities: list
  :param qualities: 

    The quality by which to filter asset data.

    

  
    - *(string) --* 

    

  :type timeOrdering: string
  :param timeOrdering: 

    The chronological sorting order of the requested information.

     

    Default: ``ASCENDING``

    

  
  :type nextToken: string
  :param nextToken: 

    The token to be used for the next set of paginated results.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results to return for each paginated request. A result set is returned in the two cases, whichever occurs first.

     

    
    * The size of the result set is equal to 4 MB.
     
    * The number of data points in the result set is equal to the value of ``maxResults``. The maximum value of ``maxResults`` is 20000.
    

    

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

    
    ::

      {
          'assetPropertyValueHistory': [
              {
                  'value': {
                      'stringValue': 'string',
                      'integerValue': 123,
                      'doubleValue': 123.0,
                      'booleanValue': True|False,
                      'nullValue': {
                          'valueType': 'D'|'B'|'S'|'I'|'U'
                      }
                  },
                  'timestamp': {
                      'timeInSeconds': 123,
                      'offsetInNanos': 123
                  },
                  'quality': 'GOOD'|'BAD'|'UNCERTAIN'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **assetPropertyValueHistory** *(list) --* 

        The asset property's value history.

        
        

        - *(dict) --* 

          Contains asset property value information.

          
          

          - **value** *(dict) --* 

            The value of the asset property (see ``Variant``).

            
            

            - **stringValue** *(string) --* 

              Asset property data of type string (sequence of characters). The allowed pattern: "^$|[^\u0000-\u001F\u007F]+". The max length is 1024.

              
            

            - **integerValue** *(integer) --* 

              Asset property data of type integer (whole number).

              
            

            - **doubleValue** *(float) --* 

              Asset property data of type double (floating point number). The min value is -10^10. The max value is 10^10. Double.NaN is allowed.

              
            

            - **booleanValue** *(boolean) --* 

              Asset property data of type Boolean (true or false).

              
            

            - **nullValue** *(dict) --* 

              The type of null asset property data with BAD and UNCERTAIN qualities.

              
              

              - **valueType** *(string) --* 

                The type of null asset property data.

                
          
        
          

          - **timestamp** *(dict) --* 

            The timestamp of the asset property value.

            
            

            - **timeInSeconds** *(integer) --* 

              The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by ``offsetInNanos``.

              
            

            - **offsetInNanos** *(integer) --* 

              The nanosecond offset from ``timeInSeconds``.

              
        
          

          - **quality** *(string) --* 

            The quality of the asset property value.

            
      
    
      

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

        The token for the next set of results, or null if there are no additional results.

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

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

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

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

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

  