Skip to main content

Get Aggregate Data by History



Returns counts of objects that satisfy the given creation time window and other filters.



    detailed boolean


    fields string[]

    Array of specific fields to return

    filters object[]

    Filtering parameters.

    For filter names, refer to List Filters API.

    For filter values, refer to List filter suggestions.

    The only exception is resource.tagv2 filter name, provide filter value for it in the following format: "{"key":"'CustomerTagKey'","value":"'CustomerTagValue'"}"

  • Array [
  • name string


    operator string

    Possible values: [,2002:value =]


    value string


  • ]
  • groupBy string[]

    For asset or data inventory only. Group returned items by cloud.type, cloud.service, cloud.region, cloud.account, and/or resource.type

    limit number

    Maximum number of items to return. When data is paginated, maximum number of items per page.The maximum cannot exceed 10,000. The default is 10,000.

    offset number

    The number of items to skip before selecting items to return. Default is zero

    pageToken string

    Setting this pagination Token to the nextPageToken from a response object returns the next page of data

    sortBy string[]

    Array of sort properties. Append :asc or :desc to the key to sort by ascending or descending order respectively. Example sort properties are id:asc and timestamp:desc

    tableLevel int32required

    Possible values: [1, 2, 3]

    Table level

    timeRange object

    See the Time Range Model for details.

    relativeTimeType string

    Possible values: [BACKWARD, FORWARD]

    Direction in which to count time. Default = BACKWARD

    type string
    value objectrequired

    Model for RelativeTimeDuration

    amount int32

    Number of time units

    unit string

    Possible values: [minute, hour, day, week, month, year]

    Time unit

    type stringrequired

    Possible values: [absolute, relative, to_now]

    Time type

    type string
    value objectrequired

    Model for Time

    endTime int64

    End timestamp

    startTime int64

    Start timestamp



    malwareObjectsDelta int64

    Total malware objects changed

    objectsDelta int64

    Objects changes

    publicObjectsDelta int64

    Public objects changed

    publicResourcesDelta int64

    Public resources changed

    resourcesDelta int64

    Resources changed

    sensitiveObjectsDelta int64

    Sensitive objects changed

    totalMalwareObjects int64

    Total malware objects

    totalObjects int64

    Total objects

    totalPublicObjects int64

    Public objects

    totalPublicResources int64

    Public resources

    totalResources int64

    Total resources

    totalSensitiveObjects int64

    Sensitive objects