aws-sdk-costexplorer 1.14.0 → 1.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 409315673e3f4439b0affce0d2908c0ed5881438
-  data.tar.gz: dcb5d3fb122362b5c6ad12467ae399046d666e13
+  metadata.gz: bc63cbc556025b7b1c33a9118b0c287be028f0b0
+  data.tar.gz: d292dee516076e59ca70dba30112650866c75349
 SHA512:
-  metadata.gz: ba01d399dba6202fe8e9288f731b72184524ae47c993a11a58fe855b2393ee31af47277ffc4f96ccfdc79750d5699bcedf79560b5399b8c404e3a0587b364ea4
-  data.tar.gz: 1793bbfcc14f6931accd011d973a3da6e6c8ab2363b780e0bd10cf04c23efa2edf51fab9ffff48ce695cc5fa3dcd1be8ecad404dd07acfe9b4b06cfee02f5649
+  metadata.gz: baf979f00d62412578c7936ffe5d66e6a2bae5ecbda9fd3910f4dc0e4d5154e3df945f4265324738501e7b318f200763fa8891956c96f053b9a8ed6bf1560dd5
+  data.tar.gz: 31903476b566149ff61dfadb3738b848bd669d0486bf055fddfb59908bc75d98de2b254c0b63c0878bc4864e1cb91b7034fc8aab61d634356ffda6207fe11d5b

data/lib/aws-sdk-costexplorer.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
 # @service
 module Aws::CostExplorer
 
-  GEM_VERSION = '1.14.0'
+  GEM_VERSION = '1.15.0'
 
 end

data/lib/aws-sdk-costexplorer/client.rb

@@ -220,10 +220,14 @@ module Aws::CostExplorer
     # `UsageQuantity`, that you want the request to return. You can also
     # filter and group your data by various dimensions, such as `SERVICE` or
     # `AZ`, in a specific time range. For a complete list of valid
-    # dimensions, see the ` GetDimensionValues ` operation. Master accounts
+    # dimensions, see the [GetDimensionValues][1] operation. Master accounts
     # in an organization in AWS Organizations have access to all member
     # accounts.
     #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
+    #
     # @option params [Types::DateInterval] :time_period
     #   Sets the start and end dates for retrieving AWS costs. The start date
     #   is inclusive, but the end date is exclusive. For example, if `start`
@@ -236,6 +240,9 @@ module Aws::CostExplorer
     #   `Granularity` isn't set, the response object doesn't include the
     #   `Granularity`, either `MONTHLY` or `DAILY`.
     #
+    #   The `GetCostAndUsageRequest` operation supports only `DAILY` and
+    #   `MONTHLY` granularities.
+    #
     # @option params [Types::Expression] :filter
     #   Filters AWS costs by different dimensions. For example, you can
     #   specify `SERVICE` and `LINKED_ACCOUNT` and get the costs that are
@@ -258,10 +265,11 @@ module Aws::CostExplorer
     #
     #   <note markdown="1"> If you return the `UsageQuantity` metric, the service aggregates all
     #   usage numbers without taking into account the units. For example, if
-    #   you aggregate `usageQuantity` across all of EC2, the results aren't
-    #   meaningful because EC2 compute hours and data transfer are measured in
-    #   different units (for example, hours vs. GB). To get more meaningful
-    #   `UsageQuantity` metrics, filter by `UsageType` or `UsageTypeGroups`.
+    #   you aggregate `usageQuantity` across all of Amazon EC2, the results
+    #   aren't meaningful because Amazon EC2 compute hours and data transfer
+    #   are measured in different units (for example, hours vs. GB). To get
+    #   more meaningful `UsageQuantity` metrics, filter by `UsageType` or
+    #   `UsageTypeGroups`.
     #
     #    </note>
     #
@@ -395,6 +403,9 @@ module Aws::CostExplorer
     #   How granular you want the forecast to be. You can get 3 months of
     #   `DAILY` forecasts or 12 months of `MONTHLY` forecasts.
     #
+    #   The `GetCostForecast` operation supports only `DAILY` and `MONTHLY`
+    #   granularities.
+    #
     # @option params [Types::Expression] :filter
     #   The filters that you want to use to filter your forecast. Cost
     #   Explorer API supports all of the Cost Explorer filters.
@@ -482,8 +493,8 @@ module Aws::CostExplorer
     #   `2017-04-30` but not including `2017-05-01`.
     #
     # @option params [required, String] :dimension
-    #   The name of the dimension. Each `Dimension` is available for different
-    #   a `Context`. For more information, see `Context`.
+    #   The name of the dimension. Each `Dimension` is available for a
+    #   different `Context`. For more information, see `Context`.
     #
     # @option params [String] :context
     #   The context for the call to `GetDimensionValues`. This can be
@@ -491,7 +502,7 @@ module Aws::CostExplorer
     #   `COST_AND_USAGE`. If the context is set to `RESERVATIONS`, the
     #   resulting dimension values can be used in the
     #   `GetReservationUtilization` operation. If the context is set to
-    #   `COST_AND_USAGE` the resulting dimension values can be used in the
+    #   `COST_AND_USAGE`, the resulting dimension values can be used in the
     #   `GetCostAndUsage` operation.
     #
     #   If you set the context to `COST_AND_USAGE`, you can use the following
@@ -502,7 +513,7 @@ module Aws::CostExplorer
     #   * DATABASE\_ENGINE - The Amazon Relational Database Service database.
     #     Examples are Aurora or MySQL.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #   * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
     #     `m4.xlarge`.
     #
     #   * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
@@ -518,7 +529,8 @@ module Aws::CostExplorer
     #   * OPERATION - The action performed. Examples include `RunInstance` and
     #     `CreateBucket`.
     #
-    #   * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
+    #   * PLATFORM - The Amazon EC2 operating system. Examples are Windows or
+    #     Linux.
     #
     #   * PURCHASE\_TYPE - The reservation type of the purchase to which this
     #     usage is related. Examples include On-Demand Instances and Standard
@@ -531,7 +543,7 @@ module Aws::CostExplorer
     #     operation includes a unit attribute. Examples include GB and Hrs.
     #
     #   * USAGE\_TYPE\_GROUP - The grouping of common usage types. An example
-    #     is EC2: CloudWatch – Alarms. The response for this operation
+    #     is Amazon EC2: CloudWatch – Alarms. The response for this operation
     #     includes a unit attribute.
     #
     #   * RECORD\_TYPE - The different types of charges such as RI fees, usage
@@ -548,14 +560,15 @@ module Aws::CostExplorer
     #   * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database Service
     #     deployments. Valid values are `SingleAZ` and `MultiAZ`.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #   * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
     #     `m4.xlarge`.
     #
     #   * LINKED\_ACCOUNT - The description in the attribute map that includes
     #     the full name of the member account. The value field contains the
     #     AWS ID of the member account.
     #
-    #   * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
+    #   * PLATFORM - The Amazon EC2 operating system. Examples are Windows or
+    #     Linux.
     #
     #   * REGION - The AWS Region.
     #
