aws-sdk-costexplorer 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 27611725395f09a87a78c202ca035b52501b7581
-  data.tar.gz: 487c6d0f12b585cf004012b36390f53a9284af36
+  metadata.gz: 4dbabc76e800c52c051795be31b2cef1306b5b24
+  data.tar.gz: b7baa6c43895ea437fff06172181ecfea24d4653
 SHA512:
-  metadata.gz: d5e0021cf2949ad813a1d2e08f34466bb79e0dea2b177ecf9822892a8b268feb369e059c258156242741e442d8421c8adb9611b86b9e52c5deef8369ab28da1f
-  data.tar.gz: 989d920c43000f9522ebb18ffdd7e915ecddb7c61bfc1ec670da7818b6ebf421f93890a40a28f8553becc6240ed1a5e4b90904a0e718782046932171faa14cf7
+  metadata.gz: 0c95854f198f07aa297e95bf3f4da9f6242b30f4240ee1e972dc25b0bcf136c4cb894541bbb1f75f578e8b2b680ae8ec8b376945b7dc20e502a1fa5a954dd2b1
+  data.tar.gz: 1256232d391c2c2c41f73cc1514fbf41b696ed39bae364146b06143d13f0122332d094bbfe8b248022be16f4e0493fb9a135b9c244e11e2daaac42ba3d4d80fb

data/lib/aws-sdk-costexplorer.rb

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

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

@@ -158,11 +158,10 @@ module Aws::CostExplorer
     # Retrieve cost and usage metrics for your account. You can specify
     # which cost and usage-related metric, such as `BlendedCosts` or
     # `UsageQuantity`, that you want the request to return. You can also
-    # filter and group your data by various dimensions, such as `AWS
-    # Service` or `AvailabilityZone`, in a specific time range. See the
-    # `GetDimensionValues` action for a complete list of the valid
-    # dimensions. Master accounts in an organization have access to all
-    # member accounts.
+    # filter and group your data by various dimensions, such as `SERVICE` or
+    # `AZ`, in a specific time range. See the `GetDimensionValues` action
+    # for a complete list of the valid dimensions. Master accounts in an
+    # organization have access to all member accounts.
     #
     # @option params [Types::DateInterval] :time_period
     #   Sets the start and end dates for retrieving AWS costs. The start date
@@ -172,19 +171,25 @@ module Aws::CostExplorer
     #   but not including `2017-05-01`.
     #
     # @option params [String] :granularity
-    #   Sets the AWS cost granularity to `MONTHLY` or `DAILY`.
+    #   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`.
     #
     # @option params [Types::Expression] :filter
     #   Filters AWS costs by different dimensions. For example, you can
-    #   specify `Service` and `Linked Account` and get the costs associated
+    #   specify `SERVICE` and `LINKED_ACCOUNT` and get the costs associated
     #   with that account's usage of that service. You can nest `Expression`
     #   objects to define any combination of dimension filters. For more
-    #   information, see the `Expression` object or `More Examples`.
+    #   information, see [Expression][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
     #
     # @option params [Array<String>] :metrics
     #   Which metrics are returned in the query. For more information about
-    #   blended and unblended rates, see
-    #   https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/.
+    #   blended and unblended rates, see [Why does the "blended" annotation
+    #   appear on some line items in my bill?][1].
     #
     #   Valid values are `BlendedCost`, `UnblendedCost`, and `UsageQuantity`.
     #
@@ -197,6 +202,10 @@ module Aws::CostExplorer
     #
     #    </note>
     #
+    #
+    #
+    #   [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
+    #
     # @option params [Array<Types::GroupDefinition>] :group_by
     #   You can group AWS costs using up to two different groups, either
     #   dimensions, tag keys, or both.
@@ -204,9 +213,9 @@ module Aws::CostExplorer
     #   When you group by tag key, you get all tag values, including empty
     #   strings.
     #
-    #   Valid values are: `AZ`, `INSTANCE_TYPE`, `LINKED_ACCCOUNT`,
-    #   `OPERATION`, `PURCHASE_TYPE`, `SERVICE`, `USAGE_TYPE`, `TAGS`, and
-    #   `PLATFORM`.
+    #   Valid values are `AZ`, `INSTANCE_TYPE`, `LINKED_ACCOUNT`, `OPERATION`,
+    #   `PLATFORM`, `PURCHASE_TYPE`, `SERVICE`, `TAGS`, `TENANCY`, and
+    #   `USAGE_TYPE`.
     #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
@@ -242,7 +251,7 @@ module Aws::CostExplorer
     #         # recursive Expression
     #       },
     #       dimensions: {
-    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #         values: ["Value"],
     #       },
     #       tags: {
@@ -304,16 +313,16 @@ module Aws::CostExplorer
     #   `2017-04-30` but not including `2017-05-01`.
     #
     # @option params [required, String] :dimension
-    #   The name of the dimension. Different `Dimensions`are available for
-    #   different `Context`s. For more information, see `Context`.
+    #   The name of the dimension. Each `Dimensions`is available for different
+    #   a `Context`. For more information, see `Context`.
     #
     # @option params [String] :context
     #   The context for the call to `GetDimensionValues`. This can be
-    #   `RESERVED_INSTANCE` or `COST_AND_USAGE`. The default value is
-    #   `COST_AND_USAGE`. If the context is set to `RESERVED_INSTANCE`, the
+    #   `RESERVATIONS` or `COST_AND_USAGE`. The default value is
+    #   `COST_AND_USAGE`. If the context is set to `RESERVATIONS`, the
     #   resulting dimension values can be used in the
     #   `GetReservationUtilization` action. 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 `CostAndUsage`, you can use the following
