class Aws::CostExplorer::Types::GetSavingsPlansUtilizationRequest

@note When making an API call, you may pass GetSavingsPlansUtilizationRequest

data as a hash:

    {
      time_period: { # required
        start: "YearMonthDay", # required
        end: "YearMonthDay", # required
      },
      granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
      filter: {
        or: [
          {
            # recursive Expression
          },
        ],
        and: [
          {
            # recursive Expression
          },
        ],
        not: {
          # recursive Expression
        },
        dimensions: {
          key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
          values: ["Value"],
          match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
        },
        tags: {
          key: "TagKey",
          values: ["Value"],
          match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
        },
        cost_categories: {
          key: "CostCategoryName",
          values: ["Value"],
          match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
        },
      },
      sort_by: {
        key: "SortDefinitionKey", # required
        sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
      },
    }

@!attribute [rw] time_period

The time period that you want the usage and costs for. The `Start`
date must be within 13 months. The `End` date must be after the
`Start` date, and before the current date. Future dates can't be
used as an `End` date.
@return [Types::DateInterval]

@!attribute [rw] granularity

The granularity of the Amazon Web Services utillization data for
your Savings Plans.

The `GetSavingsPlansUtilization` operation supports only `DAILY` and
`MONTHLY` granularities.
@return [String]

@!attribute [rw] filter

Filters Savings Plans utilization coverage data for active Savings
Plans dimensions. You can filter data with the following dimensions:

* `LINKED_ACCOUNT`

* `SAVINGS_PLAN_ARN`

* `SAVINGS_PLANS_TYPE`

* `REGION`

* `PAYMENT_OPTION`

* `INSTANCE_TYPE_FAMILY`

`GetSavingsPlansUtilization` uses the same [Expression][1] object as
the other operations, but only `AND` is supported among each
dimension.

[1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
@return [Types::Expression]

@!attribute [rw] sort_by

The value by which you want to sort the data.

The following values are supported for `Key`\:

* `UtilizationPercentage`

* `TotalCommitment`

* `UsedCommitment`

* `UnusedCommitment`

* `NetSavings`

Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
@return [Types::SortDefinition]

@see docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansUtilizationRequest AWS API Documentation

Constants

SENSITIVE