@@ -612,7 +625,7 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Retrieves the reservation coverage for your account. This allows you
+    # Retrieves the reservation coverage for your account. This enables you
     # to see how much of your Amazon Elastic Compute Cloud, Amazon
     # ElastiCache, Amazon Relational Database Service, or Amazon Redshift
     # usage is covered by a reservation. An organization's master account
@@ -648,13 +661,13 @@ module Aws::CostExplorer
     # `GetDimensionValues` operation.
     #
     # @option params [required, Types::DateInterval] :time_period
-    #   The start and end dates of the period for which you want to retrieve
-    #   data about reservation coverage. You can retrieve data for a maximum
-    #   of 13 months: the last 12 months and the current month. The start date
-    #   is inclusive, but the end date is exclusive. For example, if `start`
-    #   is `2017-01-01` and `end` is `2017-05-01`, then the cost and usage
-    #   data is retrieved from `2017-01-01` up to and including `2017-04-30`
-    #   but not including `2017-05-01`.
+    #   The start and end dates of the period that you want to retrieve data
+    #   about reservation coverage for. You can retrieve data for a maximum of
+    #   13 months: the last 12 months and the current month. The start date is
+    #   inclusive, but the end date is exclusive. For example, if `start` is
+    #   `2017-01-01` and `end` is `2017-05-01`, then the cost and usage data
+    #   is retrieved from `2017-01-01` up to and including `2017-04-30` but
+    #   not including `2017-05-01`.
     #
     # @option params [Array<Types::GroupDefinition>] :group_by
     #   You can group the data by the following attributes:
@@ -689,6 +702,9 @@ module Aws::CostExplorer
     #   isn't set, the response object doesn't include `Granularity`, either
     #   `MONTHLY` or `DAILY`.
     #
+    #   The `GetReservationCoverage` operation supports only `DAILY` and
+    #   `MONTHLY` granularities.
+    #
     # @option params [Types::Expression] :filter
     #   Filters utilization data by dimensions. You can filter by the
     #   following dimensions:
@@ -717,7 +733,7 @@ module Aws::CostExplorer
     #
     #   * TENANCY
     #
-    #   `GetReservationCoverage` uses the same ` Expression ` object as the
+    #   `GetReservationCoverage` uses the same [Expression][1] object as the
     #   other operations, but only `AND` is supported among each dimension.
     #   You can nest only one level deep. If there are multiple values for a
     #   dimension, they are OR'd together.
@@ -725,6 +741,12 @@ module Aws::CostExplorer
     #   If you don't provide a `SERVICE` filter, Cost Explorer defaults to
     #   EC2.
     #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
+    #
+    # @option params [Array<String>] :metrics
+    #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
     #   when the response from a previous call has more results than the
@@ -773,6 +795,7 @@ module Aws::CostExplorer
     #         values: ["Value"],
     #       },
     #     },
+    #     metrics: ["MetricName"],
     #     next_page_token: "NextPageToken",
     #   })
     #
@@ -788,14 +811,29 @@ module Aws::CostExplorer
     #   resp.coverages_by_time[0].groups[0].coverage.coverage_hours.reserved_hours #=> String
     #   resp.coverages_by_time[0].groups[0].coverage.coverage_hours.total_running_hours #=> String
     #   resp.coverages_by_time[0].groups[0].coverage.coverage_hours.coverage_hours_percentage #=> String
+    #   resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.on_demand_normalized_units #=> String
+    #   resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.reserved_normalized_units #=> String
+    #   resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.total_running_normalized_units #=> String
+    #   resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.coverage_normalized_units_percentage #=> String
+    #   resp.coverages_by_time[0].groups[0].coverage.coverage_cost.on_demand_cost #=> String
     #   resp.coverages_by_time[0].total.coverage_hours.on_demand_hours #=> String
     #   resp.coverages_by_time[0].total.coverage_hours.reserved_hours #=> String
     #   resp.coverages_by_time[0].total.coverage_hours.total_running_hours #=> String
     #   resp.coverages_by_time[0].total.coverage_hours.coverage_hours_percentage #=> String
+    #   resp.coverages_by_time[0].total.coverage_normalized_units.on_demand_normalized_units #=> String
+    #   resp.coverages_by_time[0].total.coverage_normalized_units.reserved_normalized_units #=> String
+    #   resp.coverages_by_time[0].total.coverage_normalized_units.total_running_normalized_units #=> String
+    #   resp.coverages_by_time[0].total.coverage_normalized_units.coverage_normalized_units_percentage #=> String
+    #   resp.coverages_by_time[0].total.coverage_cost.on_demand_cost #=> String
     #   resp.total.coverage_hours.on_demand_hours #=> String
     #   resp.total.coverage_hours.reserved_hours #=> String
     #   resp.total.coverage_hours.total_running_hours #=> String
     #   resp.total.coverage_hours.coverage_hours_percentage #=> String
+    #   resp.total.coverage_normalized_units.on_demand_normalized_units #=> String
+    #   resp.total.coverage_normalized_units.reserved_normalized_units #=> String
+    #   resp.total.coverage_normalized_units.total_running_normalized_units #=> String
+    #   resp.total.coverage_normalized_units.coverage_normalized_units_percentage #=> String
+    #   resp.total.coverage_cost.on_demand_cost #=> String
     #   resp.next_page_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationCoverage AWS API Documentation
@@ -818,15 +856,15 @@ module Aws::CostExplorer
     # category of usage to identify the best number of each type of RI to
     # purchase to maximize your estimated savings.
     #
-    # For example, AWS automatically aggregates your EC2 Linux, shared
-    # tenancy, and c4 family usage in the US West (Oregon) Region and
+    # For example, AWS automatically aggregates your Amazon EC2 Linux,
+    # shared tenancy, and c4 family usage in the US West (Oregon) Region and
     # recommends that you buy size-flexible regional reservations to apply
     # to the c4 family usage. AWS recommends the smallest size instance in
     # an instance family. This makes it easier to purchase a size-flexible
     # RI. AWS also shows the equal number of normalized units so that you
     # can purchase any instance size that you want. For this example, your
-    # RI recommendation would be for `c4.large`, because that is the
-    # smallest size instance in the c4 instance family.
+    # RI recommendation would be for `c4.large` because that is the smallest
+    # size instance in the c4 instance family.
     #
     # @option params [String] :account_id
     #   The account ID that is associated with the recommendation.
@@ -854,7 +892,8 @@ module Aws::CostExplorer
     #
     # @option params [Types::ServiceSpecification] :service_specification
     #   The hardware specifications for the service instances that you want
-    #   recommendations for, such as standard or convertible EC2 instances.
+    #   recommendations for, such as standard or convertible Amazon EC2
+    #   instances.
     #
     # @option params [Integer] :page_size
     #   The number of recommendations that you want returned in a single
@@ -971,12 +1010,11 @@ module Aws::CostExplorer
     # Currently, you can group only by `SUBSCRIPTION_ID`.
     #
     # @option params [required, Types::DateInterval] :time_period