@@ -321,51 +330,52 @@ module Aws::CostExplorer
     #
     #   * AZ - The Availability Zone. An example is us-east-1a.
     #
-    #   * InstanceType - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is m4.xlarge.
     #
-    #   * LinkedAccount - The description in the attribute map that includes
+    #   * 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
     #
-    #   * Operation - The action performed. Examples include RunInstance and
+    #   * OPERATION - The action performed. Examples include RunInstance and
     #     CreateBucket.
     #
-    #   * PurchaseType - The reservation type of the purchase to which this
+    #   * PURCHASE\_TYPE - The reservation type of the purchase to which this
     #     usage is related. Examples include: On Demand Instances and Standard
     #     Reserved Instances
     #
-    #   * Service - The AWS service such as DynamoDB.
+    #   * SERVICE - The AWS service such as DynamoDB.
     #
-    #   * UsageType -The type of usage. An example is DataTransfer-In-Bytes.
-    #     The response for the GetDimensionValues action includes a unit
-    #     attribute, examples of which include GB and Hrs.
+    #   * USAGE\_TYPE - The type of usage. An example is
+    #     DataTransfer-In-Bytes. The response for the GetDimensionValues
+    #     action includes a unit attribute, examples of which include GB and
+    #     Hrs.
     #
-    #   * UsageTypeGroup - The grouping of common usage types. An example is
-    #     EC2: CloudWatch – Alarms. The response for this action includes a
+    #   * USAGE\_TYPE\_GROUP - The grouping of common usage types. An example
+    #     is EC2: CloudWatch – Alarms. The response for this action includes a
     #     unit attribute.
     #
-    #   * RecordType - The different types of charges such as RI fees, usage
-    #     costs, tax refunds, and credits
+    #   * RECORD\_TYPE - The different types of charges such as RI fees, usage
+    #     costs, tax refunds, and credits.
     #
-    #   If you set the context to `ReservedInstance`, you can use the
-    #   following dimensions for searching:
+    #   If you set the context to `RESERVATIONS`, you can use the following
+    #   dimensions for searching:
     #
     #   * AZ - The Availability Zone. An example is us-east-1a.
     #
-    #   * InstanceType - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is m4.xlarge.
     #
-    #   * LinkedAccount - The description in the attribute map that includes
+    #   * 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 operating system. Examples are Windows or Linux.
+    #   * PLATFORM - The operating system. Examples are Windows or Linux.
     #
-    #   * Region - The AWS region.
+    #   * REGION - The AWS region.
     #
-    #   * Scope - The scope of a reserved instance (RI). Values are regional
+    #   * SCOPE - The scope of a reserved instance (RI). Values are regional
     #     or a single availability zone.
     #
-    #   * Tenancy - The tenancy of a resource. Examples are shared or
+    #   * TENANCY - The tenancy of a resource. Examples are shared or
     #     dedicated.
     #
     # @option params [String] :next_page_token
@@ -388,7 +398,7 @@ module Aws::CostExplorer
     #       start: "YearMonthDay", # required
     #       end: "YearMonthDay", # required
     #     },
-    #     dimension: "AZ", # required, accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #     dimension: "AZ", # required, accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #     context: "COST_AND_USAGE", # accepts COST_AND_USAGE, RESERVATIONS
     #     next_page_token: "NextPageToken",
     #   })
@@ -412,6 +422,161 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Retrieve the reservation coverage for your account. An organization's
+    # master account has access to the associated member accounts. For any
+    # time period, you can filter data about reservation usage by the
+    # following dimensions.
+    #
+    # * AZ
+    #
+    # * INSTANCE\_TYPE
+    #
+    # * LINKED\_ACCOUNT
+    #
+    # * PLATFORM
+    #
+    # * REGION
+    #
+    # * TENANCY
+    #
+    # To determine valid values for a dimension, use the
+    # `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`.
+    #
+    # @option params [Array<Types::GroupDefinition>] :group_by
+    #   You can group the data by the following attributes.
+    #
+    #   * AZ
+    #
+    #   * INSTANCE\_TYPE
+    #
+    #   * LINKED\_ACCOUNT
+    #
+    #   * PLATFORM
+    #
+    #   * REGION
+    #
+    #   * TENANCY
+    #
+    # @option params [String] :granularity
+    #   The granularity of the AWS cost data for the reservation. Valid values
+    #   are `MONTHLY` and `DAILY`.
+    #
+    #   If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
+    #   isn't set, the response object doesn't include the `Granularity`,
+    #   either `MONTHLY` or `DAILY`.
+    #
+    # @option params [Types::Expression] :filter
+    #   Filters utilization data by dimensions. You can filter by the
+    #   following dimensions.
+    #
+    #   * AZ
+    #
+    #   * INSTANCE\_TYPE
+    #
+    #   * LINKED\_ACCOUNT
+    #
+    #   * PLATFORM
+    #
+    #   * REGION
+    #
+    #   * TENANCY
+    #
+    #   `GetReservationCoverage` uses the same `Expression` 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.
+    #
+    # @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
+    #   maximum page size.
+    #
+    # @return [Types::GetReservationCoverageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetReservationCoverageResponse#coverages_by_time #coverages_by_time} => Array&lt;Types::CoverageByTime&gt;
+    #   * {Types::GetReservationCoverageResponse#total #total} => Types::Coverage
+    #   * {Types::GetReservationCoverageResponse#next_page_token #next_page_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_reservation_coverage({
+    #     time_period: { # required
+    #       start: "YearMonthDay", # required
+    #       end: "YearMonthDay", # required
+    #     },
+    #     group_by: [
+    #       {
+    #         type: "DIMENSION", # accepts DIMENSION, TAG
+    #         key: "GroupDefinitionKey",
+    #       },
+    #     ],
+    #     granularity: "DAILY", # accepts DAILY, MONTHLY
+    #     filter: {
+    #       or: [
+    #         {
+    #           # recursive Expression
+    #         },
+    #       ],
+    #       and: [
+    #         {
+    #           # recursive Expression
+    #         },
+    #       ],
+    #       not: {
+    #         # recursive Expression
+    #       },
+    #       dimensions: {
+    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
+    #         values: ["Value"],
+    #       },
+    #       tags: {
+    #         key: "TagKey",
+    #         values: ["Value"],
+    #       },
+    #     },
+    #     next_page_token: "NextPageToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.coverages_by_time #=> Array
+    #   resp.coverages_by_time[0].time_period.start #=> String
+    #   resp.coverages_by_time[0].time_period.end #=> String
+    #   resp.coverages_by_time[0].groups #=> Array
+    #   resp.coverages_by_time[0].groups[0].attributes #=> Hash
+    #   resp.coverages_by_time[0].groups[0].attributes["AttributeType"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.coverages_by_time[0].groups[0].coverage.coverage_hours.on_demand_hours #=> String
+    #   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].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.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.next_page_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationCoverage AWS API Documentation
+    #
+    # @overload get_reservation_coverage(params = {})
+    # @param [Hash] params ({})
+    def get_reservation_coverage(params = {}, options = {})
+      req = build_request(:get_reservation_coverage, params)
+      req.send_request(options)
+    end
+
     # You can retrieve the Reservation utilization for your account. Master
     # accounts in an organization have access to their associated member
     # accounts. You can filter data by dimensions in a time period. You can
