:doc:`Connect <../../connect>` / Client / list_data_table_values

**********************
list_data_table_values
**********************



.. py:method:: Connect.Client.list_data_table_values(**kwargs)

  

  Lists values stored in a data table with optional filtering by record IDs or primary attribute values. Returns the raw stored values along with metadata such as lock versions and modification timestamps.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListDataTableValues>`_  


  **Request Syntax**
  ::

    response = client.list_data_table_values(
        InstanceId='string',
        DataTableId='string',
        RecordIds=[
            'string',
        ],
        PrimaryAttributeValues=[
            {
                'AttributeName': 'string',
                'Values': [
                    'string',
                ]
            },
        ],
        NextToken='string',
        MaxResults=123
    )
    
  :type InstanceId: string
  :param InstanceId: **[REQUIRED]** 

    The unique identifier for the Amazon Connect instance.

    

  
  :type DataTableId: string
  :param DataTableId: **[REQUIRED]** 

    The unique identifier for the data table whose values should be listed.

    

  
  :type RecordIds: list
  :param RecordIds: 

    Optional list of specific record IDs to retrieve values for.

    

  
    - *(string) --* 

    

  :type PrimaryAttributeValues: list
  :param PrimaryAttributeValues: 

    Optional filter to retrieve values for records matching specific primary attribute criteria.

    

  
    - *(dict) --* 

      A primary attribute value filter.

      

    
      - **AttributeName** *(string) --* **[REQUIRED]** 

        The filter's attribute name.

        

      
      - **Values** *(list) --* **[REQUIRED]** 

        The filter's values.

        

      
        - *(string) --* 

        
    
    

  :type NextToken: string
  :param NextToken: 

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

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of data table values to return in one page of results.

    

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

    
    ::

      {
          'NextToken': 'string',
          'Values': [
              {
                  'RecordId': 'string',
                  'AttributeId': 'string',
                  'PrimaryValues': [
                      {
                          'AttributeName': 'string',
                          'AttributeId': 'string',
                          'Value': 'string'
                      },
                  ],
                  'AttributeName': 'string',
                  'ValueType': 'TEXT'|'NUMBER'|'BOOLEAN'|'TEXT_LIST'|'NUMBER_LIST',
                  'Value': 'string',
                  'LockVersion': {
                      'DataTable': 'string',
                      'Attribute': 'string',
                      'PrimaryValues': 'string',
                      'Value': 'string'
                  },
                  'LastModifiedTime': datetime(2015, 1, 1),
                  'LastModifiedRegion': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **NextToken** *(string) --* 

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

        
      

      - **Values** *(list) --* 

        A list of data table values with their associated metadata, lock versions, and modification details.

        
        

        - *(dict) --* 

          A data table value summary.

          
          

          - **RecordId** *(string) --* 

            The summary's record ID.

            
          

          - **AttributeId** *(string) --* 

            The summary's attribute ID.

            
          

          - **PrimaryValues** *(list) --* 

            The summary's primary values.

            
            

            - *(dict) --* 

              A primary value response.

              
              

              - **AttributeName** *(string) --* 

                The value's attribute name.

                
              

              - **AttributeId** *(string) --* 

                The value's attribute ID.

                
              

              - **Value** *(string) --* 

                The value's value.

                
          
        
          

          - **AttributeName** *(string) --* 

            The summary's attribute name.

            
          

          - **ValueType** *(string) --* 

            The summary's value type.

            
          

          - **Value** *(string) --* 

            The summary's value.

            
          

          - **LockVersion** *(dict) --* 

            The summary's lock version.

            
            

            - **DataTable** *(string) --* 

              The lock version for the data table itself. Used for optimistic locking and table versioning. Changes with each update to the table's metadata or structure.

              
            

            - **Attribute** *(string) --* 

              The lock version for a specific attribute. When the ValueLockLevel is ATTRIBUTE, this version changes when any value for the attribute changes. For other lock levels, it only changes when the attribute's properties are directly updated.

              
            

            - **PrimaryValues** *(string) --* 

              The lock version for a specific set of primary values (record). This includes the default record even if the table does not have any primary attributes. Used for record-level locking.

              
            

            - **Value** *(string) --* 

              The lock version for a specific value. Changes each time the individual value is modified. Used for the finest-grained locking control.

              
        
          

          - **LastModifiedTime** *(datetime) --* 

            The summary's last modified time.

            
          

          - **LastModifiedRegion** *(string) --* 

            The summary's last modified region.

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

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

  
  *   :py:class:`Connect.Client.exceptions.InternalServiceException`

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

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

  
  *   :py:class:`Connect.Client.exceptions.InvalidParameterException`

  