-    #   Sets the start and end dates for retrieving Reserved Instance (RI)
-    #   utilization. The start date is inclusive, but the end date is
-    #   exclusive. For example, if `start` is `2017-01-01` and `end` is
-    #   `2017-05-01`, then the cost and usage data is retrieved from
-    #   `2017-01-01` up to and including `2017-04-30` but not including
-    #   `2017-05-01`.
+    #   Sets the start and end dates for retrieving RI utilization. The start
+    #   date is inclusive, but the end date is exclusive. For example, if
+    #   `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost and
+    #   usage data is retrieved from `2017-01-01` up to and including
+    #   `2017-04-30` but not including `2017-05-01`.
     #
     # @option params [Array<Types::GroupDefinition>] :group_by
     #   Groups only by `SUBSCRIPTION_ID`. Metadata is included.
@@ -987,6 +1025,9 @@ module Aws::CostExplorer
     #   `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity` aren't set,
     #   `GetReservationUtilization` defaults to `DAILY`.
     #
+    #   The `GetReservationUtilization` operation supports only `DAILY` and
+    #   `MONTHLY` granularities.
+    #
     # @option params [Types::Expression] :filter
     #   Filters utilization data by dimensions. You can filter by the
     #   following dimensions:
@@ -1015,10 +1056,14 @@ module Aws::CostExplorer
     #
     #   * TENANCY
     #
-    #   `GetReservationUtilization` uses the same ` Expression ` object as the
-    #   other operations, but only `AND` is supported among each dimension,
-    #   and nesting is supported up to only one level deep. If there are
-    #   multiple values for a dimension, they are OR'd together.
+    #   `GetReservationUtilization` uses the same [Expression][1] object as
+    #   the other operations, but only `AND` is supported among each
+    #   dimension, and nesting is supported up to only one level deep. If
+    #   there are multiple values for a dimension, they are OR'd together.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
     #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
@@ -1082,9 +1127,13 @@ module Aws::CostExplorer
     #   resp.utilizations_by_time[0].groups[0].attributes #=> Hash
     #   resp.utilizations_by_time[0].groups[0].attributes["AttributeType"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #   resp.utilizations_by_time[0].groups[0].utilization.utilization_percentage #=> String
+    #   resp.utilizations_by_time[0].groups[0].utilization.utilization_percentage_in_units #=> String
     #   resp.utilizations_by_time[0].groups[0].utilization.purchased_hours #=> String
+    #   resp.utilizations_by_time[0].groups[0].utilization.purchased_units #=> String
     #   resp.utilizations_by_time[0].groups[0].utilization.total_actual_hours #=> String
+    #   resp.utilizations_by_time[0].groups[0].utilization.total_actual_units #=> String
     #   resp.utilizations_by_time[0].groups[0].utilization.unused_hours #=> String
+    #   resp.utilizations_by_time[0].groups[0].utilization.unused_units #=> String
     #   resp.utilizations_by_time[0].groups[0].utilization.on_demand_cost_of_ri_hours_used #=> String
     #   resp.utilizations_by_time[0].groups[0].utilization.net_ri_savings #=> String
     #   resp.utilizations_by_time[0].groups[0].utilization.total_potential_ri_savings #=> String
@@ -1092,9 +1141,13 @@ module Aws::CostExplorer
     #   resp.utilizations_by_time[0].groups[0].utilization.amortized_recurring_fee #=> String
     #   resp.utilizations_by_time[0].groups[0].utilization.total_amortized_fee #=> String
     #   resp.utilizations_by_time[0].total.utilization_percentage #=> String
+    #   resp.utilizations_by_time[0].total.utilization_percentage_in_units #=> String
     #   resp.utilizations_by_time[0].total.purchased_hours #=> String
+    #   resp.utilizations_by_time[0].total.purchased_units #=> String
     #   resp.utilizations_by_time[0].total.total_actual_hours #=> String
+    #   resp.utilizations_by_time[0].total.total_actual_units #=> String
     #   resp.utilizations_by_time[0].total.unused_hours #=> String
+    #   resp.utilizations_by_time[0].total.unused_units #=> String
     #   resp.utilizations_by_time[0].total.on_demand_cost_of_ri_hours_used #=> String
     #   resp.utilizations_by_time[0].total.net_ri_savings #=> String
     #   resp.utilizations_by_time[0].total.total_potential_ri_savings #=> String
@@ -1102,9 +1155,13 @@ module Aws::CostExplorer
     #   resp.utilizations_by_time[0].total.amortized_recurring_fee #=> String
     #   resp.utilizations_by_time[0].total.total_amortized_fee #=> String
     #   resp.total.utilization_percentage #=> String
+    #   resp.total.utilization_percentage_in_units #=> String
     #   resp.total.purchased_hours #=> String
+    #   resp.total.purchased_units #=> String
     #   resp.total.total_actual_hours #=> String
+    #   resp.total.total_actual_units #=> String
     #   resp.total.unused_hours #=> String
+    #   resp.total.unused_units #=> String
     #   resp.total.on_demand_cost_of_ri_hours_used #=> String
     #   resp.total.net_ri_savings #=> String
     #   resp.total.total_potential_ri_savings #=> String
@@ -1192,7 +1249,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.14.0'
+      context[:gem_version] = '1.15.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-costexplorer/client_api.rb

@@ -21,8 +21,11 @@ module Aws::CostExplorer
     Context = Shapes::StringShape.new(name: 'Context')
     Coverage = Shapes::StructureShape.new(name: 'Coverage')
     CoverageByTime = Shapes::StructureShape.new(name: 'CoverageByTime')
+    CoverageCost = Shapes::StructureShape.new(name: 'CoverageCost')
     CoverageHours = Shapes::StructureShape.new(name: 'CoverageHours')
     CoverageHoursPercentage = Shapes::StringShape.new(name: 'CoverageHoursPercentage')
+    CoverageNormalizedUnits = Shapes::StructureShape.new(name: 'CoverageNormalizedUnits')
+    CoverageNormalizedUnitsPercentage = Shapes::StringShape.new(name: 'CoverageNormalizedUnitsPercentage')
     CoveragesByTime = Shapes::ListShape.new(name: 'CoveragesByTime')
     DataUnavailableException = Shapes::StructureShape.new(name: 'DataUnavailableException')
     DateInterval = Shapes::StructureShape.new(name: 'DateInterval')
@@ -81,12 +84,15 @@ module Aws::CostExplorer
     NextPageToken = Shapes::StringShape.new(name: 'NextPageToken')
     NonNegativeInteger = Shapes::IntegerShape.new(name: 'NonNegativeInteger')
     OfferingClass = Shapes::StringShape.new(name: 'OfferingClass')
+    OnDemandCost = Shapes::StringShape.new(name: 'OnDemandCost')
     OnDemandCostOfRIHoursUsed = Shapes::StringShape.new(name: 'OnDemandCostOfRIHoursUsed')
     OnDemandHours = Shapes::StringShape.new(name: 'OnDemandHours')
