> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# vantage_kubernetes_efficiency_reports (Data Source)

> Terraform data source reference for vantage_kubernetes_efficiency_reports (Data Source). Auto-generated from the vantage-sh/terraform-provider-vantage repository.

<Note>
  This page is auto-generated based on the official [Terraform documentation](https://registry.terraform.io/providers/vantage-sh/vantage/latest/docs).
</Note>

## Overview

Use this data source with the [Vantage Terraform provider](/terraform). For installation and authentication, see the [Terraform provider quickstart](/terraform#quickstart). The schema below is generated directly from the provider source.

## Schema

### Read-Only

* `kubernetes_efficiency_reports` (Attributes List) (see [below for nested schema](#nestedatt--kubernetes_efficiency_reports))

<a id="nestedatt--kubernetes_efficiency_reports" />

### Nested Schema for `kubernetes_efficiency_reports`

Read-Only:

* `aggregated_by` (String) How costs are aggregated by. Possible values: idle\_cost, amount, cost\_efficiency.
* `created_at` (String) The date and time, in UTC, the report was created. ISO 8601 Formatted.
* `date_bucket` (String) How costs are grouped and displayed in the KubernetesEfficiencyReport. Possible values: day, week, month.
* `date_interval` (String) The date range for the KubernetesEfficiencyReport. Only present if a custom date range is not specified.
* `default` (Boolean) Indicates whether the KubernetesEfficiencyReport is the default report.
* `end_date` (String) The end date for the KubernetesEfficiencyReport. Only set for custom date ranges. ISO 8601 Formatted.
* `filter` (String) The filter applied to the KubernetesEfficiencyReport. Additional documentation available at [https://docs.vantage.sh/vql](https://docs.vantage.sh/vql).
* `groupings` (String) Grouping values for aggregating costs on the KubernetesEfficiencyReport. Valid groupings: cluster\_id, namespace, labeled, category, pod, label, `label:<label_name>`.
* `id` (String) The id of the resource
* `start_date` (String) The start date for the KubernetesEfficiencyReport. Only set for custom date ranges. ISO 8601 Formatted.
* `title` (String) The title of the KubernetesEfficiencyReport.
* `token` (String)
* `user_token` (String) The token for the User who created this KubernetesEfficiencyReport.
* `workspace_token` (String) The token for the Workspace the KubernetesEfficiencyReport is a part of.