Skip to content

Returns resource trend data based on the specified criteria

Description

Returns resource trend data based on the specified criteria. This operation helps you analyze patterns and changes in resource compliance over time.

Usage

securityhub_get_resources_trends_v2(Filters, StartTime, EndTime,
  NextToken, MaxResults)

Arguments

  • Filters

    The filters to apply to the resources trend data.

  • StartTime

    [required] The starting timestamp for the time period to analyze resources trends, in ISO 8601 format.

  • EndTime

    [required] The ending timestamp for the time period to analyze resources trends, in ISO 8601 format.

  • NextToken

    The token to use for paginating results. This value is returned in the response if more results are available.

  • MaxResults

    The maximum number of trend data points to return in a single response.

Value

A list with the following syntax:

list(
  Granularity = "Daily"|"Weekly"|"Monthly",
  TrendsMetrics = list(
    list(
      Timestamp = as.POSIXct(
        "2015-01-01"
      ),
      TrendsValues = list(
        ResourcesCount = list(
          AllResources = 123
        )
      )
    )
  ),
  NextToken = "string"
)

Request syntax

svc$get_resources_trends_v2(
  Filters = list(
    CompositeFilters = list(
      list(
        StringFilters = list(
          list(
            FieldName = "account_id"|"region"|"resource_type"|"resource_category"|"resource_cloud_provider"|"resource_region"|"resource_owner_id"|"resource_owner_organization_id",
            Filter = list(
              Value = "string",
              Comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS"|"PREFIX_NOT_EQUALS"|"CONTAINS"|"NOT_CONTAINS"|"CONTAINS_WORD"
            )
          )
        ),
        NestedCompositeFilters = list(),
        Operator = "AND"|"OR"
      )
    ),
    CompositeOperator = "AND"|"OR"
  ),
  StartTime = as.POSIXct(
    "2015-01-01"
  ),
  EndTime = as.POSIXct(
    "2015-01-01"
  ),
  NextToken = "string",
  MaxResults = 123
)