+    OnDemandNormalizedUnits = Shapes::StringShape.new(name: 'OnDemandNormalizedUnits')
     PageSize = Shapes::IntegerShape.new(name: 'PageSize')
     PaymentOption = Shapes::StringShape.new(name: 'PaymentOption')
     PredictionIntervalLevel = Shapes::IntegerShape.new(name: 'PredictionIntervalLevel')
     PurchasedHours = Shapes::StringShape.new(name: 'PurchasedHours')
+    PurchasedUnits = Shapes::StringShape.new(name: 'PurchasedUnits')
     RDSInstanceDetails = Shapes::StructureShape.new(name: 'RDSInstanceDetails')
     RedshiftInstanceDetails = Shapes::StructureShape.new(name: 'RedshiftInstanceDetails')
     RequestChangedException = Shapes::StructureShape.new(name: 'RequestChangedException')
@@ -104,6 +110,7 @@ module Aws::CostExplorer
     ReservationUtilizationGroup = Shapes::StructureShape.new(name: 'ReservationUtilizationGroup')
     ReservationUtilizationGroups = Shapes::ListShape.new(name: 'ReservationUtilizationGroups')
     ReservedHours = Shapes::StringShape.new(name: 'ReservedHours')
+    ReservedNormalizedUnits = Shapes::StringShape.new(name: 'ReservedNormalizedUnits')
     ResultByTime = Shapes::StructureShape.new(name: 'ResultByTime')
     ResultsByTime = Shapes::ListShape.new(name: 'ResultsByTime')
     SearchString = Shapes::StringShape.new(name: 'SearchString')
@@ -113,12 +120,16 @@ module Aws::CostExplorer
     TagValues = Shapes::StructureShape.new(name: 'TagValues')
     TermInYears = Shapes::StringShape.new(name: 'TermInYears')
     TotalActualHours = Shapes::StringShape.new(name: 'TotalActualHours')
+    TotalActualUnits = Shapes::StringShape.new(name: 'TotalActualUnits')
     TotalAmortizedFee = Shapes::StringShape.new(name: 'TotalAmortizedFee')
     TotalPotentialRISavings = Shapes::StringShape.new(name: 'TotalPotentialRISavings')
     TotalRunningHours = Shapes::StringShape.new(name: 'TotalRunningHours')
+    TotalRunningNormalizedUnits = Shapes::StringShape.new(name: 'TotalRunningNormalizedUnits')
     UnusedHours = Shapes::StringShape.new(name: 'UnusedHours')
+    UnusedUnits = Shapes::StringShape.new(name: 'UnusedUnits')
     UtilizationByTime = Shapes::StructureShape.new(name: 'UtilizationByTime')
     UtilizationPercentage = Shapes::StringShape.new(name: 'UtilizationPercentage')
+    UtilizationPercentageInUnits = Shapes::StringShape.new(name: 'UtilizationPercentageInUnits')
     UtilizationsByTime = Shapes::ListShape.new(name: 'UtilizationsByTime')
     Value = Shapes::StringShape.new(name: 'Value')
     Values = Shapes::ListShape.new(name: 'Values')
@@ -128,6 +139,8 @@ module Aws::CostExplorer
     Attributes.value = Shapes::ShapeRef.new(shape: AttributeValue)
 
     Coverage.add_member(:coverage_hours, Shapes::ShapeRef.new(shape: CoverageHours, location_name: "CoverageHours"))
+    Coverage.add_member(:coverage_normalized_units, Shapes::ShapeRef.new(shape: CoverageNormalizedUnits, location_name: "CoverageNormalizedUnits"))
+    Coverage.add_member(:coverage_cost, Shapes::ShapeRef.new(shape: CoverageCost, location_name: "CoverageCost"))
     Coverage.struct_class = Types::Coverage
 
     CoverageByTime.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, location_name: "TimePeriod"))
@@ -135,12 +148,21 @@ module Aws::CostExplorer
     CoverageByTime.add_member(:total, Shapes::ShapeRef.new(shape: Coverage, location_name: "Total"))
     CoverageByTime.struct_class = Types::CoverageByTime
 
+    CoverageCost.add_member(:on_demand_cost, Shapes::ShapeRef.new(shape: OnDemandCost, location_name: "OnDemandCost"))
+    CoverageCost.struct_class = Types::CoverageCost
+
     CoverageHours.add_member(:on_demand_hours, Shapes::ShapeRef.new(shape: OnDemandHours, location_name: "OnDemandHours"))
     CoverageHours.add_member(:reserved_hours, Shapes::ShapeRef.new(shape: ReservedHours, location_name: "ReservedHours"))
     CoverageHours.add_member(:total_running_hours, Shapes::ShapeRef.new(shape: TotalRunningHours, location_name: "TotalRunningHours"))
     CoverageHours.add_member(:coverage_hours_percentage, Shapes::ShapeRef.new(shape: CoverageHoursPercentage, location_name: "CoverageHoursPercentage"))
     CoverageHours.struct_class = Types::CoverageHours
 
+    CoverageNormalizedUnits.add_member(:on_demand_normalized_units, Shapes::ShapeRef.new(shape: OnDemandNormalizedUnits, location_name: "OnDemandNormalizedUnits"))
+    CoverageNormalizedUnits.add_member(:reserved_normalized_units, Shapes::ShapeRef.new(shape: ReservedNormalizedUnits, location_name: "ReservedNormalizedUnits"))
+    CoverageNormalizedUnits.add_member(:total_running_normalized_units, Shapes::ShapeRef.new(shape: TotalRunningNormalizedUnits, location_name: "TotalRunningNormalizedUnits"))
+    CoverageNormalizedUnits.add_member(:coverage_normalized_units_percentage, Shapes::ShapeRef.new(shape: CoverageNormalizedUnitsPercentage, location_name: "CoverageNormalizedUnitsPercentage"))
+    CoverageNormalizedUnits.struct_class = Types::CoverageNormalizedUnits
+
     CoveragesByTime.member = Shapes::ShapeRef.new(shape: CoverageByTime)
 
     DateInterval.add_member(:start, Shapes::ShapeRef.new(shape: YearMonthDay, required: true, location_name: "Start"))
@@ -243,6 +265,7 @@ module Aws::CostExplorer
     GetReservationCoverageRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
     GetReservationCoverageRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
     GetReservationCoverageRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Expression, location_name: "Filter"))
+    GetReservationCoverageRequest.add_member(:metrics, Shapes::ShapeRef.new(shape: MetricNames, location_name: "Metrics"))
     GetReservationCoverageRequest.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
     GetReservationCoverageRequest.struct_class = Types::GetReservationCoverageRequest
 
@@ -340,9 +363,13 @@ module Aws::CostExplorer
     RedshiftInstanceDetails.struct_class = Types::RedshiftInstanceDetails
 
     ReservationAggregates.add_member(:utilization_percentage, Shapes::ShapeRef.new(shape: UtilizationPercentage, location_name: "UtilizationPercentage"))