@@ -427,14 +592,13 @@ module Aws::CostExplorer
     #   `2017-05-01`.
     #
     # @option params [Array<Types::GroupDefinition>] :group_by
-    #   Groups only by `SubscriptionId`. Metadata is included.
+    #   Groups only by `SUBSCRIPTION_ID`. Metadata is included.
     #
     # @option params [String] :granularity
-    #   Sets the AWS cost granularity to `MONTHLY` or `DAILY`. If both
-    #   `GroupBy` and `granularity` are not set, `GetReservationUtilization`
-    #   defaults to `DAILY`. If `GroupBy` is set, `Granularity` can't be set,
-    #   and the response object doesn't include `MONTHLY` or `DAILY`
-    #   granularity.
+    #   If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
+    #   isn't set, the response object doesn't include the `Granularity`,
+    #   either `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity`
+    #   aren't set, `GetReservationUtilization` defaults to `DAILY`.
     #
     # @option params [Types::Expression] :filter
     #   Filters utilization data by using different dimensions.
@@ -483,7 +647,7 @@ module Aws::CostExplorer
     #         # recursive Expression
     #       },
     #       dimensions: {
-    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #         values: ["Value"],
     #       },
     #       tags: {
@@ -597,7 +761,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.0.0'
+      context[:gem_version] = '1.1.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -14,7 +14,14 @@ module Aws::CostExplorer
     AttributeType = Shapes::StringShape.new(name: 'AttributeType')
     AttributeValue = Shapes::StringShape.new(name: 'AttributeValue')
     Attributes = Shapes::MapShape.new(name: 'Attributes')
+    BillExpirationException = Shapes::StructureShape.new(name: 'BillExpirationException')
     Context = Shapes::StringShape.new(name: 'Context')
+    Coverage = Shapes::StructureShape.new(name: 'Coverage')
+    CoverageByTime = Shapes::StructureShape.new(name: 'CoverageByTime')
+    CoverageHours = Shapes::StructureShape.new(name: 'CoverageHours')
+    CoverageHoursPercentage = Shapes::StringShape.new(name: 'CoverageHoursPercentage')
+    CoveragesByTime = Shapes::ListShape.new(name: 'CoveragesByTime')
+    DataUnavailableException = Shapes::StructureShape.new(name: 'DataUnavailableException')
     DateInterval = Shapes::StructureShape.new(name: 'DateInterval')
     Dimension = Shapes::StringShape.new(name: 'Dimension')
     DimensionValues = Shapes::StructureShape.new(name: 'DimensionValues')
@@ -29,6 +36,8 @@ module Aws::CostExplorer
     GetCostAndUsageResponse = Shapes::StructureShape.new(name: 'GetCostAndUsageResponse')
     GetDimensionValuesRequest = Shapes::StructureShape.new(name: 'GetDimensionValuesRequest')
     GetDimensionValuesResponse = Shapes::StructureShape.new(name: 'GetDimensionValuesResponse')
+    GetReservationCoverageRequest = Shapes::StructureShape.new(name: 'GetReservationCoverageRequest')
+    GetReservationCoverageResponse = Shapes::StructureShape.new(name: 'GetReservationCoverageResponse')
     GetReservationUtilizationRequest = Shapes::StructureShape.new(name: 'GetReservationUtilizationRequest')
     GetReservationUtilizationResponse = Shapes::StructureShape.new(name: 'GetReservationUtilizationResponse')
     GetTagsRequest = Shapes::StructureShape.new(name: 'GetTagsRequest')
