Skip to main content

Asset Inventory Trend View V2 - POST

POST 
/v2/inventory/trend
deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Returns asset inventory pass/fail trends for the specified time period.

info

Replacement  Endpoint: Asset Inventory Trend View V3 - POST

You can get a list of the valid names and values for the filters body parameter through List Inventory Filters V2.

note

This endpoint will only be able to access data from the past 1 year. This change is implemented to optimize system performance and reduce data storage requirements of deprecated endpoints.

Request​

Body

    detailed boolean

    Detailed

    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

    Name

    operator string

    Possible values: [tag:yaml.org,2002:value =]

    Operator

    value string

    Value

  • ]
    • 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

    timeRange object

    See the Time Range Model for details.

    oneOf
    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

Responses​

success

Schema
  • Array [
    • criticalSeverityFailedResources int64

    The number of resources that failed critical severity policies

    criticalVulnerabilityFailedResources int64

    The number of resources that failed with critical vulnerabilities

    failedResources int64

    Number of failed resources

    highSeverityFailedResources int64

    The number of resources that failed high severity policies

    highVulnerabilityFailedResources int64

    The number of resources that failed with high vulnerabilities

    informationalSeverityFailedResources int64

    The number of resources that failed informational severity policies

    lowSeverityFailedResources int64

    The number of resources that failed low severity policies

    lowVulnerabilityFailedResources int64

    The number of resources that failed with low vulnerabilities

    mediumSeverityFailedResources int64

    The number of resources that failed medium severity policies

    mediumVulnerabilityFailedResources int64

    The number of resources that failed with medium vulnerabilities

    passedResources int64

    Number of passed resources

    timestamp int64

    Timestamp

    totalResources int64

    Total number of resources

    totalVulnerabilityFailedResources int64

    The total number of resources that failed with vulnerabilities

    unscannedResources int64

    Total number of unscanned resources

  • ]
Loading...