+    ReservationAggregates.add_member(:utilization_percentage_in_units, Shapes::ShapeRef.new(shape: UtilizationPercentageInUnits, location_name: "UtilizationPercentageInUnits"))
     ReservationAggregates.add_member(:purchased_hours, Shapes::ShapeRef.new(shape: PurchasedHours, location_name: "PurchasedHours"))
+    ReservationAggregates.add_member(:purchased_units, Shapes::ShapeRef.new(shape: PurchasedUnits, location_name: "PurchasedUnits"))
     ReservationAggregates.add_member(:total_actual_hours, Shapes::ShapeRef.new(shape: TotalActualHours, location_name: "TotalActualHours"))
+    ReservationAggregates.add_member(:total_actual_units, Shapes::ShapeRef.new(shape: TotalActualUnits, location_name: "TotalActualUnits"))
     ReservationAggregates.add_member(:unused_hours, Shapes::ShapeRef.new(shape: UnusedHours, location_name: "UnusedHours"))
+    ReservationAggregates.add_member(:unused_units, Shapes::ShapeRef.new(shape: UnusedUnits, location_name: "UnusedUnits"))
     ReservationAggregates.add_member(:on_demand_cost_of_ri_hours_used, Shapes::ShapeRef.new(shape: OnDemandCostOfRIHoursUsed, location_name: "OnDemandCostOfRIHoursUsed"))
     ReservationAggregates.add_member(:net_ri_savings, Shapes::ShapeRef.new(shape: NetRISavings, location_name: "NetRISavings"))
     ReservationAggregates.add_member(:total_potential_ri_savings, Shapes::ShapeRef.new(shape: TotalPotentialRISavings, location_name: "TotalPotentialRISavings"))

data/lib/aws-sdk-costexplorer/types.rb

@@ -11,24 +11,35 @@ module Aws::CostExplorer
     # The amount of instance usage that a reservation covered.
     #
     # @!attribute [rw] coverage_hours
-    #   The amount of instance usage that a reservation covered, in hours.
+    #   The amount of instance usage that the reservation covered, in hours.
     #   @return [Types::CoverageHours]
     #
+    # @!attribute [rw] coverage_normalized_units
+    #   The amount of instance usage that the reservation covered, in
+    #   normalized units.
+    #   @return [Types::CoverageNormalizedUnits]
+    #
+    # @!attribute [rw] coverage_cost
+    #   The amount of cost that the reservation covered.
+    #   @return [Types::CoverageCost]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/Coverage AWS API Documentation
     #
     class Coverage < Struct.new(
-      :coverage_hours)
+      :coverage_hours,
+      :coverage_normalized_units,
+      :coverage_cost)
       include Aws::Structure
     end
 
     # Reservation coverage for a specified period, in hours.
     #
     # @!attribute [rw] time_period
-    #   The period over which this coverage was used.
+    #   The period that this coverage was used over.
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] groups
-    #   The groups of instances that are covered by a reservation.
+    #   The groups of instances that the reservation covered.
     #   @return [Array<Types::ReservationCoverageGroup>]
     #
     # @!attribute [rw] total
@@ -44,17 +55,29 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # How much it cost to run an instance.
+    #
+    # @!attribute [rw] on_demand_cost
+    #   How much an On-Demand instance cost.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageCost AWS API Documentation
+    #
+    class CoverageCost < Struct.new(
+      :on_demand_cost)
+      include Aws::Structure
+    end
+
     # How long a running instance either used a reservation or was
     # On-Demand.
     #
     # @!attribute [rw] on_demand_hours
-    #   The number of instance running hours that are covered by On-Demand
-    #   Instances.
+    #   The number of instance running hours that On-Demand Instances
+    #   covered.
     #   @return [String]
     #
     # @!attribute [rw] reserved_hours
-    #   The number of instance running hours that are covered by
-    #   reservations.
+    #   The number of instance running hours that reservations covered.
     #   @return [String]
     #
     # @!attribute [rw] total_running_hours
@@ -62,7 +85,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] coverage_hours_percentage
-    #   The percentage of instance hours that are covered by a reservation.
+    #   The percentage of instance hours that a reservation covered.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageHours AWS API Documentation
@@ -75,6 +98,51 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # The amount of instance usage, in normalized units. Normalized units
+    # enable you to see your EC2 usage for multiple sizes of instances in a
+    # uniform way. For example, suppose you run an xlarge instance and a
+    # 2xlarge instance. If you run both instances for the same amount of
+    # time, the 2xlarge instance uses twice as much of your reservation as
+    # the xlarge instance, even though both instances show only one
+    # instance-hour. Using normalized units instead of instance-hours, the
+    # xlarge instance used 8 normalized units, and the 2xlarge instance used
+    # 16 normalized units.
+    #
+    # For more information, see [Modifying Reserved Instances][1] in the
+    # *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ri-modifying.html
+    #
+    # @!attribute [rw] on_demand_normalized_units
+    #   The number of normalized units that are covered by On-Demand
+    #   Instances instead of a reservation.
+    #   @return [String]
+    #
+    # @!attribute [rw] reserved_normalized_units
+    #   The number of normalized units that a reservation covers.
+    #   @return [String]
+    #
+    # @!attribute [rw] total_running_normalized_units
+    #   The total number of normalized units that you used.
+    #   @return [String]
+    #
+    # @!attribute [rw] coverage_normalized_units_percentage
+    #   The percentage of your used instance normalized units that a
+    #   reservation covers.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageNormalizedUnits AWS API Documentation
+    #
+    class CoverageNormalizedUnits < Struct.new(
+      :on_demand_normalized_units,
+      :reserved_normalized_units,
+      :total_running_normalized_units,
+      :coverage_normalized_units_percentage)
+      include Aws::Structure
+    end
+
     # The time period that you want the usage and costs for.
     #
     # @note When making an API call, you may pass DateInterval
@@ -162,7 +230,8 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the EC2 instances that AWS recommends that you purchase.
+    # Details about the Amazon EC2 instances that AWS recommends that you
+    # purchase.
     #
     # @!attribute [rw] family
     #   The instance family of the recommended reservation.
@@ -191,7 +260,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] current_generation
-    #   Whether the recommendation is for a current generation instance.
+    #   Whether the recommendation is for a current-generation instance.
     #   @return [Boolean]
     #
     # @!attribute [rw] size_flex_eligible
@@ -212,7 +281,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The EC2 hardware specifications that you want AWS to provide
+    # The Amazon EC2 hardware specifications that you want AWS to provide
     # recommendations for.
     #
     # @note When making an API call, you may pass EC2Specification
@@ -234,7 +303,8 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the ES instances that AWS recommends that you purchase.
+    # Details about the Amazon ES instances that AWS recommends that you
+    # purchase.
     #
     # @!attribute [rw] instance_class
     #   The class of instance that AWS recommends.
@@ -249,7 +319,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] current_generation
-    #   Whether the recommendation is for a current generation instance.
+    #   Whether the recommendation is for a current-generation instance.
     #   @return [Boolean]
     #
     # @!attribute [rw] size_flex_eligible
