# Class QueryUsageHistoriesRequest (0.5.0)

0.5.0 (latest) 0.4.0 0.3.0 0.2.0 0.1.0

    QueryUsageHistoriesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The `QueryUsageHistories` request. Next : 16

| ## Attributes ||
|---|---|
| **Name** | **Description** |
| `parent` | `str` Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location} |
| `location_level` | `https://docs.cloud.google.com/python/docs/reference/google-cloud-capacityplanner/latest/google.cloud.capacityplanner_v1beta.types.TimeSeries.LocationType` Optional. The location level of the reservations usage timeseries. |
| `is_spot` | `bool` Optional. The is_spot flag is used to fetch the usage data for preemptible Resources. |
| `machine_family` | `str` The machine family for the `UsageHistory` values to return. Possible values include "n1", and "n2d". See https://cloud.google.com/compute/docs/machine-types for more examples. Empty machine_family will return results matching all machine families. |
| `machine_shape` | `https://docs.cloud.google.com/python/docs/reference/google-cloud-capacityplanner/latest/google.cloud.capacityplanner_v1beta.types.MachineShape` Optional. The machine shape for the `UsageHistory` values to return. |
| `disk_type` | `str` Optional. The disk_type for the `UsageHistory` values to return request with persistent-disk cloud_resource_type. Empty disk_type will return results matching all disk types. |
| `confidential_mode` | `bool` Optional. Whether the persistent disk is in confidential mode. |
| `gpu_type` | `str` Optional. The GPU type for the `UsageHistory` values to return. Sample values are "nvidia-tesla-t4", and "nvidia-tesla-a100". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs. |
| `tpu_type` | `str` Optional. The TPU type for the `UsageHistory` values to return. Empty tpu_type will return results matching all TPUs. |
| `cloud_resource_type` | `str` Required. The resource for the `UsageHistory` values to return. Possible values include "gce-vcpus", "gce-ram", "gce-local-ssd", "gce-persistent-disk", "gce-gpu" and "gce-tpu". Empty cloud_resource_type will return results matching all resources. |
| `usage_aggregation_method` | `https://docs.cloud.google.com/python/docs/reference/google-cloud-capacityplanner/latest/google.cloud.capacityplanner_v1beta.types.UsageHistory.AggregationMethod` The method that should be used to convert sampled usage data to daily usage values. AGGREGATION_METHOD_UNSPECIFIED will return results matching all the aggregation methods. |
| `start_date` | `google.type.date_pb2.Date` Optional. The start date of reservations usage. |
| `end_date` | `google.type.date_pb2.Date` Optional. The end date of reservations usage. |