@@ -40,6 +49,7 @@ module Aws::CostExplorer
     GroupDefinitionType = Shapes::StringShape.new(name: 'GroupDefinitionType')
     GroupDefinitions = Shapes::ListShape.new(name: 'GroupDefinitions')
     Groups = Shapes::ListShape.new(name: 'Groups')
+    InvalidNextTokenException = Shapes::StructureShape.new(name: 'InvalidNextTokenException')
     Key = Shapes::StringShape.new(name: 'Key')
     Keys = Shapes::ListShape.new(name: 'Keys')
     LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
@@ -50,13 +60,17 @@ module Aws::CostExplorer
     MetricValue = Shapes::StructureShape.new(name: 'MetricValue')
     Metrics = Shapes::MapShape.new(name: 'Metrics')
     NextPageToken = Shapes::StringShape.new(name: 'NextPageToken')
+    OnDemandHours = Shapes::StringShape.new(name: 'OnDemandHours')
     PageSize = Shapes::IntegerShape.new(name: 'PageSize')
     PurchasedHours = Shapes::StringShape.new(name: 'PurchasedHours')
     ReservationAggregates = Shapes::StructureShape.new(name: 'ReservationAggregates')
+    ReservationCoverageGroup = Shapes::StructureShape.new(name: 'ReservationCoverageGroup')
+    ReservationCoverageGroups = Shapes::ListShape.new(name: 'ReservationCoverageGroups')
     ReservationGroupKey = Shapes::StringShape.new(name: 'ReservationGroupKey')
     ReservationGroupValue = Shapes::StringShape.new(name: 'ReservationGroupValue')
     ReservationUtilizationGroup = Shapes::StructureShape.new(name: 'ReservationUtilizationGroup')
     ReservationUtilizationGroups = Shapes::ListShape.new(name: 'ReservationUtilizationGroups')
+    ReservedHours = Shapes::StringShape.new(name: 'ReservedHours')
     ResultByTime = Shapes::StructureShape.new(name: 'ResultByTime')
     ResultsByTime = Shapes::ListShape.new(name: 'ResultsByTime')
     SearchString = Shapes::StringShape.new(name: 'SearchString')
@@ -64,6 +78,7 @@ module Aws::CostExplorer
     TagList = Shapes::ListShape.new(name: 'TagList')
     TagValues = Shapes::StructureShape.new(name: 'TagValues')
     TotalActualHours = Shapes::StringShape.new(name: 'TotalActualHours')
+    TotalRunningHours = Shapes::StringShape.new(name: 'TotalRunningHours')
     UnusedHours = Shapes::StringShape.new(name: 'UnusedHours')
     UtilizationByTime = Shapes::StructureShape.new(name: 'UtilizationByTime')
     UtilizationPercentage = Shapes::StringShape.new(name: 'UtilizationPercentage')
@@ -75,6 +90,22 @@ module Aws::CostExplorer
     Attributes.key = Shapes::ShapeRef.new(shape: AttributeType)
     Attributes.value = Shapes::ShapeRef.new(shape: AttributeValue)
 
+    Coverage.add_member(:coverage_hours, Shapes::ShapeRef.new(shape: CoverageHours, location_name: "CoverageHours"))
+    Coverage.struct_class = Types::Coverage
+
+    CoverageByTime.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, location_name: "TimePeriod"))
+    CoverageByTime.add_member(:groups, Shapes::ShapeRef.new(shape: ReservationCoverageGroups, location_name: "Groups"))
+    CoverageByTime.add_member(:total, Shapes::ShapeRef.new(shape: Coverage, location_name: "Total"))
+    CoverageByTime.struct_class = Types::CoverageByTime
+
+    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
+
+    CoveragesByTime.member = Shapes::ShapeRef.new(shape: CoverageByTime)
+
     DateInterval.add_member(:start, Shapes::ShapeRef.new(shape: YearMonthDay, required: true, location_name: "Start"))
     DateInterval.add_member(:end, Shapes::ShapeRef.new(shape: YearMonthDay, required: true, location_name: "End"))
     DateInterval.struct_class = Types::DateInterval
@@ -124,6 +155,18 @@ module Aws::CostExplorer
     GetDimensionValuesResponse.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
     GetDimensionValuesResponse.struct_class = Types::GetDimensionValuesResponse
 
+    GetReservationCoverageRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
+    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(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
+    GetReservationCoverageRequest.struct_class = Types::GetReservationCoverageRequest
+
+    GetReservationCoverageResponse.add_member(:coverages_by_time, Shapes::ShapeRef.new(shape: CoveragesByTime, required: true, location_name: "CoveragesByTime"))
+    GetReservationCoverageResponse.add_member(:total, Shapes::ShapeRef.new(shape: Coverage, location_name: "Total"))
+    GetReservationCoverageResponse.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
+    GetReservationCoverageResponse.struct_class = Types::GetReservationCoverageResponse
+
     GetReservationUtilizationRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
     GetReservationUtilizationRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
     GetReservationUtilizationRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
@@ -177,6 +220,12 @@ module Aws::CostExplorer
     ReservationAggregates.add_member(:unused_hours, Shapes::ShapeRef.new(shape: UnusedHours, location_name: "UnusedHours"))
     ReservationAggregates.struct_class = Types::ReservationAggregates
 
+    ReservationCoverageGroup.add_member(:attributes, Shapes::ShapeRef.new(shape: Attributes, location_name: "Attributes"))
+    ReservationCoverageGroup.add_member(:coverage, Shapes::ShapeRef.new(shape: Coverage, location_name: "Coverage"))
+    ReservationCoverageGroup.struct_class = Types::ReservationCoverageGroup
+
+    ReservationCoverageGroups.member = Shapes::ShapeRef.new(shape: ReservationCoverageGroup)
+
     ReservationUtilizationGroup.add_member(:key, Shapes::ShapeRef.new(shape: ReservationGroupKey, location_name: "Key"))
     ReservationUtilizationGroup.add_member(:value, Shapes::ShapeRef.new(shape: ReservationGroupValue, location_name: "Value"))
     ReservationUtilizationGroup.add_member(:attributes, Shapes::ShapeRef.new(shape: Attributes, location_name: "Attributes"))
@@ -231,6 +280,9 @@ module Aws::CostExplorer
         o.input = Shapes::ShapeRef.new(shape: GetCostAndUsageRequest)
         o.output = Shapes::ShapeRef.new(shape: GetCostAndUsageResponse)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: BillExpirationException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
       end)
 
       api.add_operation(:get_dimension_values, Seahorse::Model::Operation.new.tap do |o|
@@ -240,6 +292,19 @@ module Aws::CostExplorer
         o.input = Shapes::ShapeRef.new(shape: GetDimensionValuesRequest)
         o.output = Shapes::ShapeRef.new(shape: GetDimensionValuesResponse)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: BillExpirationException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+      end)