@@ -267,8 +337,8 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the ElastiCache instances that AWS recommends that you
-    # purchase.
+    # Details about the Amazon ElastiCache instances that AWS recommends
+    # that you purchase.
     #
     # @!attribute [rw] family
     #   The instance family of the recommended reservation.
@@ -536,6 +606,9 @@ module Aws::CostExplorer
     #   Sets the AWS cost granularity to `MONTHLY` or `DAILY`. If
     #   `Granularity` isn't set, the response object doesn't include the
     #   `Granularity`, either `MONTHLY` or `DAILY`.
+    #
+    #   The `GetCostAndUsageRequest` operation supports only `DAILY` and
+    #   `MONTHLY` granularities.
     #   @return [String]
     #
     # @!attribute [rw] filter
@@ -561,11 +634,11 @@ module Aws::CostExplorer
     #
     #   <note markdown="1"> If you return the `UsageQuantity` metric, the service aggregates all
     #   usage numbers without taking into account the units. For example, if
-    #   you aggregate `usageQuantity` across all of EC2, the results aren't
-    #   meaningful because EC2 compute hours and data transfer are measured
-    #   in different units (for example, hours vs. GB). To get more
-    #   meaningful `UsageQuantity` metrics, filter by `UsageType` or
-    #   `UsageTypeGroups`.
+    #   you aggregate `usageQuantity` across all of Amazon EC2, the results
+    #   aren't meaningful because Amazon EC2 compute hours and data
+    #   transfer are measured in different units (for example, hours vs.
+    #   GB). To get more meaningful `UsageQuantity` metrics, filter by
+    #   `UsageType` or `UsageTypeGroups`.
     #
     #    </note>
     #
@@ -695,6 +768,9 @@ module Aws::CostExplorer
     # @!attribute [rw] granularity
     #   How granular you want the forecast to be. You can get 3 months of
     #   `DAILY` forecasts or 12 months of `MONTHLY` forecasts.
+    #
+    #   The `GetCostForecast` operation supports only `DAILY` and `MONTHLY`
+    #   granularities.
     #   @return [String]
     #
     # @!attribute [rw] filter
@@ -768,8 +844,8 @@ module Aws::CostExplorer
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] dimension
-    #   The name of the dimension. Each `Dimension` is available for
-    #   different a `Context`. For more information, see `Context`.
+    #   The name of the dimension. Each `Dimension` is available for a
+    #   different `Context`. For more information, see `Context`.
     #   @return [String]
     #
     # @!attribute [rw] context
@@ -778,7 +854,7 @@ module Aws::CostExplorer
     #   `COST_AND_USAGE`. If the context is set to `RESERVATIONS`, the
     #   resulting dimension values can be used in the
     #   `GetReservationUtilization` operation. If the context is set to
-    #   `COST_AND_USAGE` the resulting dimension values can be used in the
+    #   `COST_AND_USAGE`, the resulting dimension values can be used in the
     #   `GetCostAndUsage` operation.
     #
     #   If you set the context to `COST_AND_USAGE`, you can use the
@@ -789,7 +865,7 @@ module Aws::CostExplorer
     #   * DATABASE\_ENGINE - The Amazon Relational Database Service
     #     database. Examples are Aurora or MySQL.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #   * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
     #     `m4.xlarge`.
     #
     #   * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
@@ -805,8 +881,8 @@ module Aws::CostExplorer
     #   * OPERATION - The action performed. Examples include `RunInstance`
     #     and `CreateBucket`.
     #
-    #   * PLATFORM - The EC2 operating system. Examples are Windows or
-    #     Linux.
+    #   * PLATFORM - The Amazon EC2 operating system. Examples are Windows
+    #     or Linux.
     #
     #   * PURCHASE\_TYPE - The reservation type of the purchase to which
     #     this usage is related. Examples include On-Demand Instances and
@@ -819,7 +895,7 @@ module Aws::CostExplorer
     #     operation includes a unit attribute. Examples include GB and Hrs.
     #
     #   * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
-    #     example is EC2: CloudWatch – Alarms. The response for this
+    #     example is Amazon EC2: CloudWatch – Alarms. The response for this
     #     operation includes a unit attribute.
     #
     #   * RECORD\_TYPE - The different types of charges such as RI fees,
@@ -836,15 +912,15 @@ module Aws::CostExplorer
     #   * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database
     #     Service deployments. Valid values are `SingleAZ` and `MultiAZ`.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #   * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
     #     `m4.xlarge`.
     #
     #   * LINKED\_ACCOUNT - The description in the attribute map that
     #     includes the full name of the member account. The value field
     #     contains the AWS ID of the member account.
     #
-    #   * PLATFORM - The EC2 operating system. Examples are Windows or
-    #     Linux.
+    #   * PLATFORM - The Amazon EC2 operating system. Examples are Windows
+    #     or Linux.
     #
     #   * REGION - The AWS Region.
     #
@@ -877,7 +953,7 @@ module Aws::CostExplorer
 
     # @!attribute [rw] dimension_values
     #   The filters that you used to filter your request. Some dimensions
-    #   are available only for a specific context:
+    #   are available only for a specific context.
     #
     #   If you set the context to `COST_AND_USAGE`, you can use the
     #   following dimensions for searching:
@@ -887,7 +963,7 @@ module Aws::CostExplorer
     #   * DATABASE\_ENGINE - The Amazon Relational Database Service
     #     database. Examples are Aurora or MySQL.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #   * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
     #     `m4.xlarge`.
     #
     #   * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
@@ -903,8 +979,8 @@ module Aws::CostExplorer
     #   * OPERATION - The action performed. Examples include `RunInstance`
     #     and `CreateBucket`.
     #
-    #   * PLATFORM - The EC2 operating system. Examples are Windows or
-    #     Linux.
+    #   * PLATFORM - The Amazon EC2 operating system. Examples are Windows
+    #     or Linux.
     #
     #   * PURCHASE\_TYPE - The reservation type of the purchase to which
     #     this usage is related. Examples include On-Demand Instances and
@@ -917,7 +993,7 @@ module Aws::CostExplorer
     #     operation includes a unit attribute. Examples include GB and Hrs.
     #
     #   * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
-    #     example is EC2: CloudWatch – Alarms. The response for this
+    #     example is Amazon EC2: CloudWatch – Alarms. The response for this
     #     operation includes a unit attribute.
     #
     #   * RECORD\_TYPE - The different types of charges such as RI fees,
@@ -934,15 +1010,15 @@ module Aws::CostExplorer
     #   * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database
     #     Service deployments. Valid values are `SingleAZ` and `MultiAZ`.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #   * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
     #     `m4.xlarge`.
     #
     #   * LINKED\_ACCOUNT - The description in the attribute map that
     #     includes the full name of the member account. The value field
     #     contains the AWS ID of the member account.
     #
