IoTSiteWise / Paginator / ListDatasetDataSegments

ListDatasetDataSegments¶

class IoTSiteWise.Paginator.ListDatasetDataSegments¶

paginator = client.get_paginator('list_dataset_data_segments')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from IoTSiteWise.Client.list_dataset_data_segments().

Request Syntax

response_iterator = paginator.paginate(
    datasetId='string',
    workspaceName='string',
    datasetVersion='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

datasetId (string) –
[REQUIRED]

The ID of the dataset.
workspaceName (string) –
[REQUIRED]

The name of the workspace that contains the dataset.
datasetVersion (string) – The version of the dataset to list data segments for.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'dataSegments': [
        {
            'sourceDatasetId': 'string',
            'timeSeriesId': 'string',
            'startTimestamp': {
                'timeInSeconds': 123,
                'offsetInNanos': 123
            },
            'endTimestamp': {
                'timeInSeconds': 123,
                'offsetInNanos': 123
            },
            'alias': 'string',
            'dataType': 'STRING'|'INTEGER'|'DOUBLE'|'BOOLEAN'|'STRUCT'|'VIDEO'|'ANNOTATION'|'JSON',
            'enrichment': {
                'status': 'ENRICHED'|'NOT_ENRICHED',
                'lastEnrichedAt': datetime(2015, 1, 1)
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- dataSegments (list) –
  
  A list that summarizes each data segment.
  - (dict) –
    
    Contains summary information about a data segment, including its source dataset, time series, timestamp range, and enrichment status.
    - sourceDatasetId (string) –
      
      The ID of the source dataset that contains the data segment.
    - timeSeriesId (string) –
      
      The ID of the time series.
    - startTimestamp (dict) –
      
      The nanosecond-precision start time of the data segment.
      - 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.
    - endTimestamp (dict) –
      
      The nanosecond-precision end time of the data segment.
      - 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.
    - alias (string) –
      
      The alias of the time series.
    - dataType (string) –
      
      The data type of the time series.
    - enrichment (dict) –
      
      The enrichment information for the data segment.
      - status (string) –
        
        The enrichment status of the data segment.
      - lastEnrichedAt (datetime) –
        
        The date the data segment was last enriched, in Unix epoch time.
- NextToken (string) –
  
  A token to resume pagination.