+
+      api.add_operation(:get_reservation_coverage, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetReservationCoverage"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetReservationCoverageRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetReservationCoverageResponse)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
       end)
 
       api.add_operation(:get_reservation_utilization, Seahorse::Model::Operation.new.tap do |o|
@@ -249,6 +314,8 @@ module Aws::CostExplorer
         o.input = Shapes::ShapeRef.new(shape: GetReservationUtilizationRequest)
         o.output = Shapes::ShapeRef.new(shape: GetReservationUtilizationResponse)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
       end)
 
       api.add_operation(:get_tags, Seahorse::Model::Operation.new.tap do |o|
@@ -258,6 +325,8 @@ module Aws::CostExplorer
         o.input = Shapes::ShapeRef.new(shape: GetTagsRequest)
         o.output = Shapes::ShapeRef.new(shape: GetTagsResponse)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: BillExpirationException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
       end)
     end
 

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

@@ -8,6 +8,71 @@
 module Aws::CostExplorer
   module Types
 
+    # The amount of instance usage that a reservation covered.
+    #
+    # @!attribute [rw] coverage_hours
+    #   The amount of instance usage that a reservation covered, in hours.
+    #   @return [Types::CoverageHours]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/Coverage AWS API Documentation
+    #
+    class Coverage < Struct.new(
+      :coverage_hours)
+      include Aws::Structure
+    end
+
+    # Reservation coverage, in hours.
+    #
+    # @!attribute [rw] time_period
+    #   The period over which this coverage was used.
+    #   @return [Types::DateInterval]
+    #
+    # @!attribute [rw] groups
+    #   The group of instances that a reservation covered.
+    #   @return [Array<Types::ReservationCoverageGroup>]
+    #
+    # @!attribute [rw] total
+    #   The total reservation coverage, in hours.
+    #   @return [Types::Coverage]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageByTime AWS API Documentation
+    #
+    class CoverageByTime < Struct.new(
+      :time_period,
+      :groups,
+      :total)
+      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 covered by On-Demand Instances.
+    #   @return [String]
+    #
+    # @!attribute [rw] reserved_hours
+    #   The number of instance running hours covered by reservations.
+    #   @return [String]
+    #
+    # @!attribute [rw] total_running_hours
+    #   The total instance usage, in hours.
+    #   @return [String]
+    #
+    # @!attribute [rw] coverage_hours_percentage
+    #   The percentage of instance hours covered by a reservation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageHours AWS API Documentation
+    #
+    class CoverageHours < Struct.new(
+      :on_demand_hours,
+      :reserved_hours,
+      :total_running_hours,
+      :coverage_hours_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
@@ -47,7 +112,7 @@ module Aws::CostExplorer
     #   data as a hash:
     #
     #       {
-    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #         values: ["Value"],
     #       }
     #
@@ -95,11 +160,11 @@ module Aws::CostExplorer
     #
     # * Simple dimension values - You can set the dimension name and values
     #   for the filters that you plan to use. For example, you can filter
-    #   for `InstanceType==m4.xlarge OR InstanceType==c4.large`. The
+    #   for `INSTANCE_TYPE==m4.xlarge OR INSTANCE_TYPE==c4.large`. The
     #   `Expression` for that looks like this.
     #
-    #   `\{ "Dimensions": \{ "Key": "InstanceType", "Values": [ "m4.xlarge",
-    #   “c4.large” ] \} \}`
+    #   `\{ "Dimensions": \{ "Key": "INSTANCE_TYPE", "Values": [
+    #   "m4.xlarge", “c4.large” ] \} \}`
     #
     #   The list of dimension values are OR'd together to retrieve cost or
     #   usage data. You can create `Expression` and `DimensionValues`
@@ -110,14 +175,14 @@ module Aws::CostExplorer
     #   multiple `Expression` types and the logical operators `AND/OR/NOT`
     #   to create a list of one or more `Expression` objects. This allows
     #   you to filter on more advanced options. For example, you can filter
-    #   on `((InstanceType == m4.large OR InstanceType == m3.large) OR
-    #   (Tag.Type == Type1)) AND (UsageType != DataTransfer)`. The
+    #   on `((INSTANCE_TYPE == m4.large OR INSTANCE_TYPE == m3.large) OR
+    #   (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer)`. The
     #   `Expression` for that looks like this.
     #
-    #   `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "InstanceType",
+    #   `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "INSTANCE_TYPE",
     #   "Values": [ "m4.x.large", "c4.large" ] \}\}, \{"Tag": \{ "Key":
     #   "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not": \{"dimensions":
-    #   \{ "Key": "UsageType", "Values": ["DataTransfer"] \}\}\} ] \} `
+    #   \{ "Key": "USAGE_TYPE", "Values": ["DataTransfer"] \}\}\} ] \} `
     #
     #   <note markdown="1"> Because each `Expression` can have only one operator, the service
     #   returns an error if more than one is specified. The following
@@ -125,8 +190,8 @@ module Aws::CostExplorer
     #
     #    </note>
     #
-    #   ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension": "UsageType",
-    #   "Values": [ "DataTransfer" ] \} \} `
+    #   ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
+    #   "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
     #
     # @note When making an API call, you may pass Expression
     #   data as a hash:
@@ -144,7 +209,7 @@ module Aws::CostExplorer
     #               # recursive Expression
     #             },
     #             dimensions: {
-    #               key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #               key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #               values: ["Value"],
     #             },
     #             tags: {
@@ -165,7 +230,7 @@ module Aws::CostExplorer
     #               # recursive Expression
     #             },
     #             dimensions: {
-    #               key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #               key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #               values: ["Value"],
     #             },
     #             tags: {
@@ -189,7 +254,7 @@ module Aws::CostExplorer
     #             # recursive Expression
     #           },
     #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #             values: ["Value"],
     #           },
     #           tags: {
@@ -198,7 +263,7 @@ module Aws::CostExplorer
     #           },
     #         },
     #         dimensions: {
-    #           key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #           key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #           values: ["Value"],
     #         },
     #         tags: {
@@ -262,7 +327,7 @@ module Aws::CostExplorer
     #             # recursive Expression
     #           },
     #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #             values: ["Value"],
     #           },
     #           tags: {
@@ -289,22 +354,27 @@ module Aws::CostExplorer
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] granularity
-    #   Sets the AWS cost granularity to `MONTHLY` or `DAILY`.
+    #   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`.
     #   @return [String]
     #
     # @!attribute [rw] filter
     #   Filters AWS costs by different dimensions. For example, you can