-    #   * PLATFORM - The EC2 operating system. Examples are Windows or
-    #     Linux.
+    #   * PLATFORM - The Amazon EC2 operating system. Examples are Windows
+    #     or Linux.
     #
     #   * REGION - The AWS Region.
     #
@@ -981,7 +1057,7 @@ module Aws::CostExplorer
     end
 
     # You can use the following request parameters to query for how much of
-    # your instance usage is covered by a reservation.
+    # your instance usage a reservation covered.
     #
     # @note When making an API call, you may pass GetReservationCoverageRequest
     #   data as a hash:
@@ -1021,12 +1097,13 @@ module Aws::CostExplorer
     #             values: ["Value"],
     #           },
     #         },
+    #         metrics: ["MetricName"],
     #         next_page_token: "NextPageToken",
     #       }
     #
     # @!attribute [rw] time_period
-    #   The start and end dates of the period for which you want to retrieve
-    #   data about reservation coverage. You can retrieve data for a maximum
+    #   The start and end dates of the period that you want to retrieve data
+    #   about reservation coverage for. You can retrieve data for a maximum
     #   of 13 months: the last 12 months and the current month. The start
     #   date is inclusive, but the end date is exclusive. For example, if
     #   `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost and
@@ -1067,6 +1144,9 @@ module Aws::CostExplorer
     #   If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
     #   isn't set, the response object doesn't include `Granularity`,
     #   either `MONTHLY` or `DAILY`.
+    #
+    #   The `GetReservationCoverage` operation supports only `DAILY` and
+    #   `MONTHLY` granularities.
     #   @return [String]
     #
     # @!attribute [rw] filter
@@ -1097,15 +1177,22 @@ module Aws::CostExplorer
     #
     #   * TENANCY
     #
-    #   `GetReservationCoverage` uses the same ` Expression ` object as the
+    #   `GetReservationCoverage` uses the same [Expression][1] object as the
     #   other operations, but only `AND` is supported among each dimension.
     #   You can nest only one level deep. If there are multiple values for a
     #   dimension, they are OR'd together.
     #
     #   If you don't provide a `SERVICE` filter, Cost Explorer defaults to
     #   EC2.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
     #   @return [Types::Expression]
     #
+    # @!attribute [rw] metrics
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] next_page_token
     #   The token to retrieve the next set of results. AWS provides the
     #   token when the response from a previous call has more results than
@@ -1119,6 +1206,7 @@ module Aws::CostExplorer
       :group_by,
       :granularity,
       :filter,
+      :metrics,
       :next_page_token)
       include Aws::Structure
     end
@@ -1128,7 +1216,7 @@ module Aws::CostExplorer
     #   @return [Array<Types::CoverageByTime>]
     #
     # @!attribute [rw] total
-    #   The total amount of instance usage that is covered by a reservation.
+    #   The total amount of instance usage that a reservation covered.
     #   @return [Types::Coverage]
     #
     # @!attribute [rw] next_page_token
@@ -1197,7 +1285,8 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] service_specification
     #   The hardware specifications for the service instances that you want
-    #   recommendations for, such as standard or convertible EC2 instances.
+    #   recommendations for, such as standard or convertible Amazon EC2
+    #   instances.
     #   @return [Types::ServiceSpecification]
     #
     # @!attribute [rw] page_size
@@ -1289,12 +1378,11 @@ module Aws::CostExplorer
     #       }
     #
     # @!attribute [rw] time_period
-    #   Sets the start and end dates for retrieving Reserved Instance (RI)
-    #   utilization. The start date is inclusive, but the end date is
-    #   exclusive. For example, if `start` is `2017-01-01` and `end` is
-    #   `2017-05-01`, then the cost and usage data is retrieved from
-    #   `2017-01-01` up to and including `2017-04-30` but not including
-    #   `2017-05-01`.
+    #   Sets the start and end dates for retrieving RI utilization. The
+    #   start date is inclusive, but the end date is exclusive. For example,
+    #   if `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost
+    #   and usage data is retrieved from `2017-01-01` up to and including
+    #   `2017-04-30` but not including `2017-05-01`.
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] group_by
@@ -1306,6 +1394,9 @@ module Aws::CostExplorer
     #   isn't set, the response object doesn't include `Granularity`,
     #   either `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity`
     #   aren't set, `GetReservationUtilization` defaults to `DAILY`.
+    #
+    #   The `GetReservationUtilization` operation supports only `DAILY` and
+    #   `MONTHLY` granularities.
     #   @return [String]
     #
     # @!attribute [rw] filter
@@ -1336,10 +1427,14 @@ module Aws::CostExplorer
     #
     #   * TENANCY
     #
-    #   `GetReservationUtilization` uses the same ` Expression ` object as
+    #   `GetReservationUtilization` uses the same [Expression][1] object as
     #   the other operations, but only `AND` is supported among each
     #   dimension, and nesting is supported up to only one level deep. If
     #   there are multiple values for a dimension, they are OR'd together.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] next_page_token
@@ -1360,11 +1455,11 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] utilizations_by_time
-    #   The amount of time that you utilized your RIs.
+    #   The amount of time that you used your RIs.
     #   @return [Array<Types::UtilizationByTime>]
     #
     # @!attribute [rw] total
-    #   The total amount of time that you utilized your RIs.
+    #   The total amount of time that you used your RIs.
     #   @return [Types::ReservationAggregates]
     #
     # @!attribute [rw] next_page_token
@@ -1455,7 +1550,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # One level of grouped data within the results.
+    # One level of grouped data in the results.
     #
     # @!attribute [rw] keys
     #   The keys that are included in this group.
@@ -1473,7 +1568,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Represents a group when you specify a group by criteria, or in the
+    # Represents a group when you specify a group by criteria or in the
     # response to a query with a specific grouping.
     #
     # @note When making an API call, you may pass GroupDefinition
@@ -1503,11 +1598,11 @@ module Aws::CostExplorer
     # Details about the instances that AWS recommends that you purchase.
     #
     # @!attribute [rw] ec2_instance_details
-    #   The EC2 instances that AWS recommends that you purchase.
+    #   The Amazon EC2 instances that AWS recommends that you purchase.
     #   @return [Types::EC2InstanceDetails]
     #
     # @!attribute [rw] rds_instance_details
-    #   The RDS instances that AWS recommends that you purchase.
+    #   The Amazon RDS instances that AWS recommends that you purchase.
     #   @return [Types::RDSInstanceDetails]
     #
     # @!attribute [rw] redshift_instance_details
@@ -1551,7 +1646,8 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the RDS instances that AWS recommends that you purchase.
+    # Details about the Amazon RDS instances that AWS recommends that you
+    # purchase.
     #
     # @!attribute [rw] family
     #   The instance family of the recommended reservation.
@@ -1584,7 +1680,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] current_generation
-    #   Whether the recommendation is for a current generation instance.
+    #   Whether the recommendation is for a current-generation instance.
     #   @return [Boolean]
     #
     # @!attribute [rw] size_flex_eligible
