# SavingsPlansUtilizationQuery


Defines the parameters for querying Savings Plans utilization data, including time granularity and sorting preferences.

## Contents


 ** timeRange **   <a name="awscostmanagement-Type-bcmDashboards_SavingsPlansUtilizationQuery-timeRange"></a>
Defines a time period with explicit start and end times for data queries.  
Type: [DateTimeRange](API_bcmDashboards_DateTimeRange.md) object  
Required: Yes

 ** filter **   <a name="awscostmanagement-Type-bcmDashboards_SavingsPlansUtilizationQuery-filter"></a>
Defines complex filtering conditions using logical operators (`AND`, `OR`, `NOT`) and various filter types.  
Type: [Expression](API_bcmDashboards_Expression.md) object  
Required: No

 ** granularity **   <a name="awscostmanagement-Type-bcmDashboards_SavingsPlansUtilizationQuery-granularity"></a>
The time granularity of the retrieved data: `HOURLY`, `DAILY`, or `MONTHLY`.  
Type: String  
Valid Values: `HOURLY | DAILY | MONTHLY`   
Required: No

## See Also


For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-dashboards-2025-08-18/SavingsPlansUtilizationQuery) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-dashboards-2025-08-18/SavingsPlansUtilizationQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-dashboards-2025-08-18/SavingsPlansUtilizationQuery)