-    #   specify `Service` and `Linked Account` and get the costs associated
+    #   specify `SERVICE` and `LINKED_ACCOUNT` and get the costs associated
     #   with that account's usage of that service. You can nest
     #   `Expression` objects to define any combination of dimension filters.
-    #   For more information, see the `Expression` object or `More
-    #   Examples`.
+    #   For more information, see [Expression][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] metrics
     #   Which metrics are returned in the query. For more information about
-    #   blended and unblended rates, see
-    #   https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/.
+    #   blended and unblended rates, see [Why does the "blended"
+    #   annotation appear on some line items in my bill?][1].
     #
     #   Valid values are `BlendedCost`, `UnblendedCost`, and
     #   `UsageQuantity`.
@@ -318,6 +388,10 @@ module Aws::CostExplorer
     #   `UsageTypeGroups`.
     #
     #    </note>
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
     #   @return [Array<String>]
     #
     # @!attribute [rw] group_by
@@ -327,9 +401,9 @@ module Aws::CostExplorer
     #   When you group by tag key, you get all tag values, including empty
     #   strings.
     #
-    #   Valid values are: `AZ`, `INSTANCE_TYPE`, `LINKED_ACCCOUNT`,
-    #   `OPERATION`, `PURCHASE_TYPE`, `SERVICE`, `USAGE_TYPE`, `TAGS`, and
-    #   `PLATFORM`.
+    #   Valid values are `AZ`, `INSTANCE_TYPE`, `LINKED_ACCOUNT`,
+    #   `OPERATION`, `PLATFORM`, `PURCHASE_TYPE`, `SERVICE`, `TAGS`,
+    #   `TENANCY`, and `USAGE_TYPE`.
     #   @return [Array<Types::GroupDefinition>]
     #
     # @!attribute [rw] next_page_token
@@ -383,7 +457,7 @@ module Aws::CostExplorer
     #           start: "YearMonthDay", # required
     #           end: "YearMonthDay", # required
     #         },
-    #         dimension: "AZ", # required, accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #         dimension: "AZ", # required, accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #         context: "COST_AND_USAGE", # accepts COST_AND_USAGE, RESERVATIONS
     #         next_page_token: "NextPageToken",
     #       }
@@ -401,69 +475,72 @@ module Aws::CostExplorer
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] dimension
-    #   The name of the dimension. Different `Dimensions`are available for
-    #   different `Context`s. For more information, see `Context`.
+    #   The name of the dimension. Each `Dimensions`is available for
+    #   different a `Context`. For more information, see `Context`.
     #   @return [String]
     #
     # @!attribute [rw] context
     #   The context for the call to `GetDimensionValues`. This can be
-    #   `RESERVED_INSTANCE` or `COST_AND_USAGE`. The default value is
-    #   `COST_AND_USAGE`. If the context is set to `RESERVED_INSTANCE`, the
+    #   `RESERVATIONS` or `COST_AND_USAGE`. The default value is
+    #   `COST_AND_USAGE`. If the context is set to `RESERVATIONS`, the
     #   resulting dimension values can be used in the
     #   `GetReservationUtilization` action. If the context is set to