@@ -1622,7 +1718,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] current_generation
-    #   Whether the recommendation is for a current generation instance.
+    #   Whether the recommendation is for a current-generation instance.
     #   @return [Boolean]
     #
     # @!attribute [rw] size_flex_eligible
@@ -1640,30 +1736,54 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The aggregated numbers for your Reserved Instance (RI) usage.
+    # The aggregated numbers for your reservation usage.
     #
     # @!attribute [rw] utilization_percentage
-    #   The percentage of RI time that you used.
+    #   The percentage of reservation time that you used.
+    #   @return [String]
+    #
+    # @!attribute [rw] utilization_percentage_in_units
+    #   The percentage of Amazon EC2 reservation time that you used,
+    #   converted to normalized units. Normalized units are available only
+    #   for Amazon EC2 usage after November 11, 2017.
     #   @return [String]
     #
     # @!attribute [rw] purchased_hours
-    #   How many RI hours that you purchased.
+    #   How many reservation hours that you purchased.
+    #   @return [String]
+    #
+    # @!attribute [rw] purchased_units
+    #   How many Amazon EC2 reservation hours that you purchased, converted
+    #   to normalized units. Normalized units are available only for Amazon
+    #   EC2 usage after November 11, 2017.
     #   @return [String]
     #
     # @!attribute [rw] total_actual_hours
-    #   The total number of RI hours that you used.
+    #   The total number of reservation hours that you used.
+    #   @return [String]
+    #
+    # @!attribute [rw] total_actual_units
+    #   The total number of Amazon EC2 reservation hours that you used,
+    #   converted to normalized units. Normalized units are available only
+    #   for Amazon EC2 usage after November 11, 2017.
     #   @return [String]
     #
     # @!attribute [rw] unused_hours
-    #   The number of RI hours that you didn't use.
+    #   The number of reservation hours that you didn't use.
+    #   @return [String]
+    #
+    # @!attribute [rw] unused_units
+    #   The number of Amazon EC2 reservation hours that you didn't use,
+    #   converted to normalized units. Normalized units are available only
+    #   for Amazon EC2 usage after November 11, 2017.
     #   @return [String]
     #
     # @!attribute [rw] on_demand_cost_of_ri_hours_used
-    #   How much your RIs would cost if charged On-Demand rates.
+    #   How much your reservation would cost if charged On-Demand rates.
     #   @return [String]
     #
     # @!attribute [rw] net_ri_savings
-    #   How much you saved due to purchasing and utilizing RIs. AWS
+    #   How much you saved due to purchasing and utilizing reservation. AWS
     #   calculates this by subtracting `TotalAmortizedFee` from
     #   `OnDemandCostOfRIHoursUsed`.
     #   @return [String]
@@ -1673,24 +1793,31 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] amortized_upfront_fee
-    #   The upfront cost of your RI, amortized over the RI period.
+    #   The upfront cost of your reservation, amortized over the reservation
+    #   period.
     #   @return [String]
     #
     # @!attribute [rw] amortized_recurring_fee
-    #   The monthly cost of your RI, amortized over the RI period.
+    #   The monthly cost of your reservation, amortized over the reservation
+    #   period.
     #   @return [String]
     #
     # @!attribute [rw] total_amortized_fee
-    #   The total cost of your RI, amortized over the RI period.
+    #   The total cost of your reservation, amortized over the reservation
+    #   period.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ReservationAggregates AWS API Documentation
     #
     class ReservationAggregates < Struct.new(
       :utilization_percentage,
+      :utilization_percentage_in_units,
       :purchased_hours,
+      :purchased_units,
       :total_actual_hours,
+      :total_actual_units,
       :unused_hours,
+      :unused_units,
       :on_demand_cost_of_ri_hours_used,
       :net_ri_savings,
       :total_potential_ri_savings,
@@ -1792,9 +1919,9 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] minimum_normalized_units_used_per_hour
-    #   The minimum number of hours that you used in an hour during the
-    #   historical period. AWS uses this to calculate your recommended
-    #   reservation purchases.
+    #   The minimum number of normalized units that you used in an hour
+    #   during the historical period. AWS uses this to calculate your
+    #   recommended reservation purchases.
     #   @return [String]
     #
     # @!attribute [rw] maximum_number_of_instances_used_per_hour
@@ -1935,22 +2062,22 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # A group of Reserved Instances (RIs) that share a set of attributes.
+    # A group of reservations that share a set of attributes.
     #
     # @!attribute [rw] key
-    #   The key for a specific RI attribute.
+    #   The key for a specific reservation attribute.
     #   @return [String]
     #
     # @!attribute [rw] value
-    #   The value of a specific RI attribute.
+    #   The value of a specific reservation attribute.
     #   @return [String]
     #
     # @!attribute [rw] attributes
-    #   The attributes for this group of RIs.
+    #   The attributes for this group of reservations.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] utilization
-    #   How much you used this group of RIs.
+    #   How much you used this group of reservations.
     #   @return [Types::ReservationAggregates]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ReservationUtilizationGroup AWS API Documentation
@@ -1966,7 +2093,7 @@ module Aws::CostExplorer
     # The result that is associated with a time period.
     #
     # @!attribute [rw] time_period
-    #   The time period covered by a result.
+    #   The time period that the result covers.
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] total
@@ -1974,11 +2101,11 @@ module Aws::CostExplorer
     #   @return [Hash<String,Types::MetricValue>]
     #
     # @!attribute [rw] groups
-    #   The groups that are included in this time period.
+    #   The groups that this time period includes.
     #   @return [Array<Types::Group>]
     #
     # @!attribute [rw] estimated
-    #   Whether this result is estimated.
+    #   Whether the result is estimated.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ResultByTime AWS API Documentation
@@ -2004,7 +2131,7 @@ module Aws::CostExplorer
     #       }
     #
     # @!attribute [rw] ec2_specification
-    #   The EC2 hardware specifications that you want AWS to provide
+    #   The Amazon EC2 hardware specifications that you want AWS to provide
     #   recommendations for.
     #   @return [Types::EC2Specification]
     #
@@ -2026,11 +2153,11 @@ module Aws::CostExplorer
     #       }
     #
     # @!attribute [rw] key
-    #   The key for a tag.
+    #   The key for the tag.
     #   @return [String]
     #
     # @!attribute [rw] values
-    #   The specific value of a tag.
+    #   The specific value of the tag.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/TagValues AWS API Documentation
@@ -2044,15 +2171,15 @@ module Aws::CostExplorer
     # The amount of utilization, in hours.
     #
     # @!attribute [rw] time_period
-    #   The period of time over which this utilization was used.
+    #   The period of time that this utilization was used for.
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] groups
-    #   The groups that are included in this utilization result.
+    #   The groups that this utilization result uses.
     #   @return [Array<Types::ReservationUtilizationGroup>]
     #
     # @!attribute [rw] total
-    #   The total number of RI hours that were used.
+    #   The total number of reservation hours that were used.
     #   @return [Types::ReservationAggregates]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UtilizationByTime AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-costexplorer
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.15.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-20 00:00:00.000000000 Z
+date: 2018-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core