-    #   `COST_AND_USAGE`, , the resulting dimension values can be used in
-    #   the `GetCostAndUsage` operation.
+    #   `COST_AND_USAGE`, the resulting dimension values can be used in the
+    #   `GetCostAndUsage` operation.
     #
     #   If you set the context to `CostAndUsage`, you can use the following
     #   dimensions for searching:
     #
     #   * AZ - The Availability Zone. An example is us-east-1a.
     #
-    #   * InstanceType - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #     m4.xlarge.
     #
-    #   * LinkedAccount - 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
+    #   * 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
     #
-    #   * Operation - The action performed. Examples include RunInstance and
+    #   * OPERATION - The action performed. Examples include RunInstance and
     #     CreateBucket.
     #
-    #   * PurchaseType - The reservation type of the purchase to which this
-    #     usage is related. Examples include: On Demand Instances and
+    #   * PURCHASE\_TYPE - The reservation type of the purchase to which
+    #     this usage is related. Examples include: On Demand Instances and
     #     Standard Reserved Instances
     #
-    #   * Service - The AWS service such as DynamoDB.
+    #   * SERVICE - The AWS service such as DynamoDB.
     #
-    #   * UsageType -The type of usage. An example is DataTransfer-In-Bytes.
-    #     The response for the GetDimensionValues action includes a unit
-    #     attribute, examples of which include GB and Hrs.
+    #   * USAGE\_TYPE - The type of usage. An example is
+    #     DataTransfer-In-Bytes. The response for the GetDimensionValues
+    #     action includes a unit attribute, examples of which include GB and
+    #     Hrs.
     #
-    #   * UsageTypeGroup - The grouping of common usage types. An example is
-    #     EC2: CloudWatch – Alarms. The response for this action includes a
-    #     unit attribute.
+    #   * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
+    #     example is EC2: CloudWatch – Alarms. The response for this action
+    #     includes a unit attribute.
     #
-    #   * RecordType - The different types of charges such as RI fees, usage
-    #     costs, tax refunds, and credits
+    #   * RECORD\_TYPE - The different types of charges such as RI fees,
+    #     usage costs, tax refunds, and credits.
     #
-    #   If you set the context to `ReservedInstance`, you can use the
-    #   following dimensions for searching:
+    #   If you set the context to `RESERVATIONS`, you can use the following
+    #   dimensions for searching:
     #
     #   * AZ - The Availability Zone. An example is us-east-1a.
     #
-    #   * InstanceType - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #     m4.xlarge.
     #
-    #   * LinkedAccount - 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
+    #   * 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 operating system. Examples are Windows or Linux.
+    #   * PLATFORM - The operating system. Examples are Windows or Linux.
     #
-    #   * Region - The AWS region.
+    #   * REGION - The AWS region.
     #
-    #   * Scope - The scope of a reserved instance (RI). Values are regional
+    #   * SCOPE - The scope of a reserved instance (RI). Values are regional
     #     or a single availability zone.
     #
-    #   * Tenancy - The tenancy of a resource. Examples are shared or
+    #   * TENANCY - The tenancy of a resource. Examples are shared or
     #     dedicated.
     #   @return [String]
     #
@@ -493,51 +570,54 @@ module Aws::CostExplorer
     #
     #   * AZ - The Availability Zone. An example is us-east-1a.
     #
-    #   * InstanceType - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #     m4.xlarge.
     #
-    #   * LinkedAccount - 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
+    #   * 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
     #
-    #   * Operation - The action performed. Examples include RunInstance and
+    #   * OPERATION - The action performed. Examples include RunInstance and
     #     CreateBucket.
     #
-    #   * PurchaseType - The reservation type of the purchase to which this
-    #     usage is related. Examples include: On Demand Instances and
+    #   * PURCHASE\_TYPE - The reservation type of the purchase to which
+    #     this usage is related. Examples include: On Demand Instances and
     #     Standard Reserved Instances
     #
-    #   * Service - The AWS service such as DynamoDB.
+    #   * SERVICE - The AWS service such as DynamoDB.
     #
-    #   * UsageType -The type of usage. An example is DataTransfer-In-Bytes.
-    #     The response for the GetDimensionValues action includes a unit
-    #     attribute, examples of which include GB and Hrs.
+    #   * USAGE\_TYPE - The type of usage. An example is
+    #     DataTransfer-In-Bytes. The response for the GetDimensionValues
+    #     action includes a unit attribute, examples of which include GB and
+    #     Hrs.
     #
-    #   * UsageTypeGroup - The grouping of common usage types. An example is
-    #     EC2: CloudWatch – Alarms. The response for this action includes a
-    #     unit attribute.
+    #   * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
+    #     example is EC2: CloudWatch – Alarms. The response for this action
+    #     includes a unit attribute.
     #
-    #   * RecordType - The different types of charges such as RI fees, usage
-    #     costs, tax refunds, and credits
+    #   * RECORD\_TYPE - The different types of charges such as RI fees,
+    #     usage costs, tax refunds, and credits.
     #
-    #   If you set the context to `ReservedInstance`, you can use the
-    #   following dimensions for searching:
+    #   If you set the context to `RESERVATIONS`, you can use the following
+    #   dimensions for searching:
     #
     #   * AZ - The Availability Zone. An example is us-east-1a.
     #
-    #   * InstanceType - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is
+    #     m4.xlarge.
     #
-    #   * LinkedAccount - 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
+    #   * 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 operating system. Examples are Windows or Linux.
+    #   * PLATFORM - The operating system. Examples are Windows or Linux.
     #
-    #   * Region - The AWS region.
+    #   * REGION - The AWS region.
     #
-    #   * Scope - The scope of a reserved instance (RI). Values are regional
+    #   * SCOPE - The scope of a reserved instance (RI). Values are regional
     #     or a single availability zone.
     #
-    #   * Tenancy - The tenancy of a resource. Examples are shared or
+    #   * TENANCY - The tenancy of a resource. Examples are shared or
     #     dedicated.
     #   @return [Array<Types::DimensionValuesWithAttributes>]
     #
@@ -565,6 +645,147 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # You can query for how much of your instance usage was covered by a
+    # reservation.
+    #
+    # @note When making an API call, you may pass GetReservationCoverageRequest
+    #   data as a hash:
+    #
+    #       {
+    #         time_period: { # required
+    #           start: "YearMonthDay", # required
+    #           end: "YearMonthDay", # required
+    #         },
+    #         group_by: [
+    #           {
+    #             type: "DIMENSION", # accepts DIMENSION, TAG
+    #             key: "GroupDefinitionKey",
+    #           },
+    #         ],
+    #         granularity: "DAILY", # accepts DAILY, MONTHLY
+    #         filter: {
+    #           or: [
+    #             {
+    #               # recursive Expression
+    #             },
+    #           ],
+    #           and: [
+    #             {
+    #               # recursive Expression
+    #             },
+    #           ],
+    #           not: {
+    #             # recursive Expression
+    #           },
+    #           dimensions: {
+    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
+    #             values: ["Value"],
+    #           },
+    #           tags: {
+    #             key: "TagKey",
+    #             values: ["Value"],
+    #           },
+    #         },
+    #         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
+    #   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`.
+    #   @return [Types::DateInterval]
+    #
+    # @!attribute [rw] group_by
+    #   You can group the data by the following attributes.
+    #
+    #   * AZ
+    #
+    #   * INSTANCE\_TYPE
+    #
+    #   * LINKED\_ACCOUNT
+    #
+    #   * PLATFORM
+    #
+    #   * REGION
+    #
+    #   * TENANCY
+    #   @return [Array<Types::GroupDefinition>]
+    #
+    # @!attribute [rw] granularity
+    #   The granularity of the AWS cost data for the reservation. Valid
+    #   values are `MONTHLY` and `DAILY`.
+    #
+    #   If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
+    #   isn't set, the response object doesn't include the `Granularity`,
+    #   either `MONTHLY` or `DAILY`.
+    #   @return [String]
+    #
+    # @!attribute [rw] filter
+    #   Filters utilization data by dimensions. You can filter by the
+    #   following dimensions.
+    #
+    #   * AZ
+    #
+    #   * INSTANCE\_TYPE
+    #
+    #   * LINKED\_ACCOUNT
+    #
+    #   * PLATFORM
+    #
+    #   * REGION
+    #
+    #   * TENANCY
+    #
+    #   `GetReservationCoverage` uses the same `Expression` 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.
+    #   @return [Types::Expression]
+    #
+    # @!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
+    #   the maximum page size.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationCoverageRequest AWS API Documentation
+    #
+    class GetReservationCoverageRequest < Struct.new(
+      :time_period,
+      :group_by,
+      :granularity,
+      :filter,
+      :next_page_token)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] coverages_by_time
+    #   The amount of time that your reservations covered.
+    #   @return [Array<Types::CoverageByTime>]
+    #
+    # @!attribute [rw] total
+    #   The total amount of instance usage covered by a reservation.
+    #   @return [Types::Coverage]
+    #
+    # @!attribute [rw] next_page_token
+    #   The token for the next set of retrievable results. AWS provides the
+    #   token when the response from a previous call has more results than
+    #   the maximum page size.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationCoverageResponse AWS API Documentation
+    #
+    class GetReservationCoverageResponse < Struct.new(
+      :coverages_by_time,
+      :total,
+      :next_page_token)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetReservationUtilizationRequest
     #   data as a hash:
     #
@@ -595,7 +816,7 @@ module Aws::CostExplorer
     #             # recursive Expression
     #           },
     #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID
+    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, 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
     #             values: ["Value"],
     #           },
     #           tags: {
@@ -616,15 +837,14 @@ module Aws::CostExplorer
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] group_by
-    #   Groups only by `SubscriptionId`. Metadata is included.
+    #   Groups only by `SUBSCRIPTION_ID`. Metadata is included.
     #   @return [Array<Types::GroupDefinition>]
     #
     # @!attribute [rw] granularity
-    #   Sets the AWS cost granularity to `MONTHLY` or `DAILY`. If both
-    #   `GroupBy` and `granularity` are not set, `GetReservationUtilization`
-    #   defaults to `DAILY`. If `GroupBy` is set, `Granularity` can't be
-    #   set, and the response object doesn't include `MONTHLY` or `DAILY`
-    #   granularity.
+    #   If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
+    #   isn't set, the response object doesn't include the `Granularity`,
+    #   either `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity`
+    #   aren't set, `GetReservationUtilization` defaults to `DAILY`.
     #   @return [String]
     #
     # @!attribute [rw] filter
@@ -839,6 +1059,24 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # A group of reservations that share a set of attributes.
+    #
+    # @!attribute [rw] attributes
+    #   The attributes for this group of reservations.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] coverage
+    #   How much instance usage this group of reservations covered.
+    #   @return [Types::Coverage]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ReservationCoverageGroup AWS API Documentation
+    #
+    class ReservationCoverageGroup < Struct.new(
+      :attributes,
+      :coverage)
+      include Aws::Structure
+    end
+
     # A group of RIs that share a set of attributes.
     #
     # @!attribute [rw] key

metadata

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